Knowledge base

This guide concerns the listening data for Infomaniak Streaming Radio, which can be exported using the FTP protocol. These logs (which are also used to generate listening statistics (❓: help) after being “cleaned” or “processed”) are then automatically transferred via FTP for subsequent processing.

Introduction

• Your radio logs will be provided in the form of a compressed file xyz.mp3-20140805.log.gz (the log date is in YYYYMMDD format).
• Each log starts at 04:00 Swiss time and ends at 03:59:59 the following day.
• The log is in the following format: ip user-identifier authuser [date-time] "request" status bytes "referer" "useragent" listening-time:

  • 81.56.215.98 - - [09/Apr/2019:08:23:18 +0200] "GET /toto.mp3 HTTP/1.1" 200 1211297 "-" "Mozilla/5.0 (X11; U; Linux i686; en-US; rv:1.9.0.8) Gecko/2019032711 Ubuntu/8.10 (intrepid) Firefox/3.0.8" 69

  • It may happen that the log line is malformed, for example, due to a referer that is too long; this behavior of Icecast cannot be changed.
• The addresses in the 84.16.67.128/25 range should be ignored because these are the streaming servers.
• From the settings page in the Manager, you can request logs for past days.
• You can also directly export them to ACPM (❓: help) or Mediapulse (❓: help).

Enable sending logs via FTP

To do this:

1. Click here to access the management of your product in the Infomaniak Manager (need help?).
2. Click directly on the name assigned to the product in question.
3. Click on the name of the audio stream in question.
4. Click on Settings in the left-hand menu.
5. Enable log export via FTP using the toggle switch.
6. Enter a hostname: the address of the FTP server.
7. Enter a username: the name of the FTP account.
8. Enter a password: the password for the FTP account.
9. Enter the directory on the server where the logs will be stored.
10. Click the Save button at the bottom of the page:
    

Processing the logs

The best approach is to use a regular expression like the one below:

"/^(\S+)\s(.+)\s(\S+)?\s\[((\d\d)\/([a-zA-Z]{3,3})\/(\d\d\d\d)\:(\d\d)\:(\d\d)\:(\d\d)\s\+\d\d\d\d)\]\s"GET\s\/([\-a-z0-9]{1,40}(\.)?(mp3|aac|ogg){0,1})(.*)?"\s(\d{3,3})\s(\d+)\s"(.+)"\s"(.+)"\s(\d+)$/i";

This syntax is for the PHP function preg_match and will need to be adapted if other functions/languages are used.

The preg_match function returns an array with the following significant positions:

This guide details the Auto DJ feature of Infomaniak's Streaming Radio service, which allows you to create a live radio station that broadcasts 24/7 using your own audio content (music, shows, podcasts, jingles, etc.) that you have previously uploaded to your storage space.

Organize and import your audio files

Prerequisites

• Enable Auto DJ on your Streaming Radio (❓: help).

The first step is to prepare your content. The tool currently accepts files in .mp3 and .aac format. You can import an entire folder containing your audio files:

The default folder is named Music. You can create new folders within it beforehand to import files from your device.

You can also manage your library directly from your VOD/AOD space:

Metadata Management

You can directly modify the ID3 tags (title, artist, album, cover art) of an audio file from the interface so that this information is displayed correctly on your players:

Create playlists

Once your files have been imported, you can group them into playlists:

Manual playlist

1. Create a manual playlist:
   
2. Select the tracks and their order precisely:
   

Automatic playlist

1. Select an automatic playlist:
   
2. Below, define smart criteria (by tags, styles, or artists) to allow the system to dynamically generate the playlist:
   

Advanced playlist

Unlike the playlists above, the advanced playlist allows you to schedule a precise sequence of content that will loop during the selected time slot. This feature is ideal for automatically inserting jingles or intermissions at regular intervals, and for grouping tracks from multiple sources within the same time slot:

1. Select an advanced playlist:
   
2. Below, define the structure of your broadcast cycles by combining different sources from your library (folders, playlists, or tags) and specifying the number of tracks to play for each item:
   
   Example programming:
   • Play 3 tracks from the Film Music playlist
   • Play 1 track from the Night folder
   • Play 1 sound with the Jingle tag
