This guide explains how to completely cancel a Streaming Radio offer.

Introduction

• For most products, confirm the cancellation request by email; otherwise, no data will be deleted.
• Refer to this other guide to remove an audio stream from your Streaming Radio, without deleting the entire product.
• Any outstanding or overage charges will still be due.
• A cancellation confirmation will be sent to any other administrators of the Organisation.
• Backups will be permanently deleted upon cancellation, making any restoration impossible.

Cancel the Streaming Radio offer

To access the cancellation process:

1. Click here to access the management of your product in the Infomaniak Manager (need help?).
2. Click on the action menu ⋮ located to the right of the item in question.
3. Choose Cancel:
   
4. Follow the procedure to the end.

This guide explains how to properly configure a stream on the Infomaniak Radio Streaming.

Configure radio stream broadcasting

To access the Radio Streaming service:

1. Click here to access the management of your product on the Infomaniak Manager (need help?).
2. Click directly on the name assigned to the product concerned.
3. Click on the radio name.
4. Click on the Configure Streams button:
   
5. Click on the Add a Stream button:
   
6. Add a standard stream (refer to this other guide regarding stream relays).
7. Click on the button to Continue:
   
8. Choose the desired options, including you can enable HLS which will not be counted in the total number of streams.
9. Configure the desired quality and refer to this other guide if you are looking for information about the type of stream.
10. Adjust the buffer size if necessary (do not forget to save if necessary).
11. Click on the button to Save and Exit:
    

You can now configure an application with the parameters obtained at the end of this procedure.

This guide covers the listening information of Streaming Radio that can be exported to Mediapulse.

Preamble

• Mediapulse, an independent organization in Switzerland, measures the audiences of radio, television, and online platforms.
• These data, recognized as the official reference, help the media and advertising market to analyze, compare, and structure their activities.
• Subject to the supervision of the DETEC via OFCOM, Mediapulse ensures transparency, independence, and scientific rigor; it guarantees reliable measurements adapted to the evolution of the media.
• It is possible to export your radio logs to this service.
• Also refer to this other guide regarding a similar service but intended for France.

Manage Mediapulse certification

Prerequisites

• The Organization in which the Streaming service is located must be established with an address in Switzerland.
• To activate Mediapulse certification, please contact this service by email: info@mediapulse.ch.
• Once the contract is established with them, contact Infomaniak support by indicating the information related to your Mediapulse and Infomaniak contract.

To manage the activation or deactivation of the service:

1. Click here to access the management of your product on the Infomaniak Manager (need help?).
2. Click directly on the name assigned to the product concerned.
3. Click on the name of the audio stream concerned.
4. Click on Settings in the left sidebar.
5. Activate or deactivate the export of logs to Mediapulse with the toggle switch:
   ‍

This guide explains how to transfer the audio streams present on one of your Streaming Radio Infomaniak to another of your radios, present in the same Organization.

Transfer audio streams

To do this: 

1. Click here to access the management of your product on the Infomaniak Manager (need help?).
2. Click directly on the name assigned to the product concerned.
3. Click on the action menu ⋮ located to the right of the item concerned.
4. Choose Transfer:
   
5. Search for and validate the name of the other radio that you own in the same Organization.
6. Validate the transfer:
   

Refresh the Manager pages if necessary to update the displayed information.

This guide concerns live control (timeshift), which allows your listeners to pause, rewind, and then return to the live stream on your HLS streams, with a rewind depth of up to 2 hours.

Introduction

• Unlike Video Streaming Timeshift, there is no scheduling tool associated with Radio.
• Rewind/replay is disabled by default on the Player to give you control over public exposure.

Offer live control to listeners

Prerequisites

• Create or edit an HLS stream in your Radio Streaming product.

Then:

1. When creating (or modifying) an HLS stream, set the Buffer between 00:00:25 and 02:00:00. This value, between 25 seconds and 2 hours, corresponds to the maximum duration for which listeners can rewind and pause the live stream before returning to the live broadcast. It determines the depth of live control. Examples:
   
   • 00:00:25 → 05:00: minimum tolerance for short pauses.
   • 10:00 → 30:00: ideal for news/talk formats.
   • 30:00 → 02:00:00: maximum comfort for music programs and events.
2. Enable replay in your Player (refer to this other guide) if you want to offer it to listeners (disabled by default):
   

This guide introduces HLS, which segments your audio for reliable, compatible, and highly distributable HTTP streaming, ideal for mobile and large audiences.

What is HLS?

HLS (HTTP Live Streaming) is a streaming protocol that cuts audio into small segments of a few seconds and publishes a .m3u8 manifest listing these segments. The Player downloads these segments via HTTP/HTTPS (ports 80/443), which facilitates caching, recovery after interruption, and large-scale distribution.

On your Radio Streaming service, activating HLS adds an additional dedicated stream. It has its own listening URL (HLS manifest) and can be selected and prioritized in the infomaniak Player. The HLS stream coexists with your historical streams (e.g., MP3/AAC), without service disruption.

