How to Generate a V4 Web Player

The web console is your web player. It is usually a pop-out player and you can provide a listen link to it on your website.

Most broadcasters host the web console on their own website hosting. For smaller stations, Radioplayer can offer a service to host your console on our servers for an additional fee. However, the preference is always that you should do this ourself but if you do not have the means to do this, please see our support page for more information.

When you log in to your My Radioplayer account, you will see Generate Console under Tools on the left-hand side of the page. 

Clicking on ‘Generate Console' will take you to a selection page where you will see a drop-down menu of all your stations. From this menu, select the station you wish to generate a web console for and click Go To Create Console.

Please note:

  • If you're doing this process for the first time, as a new station, choose the option to generate a pop-up player since this is mandatory, otherwise we can't put your station live on Radioplayer.

  • You need to specify your web stream in your station profile before generating your console. You can do this by selecting the 'Update Station Profile' link next to the station in the station list.

Station logo and link

The first step in the console generation process is to specify your station logo and link to your web page.

The required image dimensions are shown above (220 x 48px) but Radioplayer will by default use a logo image uploaded during entering the station profile.

The link to your web page will be used to launch your web page when a user clicks on your station logo. 

Colour Theme & Custom Colour

Radioplayer will automatically check to make sure the chosen colour theme adequately contrasts with the custom colour. Please make the appropriate adjustments to the theme/custom colour if the colour contrast is not approved.

Based on your selected colour theme and your station logo, you will see a preview of your web player control bar. Your selected logo will appear on the left - example below.

Content Space Option (Plugin Space)

You have three options for your web player's content space: 

  • Widget Option

  • Windowed Option (iframe)

  • Image Option

The Widget Option displays up to 3 dynamic panels of content to display your station and programme information. 

The Windowed Option shows a webpage in an iframe to display your own specified content. If you have previously hosted an iframe content panel for your previous web player, you can continue to show it using this option.

The Image Option allows you to upload a static image with a clickable link that listeners can follow. This is the simplest option and should be used if your station is not sending any programme or now playing information and does not provide any on-demand content.

Select whichever content space option suits your station, and follow the corresponding steps.

Stream Fallback

You have the option to specify an additional fallback stream. It handles fallback between streams, enabling the best streams to be served to each browser. The fallback stream ensures that in the rare circumstance that your station's streams cannot be played, the web player will fall back to the stream you have specified.

Generate Console

Once you have selected your preferred option and provided a fallback stream, select 'generate console' to see a preview of your console. If you are happy with how it looks and, if you have selected the widget option, you are sure that you are supplying the corresponding data, click Generate Console again to generate the zip folder. 

Once you have downloaded the zip folder from Radioplayer, create a 'player' or 'radioplayer' directory in the root of your website, or if you would rather, create a subdomain e.g.

Extract the zip file then upload the full contents, using FTP or similar, to your site into the directory you have created on your web server.

To preview the console, it needs to be served from a web server - not run locally due to browser security reasons. So, in a browser navigate to your newly created Radioplayer directory and you should see the console. Playback will start within 10 seconds. If it looks broken or there are assets missing, check that you have uploaded the full contents of the zip file including sub-directories.

Step 4: Submitting your web console for checks