3. The Auto DJ will then play the sequence in a loop (1 → 2 → 3 → 1 → 2 → 3, etc.).
   • A weighting mechanism ensures fair rotation of media: the system will not replay the same tracks at the same time, thus ensuring a real refresh of your content with each cycle.

Schedule broadcasts (Planning)

The scheduling tool allows you to manage your program schedule in detail:

• Scheduled programming: organize your broadcasts by playlist or by folder on a weekly calendar:
  
• Fallback playlist (existing by default): configure a backup playlist that will be broadcast automatically when no specific program is scheduled, ensuring an uninterrupted stream.
• Live / AutoDJ Transition: You can schedule time slots or automate the resumption of the AutoDJ stream as soon as an encoder (external source) stops broadcasting its stream.

Advanced Audio Settings

To ensure professional audio quality, several processing options are available:

• Audio normalization: standardizes the audio level of all your files to avoid volume differences between tracks.
• Transitions: configure crossfades and overlaps between tracks:
  

Integration and statistics

The stream generated by Auto DJ is a standard streaming stream that benefits from all the tools in the Infomaniak ecosystem:

• Infomaniak Player: automatic display of currently playing tracks and broadcast history.
• Multi-format streaming: HLS support and stream transcoding.
• Advanced statistics: precise real-time audience tracking and detailed reports.

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

Configure the broadcast of a radio stream

To access the radio streaming service:

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

You can now configure an application using the settings obtained at the end of this process.

This guide concerns the listening data from Streaming Radio that can be exported to Mediapulse.

Introduction

• Mediapulse, an independent organization in Switzerland, measures the audience reach of radio, television, and online platforms.
• This data, recognized as the official benchmark, helps the media and advertising market to analyze, compare, and structure their activities.
• Subject to DETEC supervision via OFCOM, Mediapulse ensures transparency, independence, and scientific rigor; it guarantees reliable measurements adapted to the evolution of media.
• You can export your radio logs to this service.
• You should also consult this other guide about a similar service, but intended for France.

Manage the 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 has been established with them, contact Infomaniak supportby providing 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 interface for your product in the Infomaniak Manager (need help?).
2. Click directly on the name assigned to the product in question.
3. Click on the name of the audio stream in question.
4. Click on Settings in the left-hand menu.
5. Enable or disable log export to Mediapulse using the toggle switch:
   ‍

This guide explains how to transfer audio streams from one of your Infomaniak Streaming Radio stations to another station within the same organization.

Transfer audio streams

To do this:

1. Click here to access the management interface for your product in the Infomaniak Manager (need help?).
2. Click directly on the name assigned to the product in question.
3. Click on the action menu ⋮ located to the right of the item in question.
4. Choose Transfer:
   
5. Search for and confirm the name of the other radio you own within the same Organization.
6. Confirm 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 divides audio into small segments of a few seconds and publishes an .m3u8 manifest listing these segments. The Player downloads these segments via HTTP/HTTPS (ports 80/443), which facilitates caching, resuming after interruptions, and large-scale distribution.

On your Radio Streaming service, enabling HLS adds an additional 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 existing streams (e.g., MP3/AAC) without any service interruption.

Advantages for a radio stream

• Wide compatibility: native support on iOS/iPadOS (Safari) and broad support via modern HTML5 players and third-party applications.
• Scalability and performance: delivered via HTTP(S), easily distributed by CDNs and caches; better scalability than a single continuous stream.
• Robustness: in the event of brief interruptions, the player can retrieve the following segments and quickly resume; less susceptible to temporary losses.
• Network traversal: works on ports 80/443, generally better accepted by firewalls and corporate proxies than certain “ICY” streams.
• Simplified HTTPS: secure delivery without plugins or exotic protocols.
• Adaptive Bitrate (ABR): when multiple variants are offered, the player can automatically switch based on network quality to minimize interruptions on mobile devices.
• Flexible integration: a separate listening point allows you to expose HLS as the primary, secondary, or backup stream in your player.

Specific features and points to note

• Latency: HLS adds a latency of generally 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 that supports .m3u8 manifests.
• Heterogeneous environment: some older hardware receivers (web radios, IP car radios) only accept MP3/Icecast streams; keep their historical URLs in parallel.
• ABR condition: Adaptive bitrate is only effective if multiple profiles are published; otherwise, the HLS stream remains functional in a single quality.

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