Benefits for a radio stream

• Extended compatibility: native support on iOS/iPadOS (Safari) and wide support via modern HTML5 players and third-party applications.
• Scalability and performance: streaming via HTTP(S) easily distributable by CDN and caches; better scalability than a single continuous stream.
• Robustness: in case of micro-cuts, the player can recover the following segments and resume quickly; less sensitive to temporary losses.
• Network traversal: works on 80/443, generally better accepted by corporate firewalls and proxies than certain “ICY” streams.
• Simplified HTTPS: secure delivery without plugins or exotic protocols.
• Bitrate adaptation (ABR): when multiple variants are offered, the player can automatically switch according to network quality to limit interruptions in mobility.
• Integration flexibility: a distinct listening point allows exposing HLS as the main, secondary, or backup stream in your Player.

Specificities and points of attention

• Latency: HLS adds latency generally in the order of a few tens of seconds (related to the size of the segments and buffering). This is normal for this protocol.
• Compatible player required: use the infomaniak player or a player/web SDK supporting .m3u8 manifests.
• Heterogeneous fleet: some older hardware receivers (web radios, IP car radios) only accept MP3/Icecast streams; keep their historical URLs in parallel.
• Conditional ABR: bitrate adaptation is only effective if multiple profiles are published; otherwise, the HLS stream remains functional in single quality.

This guide explains how to maintain control over your Radio Streaming MP3/AAC or HLS by activating protection by unique key (token) to decide, for example, whether a listener can listen to your radio or not.

Preamble

• With each connection, you will make a request to the Infomaniak API, which will return a unique token with a limited and configurable lifespan.
• This token will authorize anyone who possesses it to consume the stream during this period.
• You can protect an MP3/AAC or HLS stream independently of each other (the same applies to geolocation, by the way).
• Activating the restriction involves changing the stream configuration, which may take a few minutes to be replicated on the servers.

Protect an audio stream by unique key

To do this, simply go to the restriction settings and activate token protection on the stream you want to secure:

1. Click here to access the management of your product on the Infomaniak Manager (need help?).
2. Click directly on the name assigned to the product concerned:
   
3. Click:
   1. either on the radio name:
      
   2. or on Restrictions in the left sidebar to apply restrictions to the entire product:
      
4. When choosing a above, then click on Restrictions in the left sidebar.
5. Choose HLS if necessary.
6. Click on the action menu ⋮ located to the right of the item concerned.
7. Click on Token restriction:
   
    

Then activate the protection.

Warning, at the moment you activate this option, access to the stream will be instantly blocked for new connections. Adapt your Players to take into account the restriction, as illustrated in the example below:

Create a Radio API token

To access the Radio API, you must first authenticate using an application token. This step only needs to be done once. To create this application token, refer to this other guide.

The scope is radio and the duration is unlimited to avoid having to regenerate a code regularly. Once the token is generated, copy it to paste it into the example below.

Example of use in PHP language

For MP3/AAC or HLS, the code can be substantially the same, only the URL called in POST changes in its form.

if (!defined('API_TOKEN')) {
     define('API_TOKEN', 'AYF5lSh3c7Xy5974Fs12RTkTThujT-L9R4Xk2ZfGyP6sV7QqJ1oC3jD8nFtKzIxUeMw5oNzR6');
}
/**
 * Fonction générique pour executer des requêtes cURL
 *
 * @param string $method Méthode HTTP (GET, POST, PUT, etc...)
 * @param string $url Url de l'api a requêter
 * @param array $headers Liste des en-têtes HTTP (l'autorisation doit être passée ici avec un ['Authorization: Bearer ']
 * @param array $payload Un tableau contenant les données pour créer un token
 * @return mixed
 */

function request(string $method, string $url, array $headers = [], array $payload = []): mixed{
    // prepare options array
    $opts = [
        CURLOPT_HTTPHEADER => $headers,
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_URL => $url,
        CURLOPT_CUSTOMREQUEST => strtoupper($method),
    ];

    // add payload if relevant
    if ($payload && $method !== 'GET') {
        $opts[CURLOPT_POSTFIELDS] = json_encode($payload);
    }
    $ch = curl_init();
    curl_setopt_array($ch, $opts);
    $result = curl_exec($ch);
    if(curl_errno($ch)){
        throw new Exception(curl_error($ch));
    }
    $data = json_decode($result, true);
    if ($data['result'] === 'error') {
        throw new Exception($data['error']['description'] ?? 'an error occured');

    }
    return $data['data'];
}

We will create the token, the URL for creating the token breaks down as follows:

• For an MP3/AAC stream

POST https://api.infomaniak.com/1/radios/acl/streams/mountpoint.mp3/token

Example to protect https://newradiotest.ice.infomaniak.ch/newradiotest-128.aac the route will be: https://api.infomaniak.com/1/radios/acl/streams/newradiotest-128.aac/token

• For an HLS stream

POST https://api.infomaniak.com/1/radios/acl/hls_streams/<stream>/token

