Knowledge base
1000 FAQs, 500 tutorials and explanatory videos. Here, there are only solutions!
This guide explains how to remove an audio stream from your radio streaming without deleting the entire product.
Delete a Radio
To access the Streaming service and delete one of the streams:
- Log in to the Infomaniak Manager (manager.infomaniak.com) from a web browser like Brave or Edge.
- Click on the icon at the top right of the interface (or navigate through the left side menu, for example).
- Choose Radio Streaming (Streaming universe).
- Click on the name of the relevant object in the displayed table.
- Click on the action menu â‹® on the right of the relevant object in the displayed table.
- Click on Delete
- Enter your account password and confirm the deletion.
When you have already ordered an audio stream and go back to your Manager (manager.infomaniak.com) in the product ordering menu, you'll be able to change the streams of your existing radios.
Actions to be carried out
Your list of radios can be found under the radio ordering section.
To modify the stream of one of your radios, click on the PLUS on the left of the line to open the drop-down menu.
Then click on the icon to the right to modify the existing stream.
When you select new parameters (number of simultaneous listeners, format, throughput), the price of your offer will be updated automatically. You can choose to pay the difference straight away in order to benefit from the changes immediately. You may also choose to pay in accordance with the current contract's due date, in which case the changes will become effective as from that date only.
This guide explains how to configure an audio stream broadcast correctly.
Configuring a radio stream broadcast
- Open the admin console (https://manager.infomaniak.com)
- Go to Audio Streaming
- Click on the stream to be configured
- In the left-hand menu, click onConfiguration
- Check that the configuration of your encryption software matches the settings indicated on this page
Actions to be carried out
Log in to the admnistration interface
Go to Radio Broadcast -> Settings
Put the Spare stream to ON and confirm.
To find the technical details which will enable you to set the spare stream of a second encoder, go to Encoder configuration. An extra section will have appeared there.
Illustrated steps
Streams status (normal format and spare)
More information
To set up a relay on your spare stream, go to Stream format and edit your audio stream.
After registering with OJD* and enabling the option in your radio administration console, the necessary statistical data is automatically transmitted to this organization in order to certify your radio broadcast.
The results of their checks are an essential reference when establishing advertising rates, for example, or as a base of comparison for public and administrative authorities and courts of law, etc.
Official ACPM website: http://www.acpm.fr/
Enable OJD Digital certification
- sign up with OJD (please contact Mr. Jean-Paul Dietsch at equipe-ojdnumerique@acpm.fr)
- once the OJD has validated the activation of your service, open the Manager (manager.infomaniak.com)
- go to Audio Streaming
- select the radio feed in question
- on the left-hand menu, go to Settings
- enable the Enable OJD Digital certification option
Médiamétrie is an audio stream traffic measurement system based on tagging technology installed directly within embedded player frames and directly within Flash player. A charge is made for this service and it is not provided by us directly. Instead, our system is compatible with their measurement solution, which counts the number of listeners to our audio streams via one of the players supplied by us (slightly less accurately on iOS). Please note that if listeners go via an independent application (iTunes, VLC, …) or direct link to the stream, this will not be counted by the traffic measurement system.
Actions to be carried out
Contact http://www.estat.com to obtain the "serial number" needed for service activation.
Log into your control panel
Click on Radio Broadcast -> Flash Player
Go to the player configuration page in the «Advanced Settings» box.
Tick the option «Enable Stats Service» and enter the serial number provided by Médiamétrie
OK the settings via the button at the bottom of the page
Embed the player using the IFrame and eStat Médiamétrie statistics will be automatically enabled
Illustrated steps
MP3 stream sent to an AAC radio broadcast service (the Flash player never recognizes the stream)
This guide explains how to deactivate or activate Médiamétrie-eStat statistics.
Actions to perform
- open the admin console (https://login.infomaniak.com)
- go to Streaming audio
- click on the streaming concerned
- in the left side panel, click on Player flash
- under Advanced settings, check or uncheck the box Activate the statistics service
- click on Apply the changes
We are compatible with all Web Radio Stats products, particularly with this application:
- Web Radio Statistics (iOS)
- Web Radio Statistics (Android)
The necessary information is available in your admin console:
- open the admin console (https://login.infomaniak.com)
- to link in Audio streaming
- click on the stream concerned
- in the left side menu, click on Settings
- go to the Additional information tab
- the data required for configuration is under Instant statistics
This guide explains how to maintain control over your MP3/AAC or HLS radio streaming streams, for example, to decide if a listener can listen to your radio by activating protection with a unique key (token).
Protecting an Audio Stream with a Unique Key
The principle is simple: 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 that period.
You can protect an MP3/AAC or HLS stream independently (the same goes for geolocation).
To do this, simply go to the restriction settings and activate token protection on the stream you want to secure:
- Log in to the Infomaniak Manager (manager.infomaniak.com) from a web browser like Brave or Edge
- Click on the icon at the top right of the interface (or navigate using the left sidebar menu, for example)
- Choose Streaming radio (under Streaming)
- Click on the name of the relevant object in the displayed table
- Click on Restrictions in the left sidebar menu
- Select HLS if necessary
- Click on the action menu â‹® to the right of the relevant stream in the displayed table
- Click on Token restriction
Then activate the protection.
Attention: when you activate this option, access to the stream will be instantly blocked for new connections. Adjust your players to take into account the restriction, as illustrated in the example below:
Creating a Radio API Token
To access the Radio API, you must first authenticate yourself with an application token. This step only needs to be done once. To create this application token, read this guide.The scope is radio, and the lifespan 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 essentially the same, with only the URL called in POST changing in its form.
/**
* Generic function to execute cURL requests
*
* @param string $method HTTP method (GET, POST, PUT, etc...)
* @param string $url URL of the API to request
* @param array $headers List of HTTP headers (the authorization must be passed here with a ['Authorization: Bearer
* @param array $payload An array containing data to create a token
* @return mixed
*/
- For an MP3 / AAC stream
- For an HLS stream
POST https://api.infomaniak.com/1/radios/acl/streams/<b>mountpoint.mp3</b>/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
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, make sure to adjust
'POST',
'https://api.infomaniak.com/1/radios/acl/streams/newradiotest-128.aac/token',
// authorization header
[
'Authorization: Bearer ' . API_TOKEN,
'Content-Type: application/json',
],
/**
* payload to create the token, you can pass the following values
* window | 300 | optional | token validity duration (default: 5 minutes)
*/
[
'window' => 3600, // 1h validity
]
It is important to note that if this code is generated at the time of page loading, the listener will have "window" seconds to start playing the stream. After this time, the token will expire, and the stream will no longer be able to be played 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 below the playback URL of your stream instead of the one indicated while keeping the $token
parameter 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 $_GET
parameters of the URL.
$streamUrl = "https://newradiotest.ice.infomaniak.ch/newradiotest-128.aac?$token";
echo "<audio controls=""><source src="$streamUrl"></audio>";