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

Introduction

• Auto DJ uses the files stored in your Infomaniak AOD (Audio on Demand) space to create a linear stream.
  • You can use this same space for your on-demand file storage needs.
• You organize your media, create your playlists, and schedule their broadcast via an intuitive calendar interface.
• This allows you to maintain a continuous broadcast without needing an encoder active at all times.

Activate Auto DJ

Prerequisites

• You must have at least the right to manage the VOD/AOD service “autodj” and the Streaming Audio service in question (or be an Administrator / Legal Representative‍ within the Organization).
• To manage Auto DJ via API, the token created to manage the radio must include the following scopes:
  
  • vod
  • radio
  • workspace:calendar

To start Auto DJ:

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 Auto DJ in the left-hand menu.
5. Read the warnings and click the button to Enable Auto DJ when you are ready:
   
6. Select the AOD space to use if you already have one.
7. Apply your choice by clicking at the bottom right:
   
8. There you go, the AOD space for your audio files to be broadcast is now available:
   

Organize, import your audio files

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:

Once imported, you can structure your files into dedicated folders within your storage space to facilitate the management of your library:

Metadata Management

It is possible to directly modify ID3 tags (title, artist, album, cover art) from the interface so that this information is displayed correctly on your playback devices:

Create Playlists

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

• Manual playlists: precisely select the tracks and their order.
• Automatic playlists: define smart criteria (by tags, genres, or artists) to allow the system to dynamically generate the playlist:
  

Schedule Broadcasts (Scheduling)

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

• Scheduling by time slots: arrange your broadcasts by playlist or folder on a weekly calendar:
  
• Fallback playlist: 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 Auto DJ stream as soon as an encoder (external source) stops pushing its stream.

Advanced Audio Settings

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

• Audio Normalization: Uniforms 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: Support for HLS and stream transcoding.
• Advanced statistics: Precise tracking of your audience in real time and detailed reports.

A Player (i.e., an audio stream player) is essential for your Infomaniak Streaming Radio stations when you want to broadcast them to your listeners and internet users.

Prerequisites

• Add at least 1 Radio station and 1 audio stream.

Create an Audio Player

To create a Player and offer the audio stream to your internet users:

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 blue button to add an audio player:
   
5. You can then choose between:
   
   1. automatic configuration
   2. using the information/URL that will be provided for browser, external player/app/Android or iOS in case you have your own Player or application…

Refer to this other guide regarding the additional configuration of radio Players:

SpacialAudio SAM Cast is compatible with the audio streaming offer.

This guide explains how to remove an audio stream from your Streaming Radio, without deleting the entire product.

Delete a radio

To access the Streaming service and delete one of the streams:

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 radio concerned:
   
4. Click on the action menu ⋮ located to the right of the item concerned.
5. Click on Delete:
   
6. Enter the name of the radio to confirm the deletion.

This guide explains how to obtain and configure notifications when the Streaming Radio stream(s) experience an outage (short and/or long duration).

Preamble

• Every minute, a script checks for outages and only sends an email and creates an event if the outage has lasted at least 5 minutes.
  • It sends another email if the outage has lasted more than 30 minutes.
  • If the stream resumes and an alarm has been sent to you, a confirmation email of resumption is sent.
• All outages are logged and kept for 30 days, but you will not be disturbed in case of a minor outage.
• Regarding the possible reasons for these outages, refer to this other guide.
• All outages are recorded by the system and visible in the events of the Manager.

Email Alert

To configure notifications:

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 menu.
5. Click on the Notifications tab.
6. Enable notifications with the toggle switch:
   
7. Configure the monitoring hours (days of the week / hours).
8. Save your changes.
9. Add the Organization users who should be notified by email or SMS (depending on the settings above):
   

This guide explains how to transmit metadata for the radio stream sent from your radio streaming encoder.

Use the URL provided

You just need to make a GET request to a URL of the following type:

https://[flux]:[password]@api.infomaniak.com/1/radios/stats/metadata?data=artist - title

The complete URL is available in the administration interface:

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 menu.
5. Click on the button to copy the metadata link:
   

Learn more