Example to protect https://myradiostream.radiohls.infomaniak.com/myradiostream/manifest.m3u8 the route will be: https://api.infomaniak.com/1/radios/acl/hls_streams/myradiostream/token

Example in the case of MP3/AAC, remember to adjust:

$token = request(
    'POST',
   'https://api.infomaniak.com/1/radios/acl/streams/newradiotest-128.aac/token',
    // en-tête d'authorization
    [
        'Authorization: Bearer ' . API_TOKEN,
        'Content-Type: application/json',
    ],
    /**
     * payload pour créer le token, vous pouvez passer les valeurs suivantes
     * window     | 300               | optionnel | durée de validité du token (default: 5 minutes)
     */

    [
        'window' => 3600, // 1h validity
    ]
);

It is important to note that if this code is generated at the time the page is loaded, the listener will have "window" seconds to start playing the stream. Beyond this time limit, the token will expire, and the stream will no longer be able to be started unless the page is reloaded. Depending on your needs and use case, it will be necessary to adjust this delay in the best possible way.

You will also need to replace the playback URL of your stream below with the one indicated while keeping the parameter $token at the end. And finally, we display the Player (here a simple html5 tag, but you can of course add any overlay afterwards, the token being passed in the parameters $_GET of the url).

$streamUrl = "https://newradiotest.ice.infomaniak.ch/newradiotest-128.aac?$token";
echo "<audio controls=""><source src="$streamUrl"></audio>";

This guide covers the statistics of Streaming Radio which allow you, among other things, to check any possible stream interruptions.

Analyze recent statistics

To access this information:

1. Click here to access the management of your product on the Infomaniak Manager (need help?).
2. Click directly on the name assigned to the product concerned:
   
3. Click on Statistics in the left sidebar:
   
4. Click on Real-time audience in the left sidebar.
5. Choose a date to load the corresponding graph.
6. Hover over any reported interruptions highlighted in color to get information:
   
7. Zoom in on the graph with the mouse wheel or by framing the period.
8. You can return to the initial display by clicking at the bottom right:
   

This guide details the configuration of a Player for your Infomaniak Streaming Radio.

Prerequisites

• Add a Player using the Infomaniak template.

Configure the Player Options

Once you have linked your stream to your Player and your Player is created:

1. Click here to access the management of your product on the Infomaniak Manager (need help?).
2. Click directly on the name assigned to the product in question.
3. Click on My players in the left-hand menu.
4. Click on the name of the Player to configure (or add a new player by clicking on the button above):
   

1. Appearance tab

Here you can choose the player size (large, medium, mini, or multi-radio player) and its display percentage.

You can customize the colors of the background, buttons, and text:

A toggle switch allows you to enable or disable the display of broadcast tracks, with or without their broadcast times:

• Refer to the details on this at the end of this guide.

The Player can display:

• an illustration representing the album cover, or a substitute image if it is not available,
• a fixed image (3 MB max.),
• your radio station's logo, which you can customize here:
  
• a visualization of the audio spectrum (Spectrogram / Spectrum).

2. Broadcast tab

This is where you can link your radio streams (HLS or not) to your Player, which you are currently configuring.

Please refer to this other guide for information on the options available for managing live broadcasts:

3. Thumbnails tab (media preview)

This is where you can modify the preview image (thumbnail) that is displayed on the Player when the media is loading, or unavailable/restricted:

4. Player Information tab

This is where you can name your Player and decide whether to display or hide:

• the title and artist instead of the radio station's name,
• the number of listeners,
• the Infomaniak logo.

5. Sharing Options tab

A toggle switch allows you to enable or disable certain services such as Facebook:

Once enabled, a sharing button for these services will be visible on your Player:

Details of the broadcast history (tab #1)

The broadcast history allows you to relisten to the music that was played (between 1 and 40 tracks) if your stream is of the HLS type (you can then define a buffer ranging from 25 seconds to 2 hours):

The rewind and relisten feature is not enabled by default: it remains optional in order to respect the restrictions of certain countries or radio stations. Once enabled, the radio station manager can choose which streams will be available for broadcast (see tab #2 above), while the listener can select the listening quality in the Player:

Position & intégration de l'historique de diffusion

The list can be viewed in several ways:

• directly below the Player,
• on the Player,
• or separately in the integration of your website…

Indeed, it is possible to display the history in a second iframe, separate from the main Player. Example of URL for the Player:
https://player-radio.infomaniak.com/2/prod/super/7cbaa24a-3510-47a4-b41e-b99218bfd507

And for the history log:
https://player-radio.infomaniak.com/2/prod/history

Both iframes must be embedded on the same page and communicate with each other to update the history or launch a previously broadcast track.

A second integration mode allows you to display an independent history log, without the main iframe. Simply add the Player ID to the URL:
https://player-radio.infomaniak.com/2/prod/history/7cbaa24a-3510-47a4-b41e-b99218bfd507

This mode is suitable, for example, for users of another Player who wish to display only the history of tracks.