Our web player can be embedded on any website adding simple HTML
Important: Our web player requires an
HTTPS enabled website.
We have various embeddable web players available:
|Episode player||Embeds a single and specific podcast episode.|
|Show player||Follows a specific podcast show, displaying the latest available episode, with or without a playlist view to access older episodes in the show.|
|Publisher player||Follows all the podcast episodes from a specific publisher, displaying the latest available episode, with or without a playlist to access older episodes from the publisher.|
|Stream player||Embeds a single and specific radio live stream, with or without "Now playing" metadata and album artwork lookup.|
Getting the iframe code
The easiest, and recommended, method of embedding a player on your site is to paste the
iframe code as-is into your HTML. The code will look something like the following:
<iframe src="https://iframe.iono.fm/chan/123" width="100%" height="450" frameborder="0"><a href="https://iono.fm/c/123">Content hosted by iono.fm</a></iframe>
To get the embed code for a provider, show, episode or stream, visit it's page on our website, and then click the "Share" button.
This will trigger a drawer that shows the default iframe code and also a button that allows customisation of the player.
Customizing the web player
Our embeds can be customised in various ways by adding one or more of the URL parameters. Our "Customise embed" tool provides a visual tool where these can be configured. Thery are:
|The width, in pixels, of the embedded control.|
|The height, in pixels, of the embedded control.|
|The layout to be rendered.|
|Enable the playlist component of the player. Only available on publisher ("provider") and podcast show ("channel").|
|Whether or not to include the episode description in the player.|
|The default quality profile of the player.|
|The language to be used for the player interface. Currently the following languages are supported:|
|Whether or not to show the sharing section component.|
|Whether or not to show cover art. Only available on streams, required valid "Now Playing" metadata.|
|Whether or not to render use a simple scroll area or audio waveforms.|
|Theme accent color as a hexadecimal code. Example: |
|Theme background color as a hexadecimal code. Example: |
|Theme border color as a hexadecimal code. Example: |
|Theme text color as a hexadecimal code. Example: |
|Theme rounded corners, must be a value between |
You can add iono.fm as an oEmbed provider on your WordPress blog by adding the following code to your theme's functions.php file.
wp_oembed_add_provider('#https?://(www\.)?iono\.fm/(p|c|e|s)/.*#i', 'https://embed.iono.fm/oembed', true);
You can find out more about embedding content in WordPress by reading this article.
Almost all desktop and mobile browsers support HTML5 audio, but for very old browsers our player will render a basic HTML4 fallback with only a direct link to open audio content.