For developers who code a Player, there are libraries that can search for the transmitted information and display it because the data is transmitted in the stream data. The other possibility is to retrieve the stream information from the server itself.

This guide allows you to quickly use the essential functions of the Infomaniak Radio Streaming (or audio broadcast, live audio streaming... different names used to refer to the same technology: sending content in "live" or slightly delayed, allowing it to be played as it is broadcast).

Configure Radio Streams

• Add a Radio Streaming Stream
• Add an Audio Stream Relay
• Add a Backup Audio Stream
• Configure an encoder (example with the Butt application)
• Create an Audio Player to Broadcast the Stream
• Delete a Stream

To go further...

• Secure an MP3/AAC or HLS Stream with a Unique Key
• Secure an Audio Stream by GeoIP Restriction
• View Listening Statistics
• Export Streaming Radio Logs via FTP
• Export Logs to ACPM (France)
• Export Logs to Mediapulse (Switzerland)
• Resolve a Broadcasting Issue
• Transfer the complete product | Transfer streams

A question or feedback?

• In case of a problem, please consult the knowledge base before contacting support.
• Click here to share a review or suggestion about an Infomaniak product.

This guide covers the audience and listening statistics of Streaming Radio, allowing you to view all information about your radio stream listeners and different audiences.

Preamble

• Refer to this other guide if you wish to process the raw logs yourself.

Access listening 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 the different menus in the left sidebar:

   1. Overview
      

   2. Real-time audience

      • Refer to this other guide on this subject.

   3. Listeners
      

   4. Listening time
      

   5. Consumption
      

   6. Geolocation
      

      • Exporting in .csv format is possible:

   7. Players
      

This guide explains how to specify a backup audio stream on the Infomaniak Radio Streaming.

Thus, if your main stream becomes unavailable, the backup stream will automatically take over the broadcast.

Create a backup stream

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 name of the radio concerned:
   
4. Click on the button to manage your streams:
   
5. Either:
   1. Add a stream to create a new stream and attach a backup stream,
   2. Configure an existing stream to enable the option:
      
6. Click on the toggle switch to enable the backup stream on your stream:
   
7. Copy the information available to you to configure your backup encoder.
8. Save the activation of the backup stream at the bottom right of the page.
   • In the same place, you can set the backup stream as a stream relay to manually enter the parameters corresponding to the backup audio stream:
     

Save the new information at the bottom right of the page.

This guide explains how to link a stream added to your Infomaniak Streaming Radio with your installation that will broadcast the desired content.

Preamble

• In general, Infomaniak is compatible with all the software indicated here: https://www.icecast.org/apps/ but not all support AAC streaming, for example.
• An example configuration is given below for the free and multi-platform application Butt.
• Refer to the information for Edcast (standalone version) / Sam Broadcaster / SpacialAudio SAM Cast… There are also (without guide) StreamDiffusion / MB Recaster …

Obtain connection information

To find the information necessary to configure your encoder:

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 radio concerned:
   
4. Click on the name of the audio stream concerned to get its details:
   
5. The useful information is displayed on the page:
   

Example of encoder configuration

You want to broadcast audio content from a computer. As specified in the preamble above, there are multiple software solutions. Example with the tool Butt available on macOS, among others:

1. Download Butt:
   
2. Open the downloaded application on your computer.
3. Install the application:
   
4. Launch the application to use it:
   
5. Click on Settings:
   
6. Click on Add a server:
   