Introduction

• Each time you connect, you will send 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 access the stream during this period.
• You can protect an MP3/AAC or HLS stream independently of each other (the same applies to geolocation).
• Enabling the restriction involves a change to the stream configuration, which may take a few minutes to replicate across the servers.

Protect an audio stream with a unique key

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

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

Then, activate the protection.

Please note that when you enable this option, access to the stream will be immediately blocked for new connections.Adjust your players to take the restriction into account, 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, please refer to this other guide.

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

Example of use in PHP

For MP3/AAC or HLS, the code can be largely the same; only the URL called in the POST request changes in its format.

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 now create the token. The URL for creating the token is structured as follows:

• For an MP3 / AAC stream

POST {{URL_11}}

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 {{URL_14}}

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',
   '{{URL_17}}',
    // 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 when the page loads, the listener will have "window" seconds to start playing the stream. After this delay, the token will expire, and the stream will no longer be able to start 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 stream playback URL below with the one you want, while keeping the $token parameter at the end. Finally, we display the Player (here, a simple HTML5 tag, but you can of course add any overlay after that, with the token passed in the $_GET parameters of the URL).

$streamUrl = "{{URL_18}}";
echo "<audio controls=""><source src="$streamUrl"></audio>";

This guide covers the statistics for Streaming Radio, which allow you to view any potential stream interruptions.

Analyze recent statistics

To access this information:

1. Click here to access the management interface for your product in the Infomaniak Manager (need help?).
2. Click directly on the name assigned to the product in question:
   
3. Click on Statistics in the left-hand menu:
   
4. Click on Real-time Audience in the left-hand menu.
5. Choose a date to load the corresponding graph.
6. Hover over any reported outages highlighted in color to view details:
   
7. Zoom in on the graph using the mouse wheel or by selecting the desired time period.
8. You can return to the initial view by clicking in the bottom right corner:
   

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.

This guide details how to manage and display metadata (titles, artists) and album covers for a Streaming Radio / Auto DJ stream when using a custom audio player.

Prerequisites

• Obtain your radio station ID: the station_id value is essential for querying the metadata and cover art APIs; this is the station ID and not the radio pack ID, which you can find:
  • via an API call,
  • or directly from the URL of your dashboard on the Infomaniak Manager: https://manager.infomaniak.com/v3/{account_id}/ng/streaming-radio/pack/{pack_id}/station/{station_id}/dashboard

View the metadata of the tracks being played

The dynamic display of titles and album covers on a custom player relies on public API requests (no authentication required); you can obtain the list of metadata (❓: help) for the 100 most recent tracks broadcast on your radio station via a browser or by using a GET request:

https://metadata.infomaniak.com/api/radio/{station_id}/metadata

Data Format

The most recent broadcast title is always at the end of the list. Each title is described in the following format:

{
  "duration": 565,
  "date": 1791303566,
  "microtime": 1791303566.10439,
  "title": "ARTIST - SONG TITLE",
  "cover": null
}

Details:

• title: metadata formatted as ARTIST - TITLE
• date: start timestamp of the title expressed in Unix time
• microtime: precise timestamp to the microsecond in Unix time
• duration: duration of the track in seconds (present only if the track is not currently playing, corresponding to the difference in seconds between the receipt of the metadata for this track and the next).
• cover: this field is not used in this route and returns the value null; to obtain the cover images, please refer to the section below.

Note: The timestamp is expressed in Unix time; it can be converted automatically or using online tools such as UnixTimestamp or EpochConverter…

Retrieve album covers

Two API routes are available to retrieve the album cover of a track on your radio:

1. Cover image for the currently playing track (recommended):
   GET https://metadata.infomaniak.com/api/radio/{station_id}/metadata-cover?currentTimeOfPlayer={unixtime}
   Provide the current UTC time in Unix format in the currentTimeOfPlayer parameter. This method is recommended for its fast execution.
2. List of recent covers:
   GET https://metadata.infomaniak.com/api/radio/{station_id}/metadata-all-cover
   This method returns all the most recently broadcast covers.