7. Select the Icecast type.
8. Copy the information of your stream to the encoder (for the password, you will first need to enter your Manager login password, then the stream password will be copyable (and visible with the eye icon):
   
9. Validate your settings by clicking on Add at the bottom right:
   
10. Close the settings and click on the Play button to start the broadcast:
    
11. You can listen to the broadcast of your stream from the Infomaniak dashboard by starting the demo Player:
    

This guide explains how to modify a Streaming Radio offer, for example, to increase the maximum monthly consumption limit or the streaming quality (maximum bitrate).

Modify the existing offer

To modify your existing radio stations:

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 the chevron ‍ to manage the product.
4. Click on Modify the offer in the drop-down menu:
   
5. Navigate using the arrows if necessary and choose the new offer that best suits your needs:
   

The change is made after payment, and the fees are calculated on a pro rata basis for the remaining time until the initial due date.

This guide explains how to maintain control over your radio streams by enabling IP protection or geolocation, allowing you to decide, for example, whether a specific listener can listen to your radio station or not.

Introduction

• You can protect MP3/AAC or HLS streams independently of each other (the same applies to protection by token).
• Activating the restriction involves changing the stream configuration, which may take a few minutes to replicate on the servers.

Protect an audio stream by GeoIP

To do this, simply go to the restriction settings and enable 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 in question:
   
3. Click:
   1. either on the name of the radio station:
      
   2. or on Restrictions in the left-hand menu to apply restrictions to the entire product:
      
4. When selecting 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 Restriction by geolocation:
   

Then configure the restrictions:

1. Choose whether the listed countries will be allowed or forbidden.
2. Search for a country to add it to the list.
3. Activate advanced configuration if necessary.
4. Copy or paste a list of countries (useful for restricting other streams with a simple copy-paste).
5. Click to remove all countries listed on the page.
6. Click the blue button to save:
   

Protect an audio stream by IP

You can define an IP or a range of IPs as a list of allowed or forbidden IPs for accessing a stream.

If you only specify an allowed IP criterion, a geographical restriction must be in place. In this case, the goal is, for example, to forbid a country, but to allow a person from that country to access the stream:

If you want to block access for everyone and only allow one or more specific IP addresses, you must explicitly block the range 0.0.0.0 → 255.255.255.255 (the global address range), and at the same time allow the IP address(es) for which you want to grant access:

This guide explains how to create a stream relay on the Infomaniak Radio Streaming.

Preamble

• First, to create a standard stream, you must have a radio encoder.
  • The configuration parameters provided at the end of the stream creation procedure allow you to configure your encoder.
  • Once this operation is complete, the stream will be sent from your encoder to the Infomaniak servers.
• Next, you have the option to specify the relay of any stream (any web radio, for example).
  • In this case, Infomaniak no longer receives the radio via an encoder that connects to the master server but relays the stream broadcast by another server.
  • If you create this stream relay, your stream is already available and accessible via a host address (domain name or IP address).
  • This address must be specified in the Manager so that the Infomaniak servers can retrieve your stream.
• In the same place, you can enable the backup stream option.
  • Thus, if your main stream becomes unavailable, the backup stream will automatically take over.

Create a stream relay

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. Then click on the radio name:
   
4. Click on the Configure streams button:
   
5. Click on the Add a stream button:
   
6. Select Stream relay.
7. Click on the Continue button:
   

The configuration requires 3 fields:

1. server name
2. port
3. mount point

If the stream you need to relay is composed as follows: http://server.com:82/music.mp3 then indicate:

1. server.com
2. 82
3. music.mp3

That said, in some cases the mount point field can be empty and the extension not necessarily required. If there is no port in the URL with http, you need to put simply 80.

Click on the blue button to validate the stream, then click on Save at the bottom right.

You can also add a stream relay as a backup stream if you enable this option when adding a standard stream:

This guide explains how to prevent a Streaming Radio from requesting a password when connecting to the audio stream.

Restricted streams

If the stream protection is enabled and the token is not generated or is generated incorrectly, the prompt (password request) will be visible. The same applies to users outside the geographical restriction criteria that may have been activated on the stream.

Less common: a failure

The reception server is the server to which your encoder connects to broadcast your stream. The broadcasting servers connect to the reception server and broadcast your stream to the listeners. If the reception server fails, another backup server takes over. This architecture ensures the broadcasting of thousands of streams to several tens of thousands of listeners while preventing failures as much as possible.

In case of a failure, Infomaniak is automatically notified and will strive to restore the situation as quickly as possible. If necessary, Infomaniak sends an email to all its radio clients with information about the causes of the failure.

The failure of a single broadcasting server causes the disconnection of thousands of listeners at the same time, who then attempt to reconnect. This results in an overload and causes a password request to be displayed to the listeners. It is then necessary to attempt a connection again about thirty seconds later.

Generally, the situation returns to normal after a few minutes.

This guide allows you to perform a diagnosis of your Streaming Radio to find the source of potential issues, causes of disconnections, etc.

Preamble

• If you are broadcasting your FM radio, check the proper functioning of the acquisition card.
• If you are broadcasting a Webradio, make sure your broadcasting software is working properly.
  • Be mindful of the CPU load on your computer: ensure that it is not saturated by making sure you have enough memory if you are performing operations in addition to AAC stream encoding, which is very memory-intensive.
• It is possible that your Fibre/ADSL line can no longer keep up with the data sent to the server.
  • You must have an upload speed (i.e., upload) at least equivalent to the total of the streams sent to the server (for example, a radio that sends a stream at 128kbs + a stream at 48kbs, which gives 130 + 50 = 180kbit/s at minimum).
  • Generally, radios dedicate a line exclusively to the broadcasting of audio streams to avoid any bandwidth saturation in case of simultaneous sending, such as sending a large email with an attachment. This precaution ensures that the upload does not monopolize the bandwidth, which could cause interruptions in the broadcasting of audio streams during listening.
  • Your ISP can also cause a line cut, even if it is minimal, but this will have the effect of cutting the radio stream.
• If your encoder is configured to send metadata to the servers via a text file hosted by another provider, and the latter experiences disruptions, the stream can also be disrupted!

Analyze recent statistics

Statistics allow you to check for any stream interruptions. 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:
   
   • Statistics are detailed in this other guide.

Check the proper functioning of the elements

The radio diagnostic page allows you to access various information. To access these diagnostics:

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 Diagnostics in the left sidebar.
   
   1. The Network and Stream tab allows you to test the connection between your server and Infomaniak infrastructures.
   2. The Encoders tab displays a history of encoder connections to analyze whether the streams were operational.
   3. The Servers tab informs you about the general status of the network infrastructures to verify the proper functioning of the reception and broadcasting servers.
      • Note that in the event of a general broadcast stream outage, Infomaniak is notified and intervenes immediately.
   4. The Buffer Stability tab is detailed in this other guide.

This guide provides information about the audio bitrates of Infomaniak's radio streaming streams.

Test the audio bitrate

The connection test available in your Manager evaluates the link between your server (the one from which you encode your streams) and Infomaniak's facilities located in Geneva, Switzerland.

It measures the time required to send or receive data as well as the response time. These measurements can fluctuate depending on network traffic. The test determines the required bitrate based on the available bitrate. However, if other data transfers are in progress, the measured bitrate may be lower than the theoretical bitrate of your line.

If in doubt, note the test results at different times of the day, as well as the technical details of your connection and the number of computers sharing the line.

To broadcast a radio station without interruptions, a quality Internet connection and sufficient bitrate are necessary. The bitrate must always guarantee a margin of free bandwidth. If your connection is shared between the radio and other devices, the broadcast quality may be affected.

A standard ADSL connection is usually sufficient, but for uninterrupted broadcasting, it is recommended to dedicate a connection to your radio and rent another one for other uses. You can also ask your Internet service provider to check the line quality and measure the actual bandwidth.

To detect any temporary line saturations, run a long-term buffer test.

This guide concerns the buffer and latency of Streaming Radio. While latency is inevitable, proper buffer management can optimize your broadcasts while minimizing interruptions.

Introduction

• The buffer, or memory buffer, is a small memory area that must be filled before the Player starts playing the music from your audio stream. It corresponds to a few seconds of audio. It is designed for a more comfortable listening experience, to prevent small interruptions in the stream from being audible, which leads to choppy and unpleasant sound.
• The receiving and broadcasting servers also have buffers; real-time transmission is never instantaneous due to several technical factors:
  • A latency of 3 to 4 seconds between the generation of the sound and its reception is normal.
  • Players always buffer at least 1 to 2 seconds before starting playback.
  • Icecast uses a 64KB buffer by default, which is equivalent to approximately 4 seconds of streaming at 128kb mp3.
  • Encoding clients also have buffers to prevent interruptions.
  • Reducing the size of the buffers can reduce latency, but this practice is risky.
  • Since Internet connections do not guarantee a constant bandwidth, smaller buffers can lead to interruptions.

Analyze buffer stability

The diagnostic available in your Manager displays the amount of memory occupied by the buffer each second. If the stream is working correctly, the values should be stable:

An unstable buffer indicates either poor connection quality or line saturation. Consult this other guide if you are looking for troubleshooting steps.

This test is also useful for helping to detect temporary saturations of an Internet line. If the buffer is sometimes stable and sometimes unstable, it may be a sign that some users sharing the Internet line are occasionally saturating the line, causing disruptions to your stream.

To verify this hypothesis, run a long-duration buffer test during peak usage times and observe any potential disruptions.

This guide details the monetization possibilities for Radio Streaming and the management of advertising for your streams.

Enable advertising for Radio Streaming

Prerequisites

• Contact one of the 2 approved advertising partners:
  • AdsWizz
  • SoundCast
• Once the contract is established, if necessary, ensure that the selected agency informs Infomaniak of the effective activation.
• This step will allow you to proceed with the migration of streams to the corresponding cluster.

Then, you will be able to manage pre-roll and/or mid-roll advertisements directly from the agency's platform, independently.

Types of Advertising Insertions

The type of advertising called in-stream pre-roll consists of broadcasting an advertisement just before the start of the live audio stream. In concrete terms, the advertisement is automatically triggered when the listener clicks the Play button, before switching to the live program.

The pre-roll differs from the jingle: the first is an advertisement, while the second is part of the station's branding or sound identity.

Finally, the mid-roll – that is, the insertion of advertisements between two program segments – corresponds to the standard operating mode offered by the two partners mentioned above.

Technical Conditions

When integrating in-stream pre-roll advertisements into a live radio stream, it is imperative to ensure the perfect match of audio parameters between the advertisement and the main stream:

• The bitrate (binary rate) and sampling frequency must be identical to avoid any interruption, latency, or desynchronization at the time of transition between the advertisement and the live broadcast.
• This requirement guarantees smooth and stable broadcasting, an essential condition for maintaining listening quality and real-time service continuity.

This guide concerns the listening information of Streaming Radio that can be exported to ACPM (formerly OJD Numérique).

Preamble

• ACPM, Alliance for Press and Media Figures, is an independent organization in France that certifies data related to the distribution, audience, and traffic of media.
• This data, recognized as the official reference, supports market players in the media and advertising sectors in analyzing, comparing, and structuring their strategies.
• Under the governance of its bodies composed of media professionals, ACPM ensures transparency, independence, and methodological rigor; it provides reliable certifications in line with the evolution of the media sector.
• Also refer to this other guide regarding a similar service but intended for Switzerland.

Manage ACPM Certification

Prerequisites

• The Organization in which the Streaming service is located must be established with an address in France.
• To activate ACPM certification, please contact this service by email: equipe-ojdnumerique@acpm.fr.
• Once the contract is established with them, contact Infomaniak support by providing the information related to your ACPM 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 menu.
5. Activate or deactivate the export of logs to ACPM with the toggle switch:
   

This guide concerns the listening information of Infomaniak Streaming Radio that can be exported using the FTP protocol; these logs (from which the listening statistics are also derived after "cleaning" or "purification") are then automatically transferred by FTP to be processed.

Preamble

• The logs of your radio will be provided in the form of a compressed file xyz.mp3-20140805.log.gz (the log date is in the form YYYYMMDD).
• Each log starts at 04:00 Swiss time and ends at 03:59:59 the next day.
• The log is in the form ip user-identifier authuser [date-time] "request" status octets "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, due to a referer that is too long, for example; this behavior of Icecast cannot be modified.
• The IP addresses in the range 84.16.67.128/25 must be ignored as they are the streaming servers.
• From the settings page on the Manager, you can request the logs of past days.
• You can also directly export them to ACPM or Mediapulse.

Enable FTP log sending

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 name of the audio stream concerned.
4. Click on Settings in the left sidebar.
5. Activate the FTP log export with the toggle switch.
6. Enter a host name: server address.
7. Enter a username: FTP account name.
8. Enter a password: that of the FTP account.
9. Enter the directory on the server where the logs will be stored.
10. Click on the Save button at the bottom of the page:
    

Process 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 function preg_match returns an array with the following significant positions: