iono.fm RSS namespace
  • 03 May 2021
  • 2 Minutes to read
  • Dark
    Light
  • PDF

iono.fm RSS namespace

  • Dark
    Light
  • PDF

Article summary

The page defines the "ionofm" RSS namespace used to insert additional metadata into our RSS feeds

Namespace declaration:

xmlns:ionofm="http://iono.fm/rss-namespace-1.0"

Namespace elements

Note that all the elements in this namespace is optional, and that any (or all) of them may be omitted from a response.

Image thumbnails

<ionofm:thumbnail href="http://url.to/thumbnail.png">

The thumbnail element provides a link to a small thumbnail of the related image. This applies to both the RSS <channel> element and it's child <item> elements. It's href attribute must contain a URL pointing to a 256x256 PNG image.

Cover Art

<ionofm:coverart href="http://url.to/coverart.png">

The coverart element provides a link to the art banner if set for content. This applies to both the RSS <channel> element and it's child <item> elements. It's href attribute must contain a URL pointing to a 1500x500 PNG image.

Object live-stream

<ionofm:stream>

The stream element provides links to any live-streams associated with a provider or a channel. It is valid within the RSS <channel> element or within <item> elements.

Child elements of this field is the list of available live-stream formats. Currently supported are:

  • streamname : the name of the live stream, to be used for retrieving other stream related metadata.
  • hls-aac : HLS stream containing AAC encoded audio.
  • ice-mp3 : Icecast stream containing MP3 encoded audio.
  • ice-aac : Icecast stream containing AAC encoded audio.

Each format element can specify up to 3 URL's for the low, medium and high quality version of the stream.

Not all streams support all quality levels! For example, "Community" stream packages only support 2 quality levels.

Example:

<ionofm:stream>
      <ionofm:streamname>stream_identifier</ionofm:streamname>
      <ionofm:hls_aac>
             <ionofm:low src="http://location.to.low.m3u8"/>
             <ionofm:medium src="http://location.to.medium.m3u8"/>
             <ionofm:high src="http://location.to.high.m3u8"/>
      </ionofm:hls_aac>
      <ionofm:ice_aac>
              <ionofm:low src="http://location.to.low.aac"/>
              <ionofm:medium src="http://location.to.medium.aac"/>
              <ionofm:high src="http://location.to.high.aac"/>
      </ionofm:ice_aac>
      <ionofm:ice_mp3>
             <ionofm:low src="http://location.to.low.mp3"/>
             <ionofm:medium src="http://location.to.medium.mp3"/>
             <ionofm:high src="http://location.to.high.mp3"/>
      </ionofm:ice_mp3>
</ionofm:hls>

Show end-time

<ionofm:endDate>Sun, 19 May 2002 15:21:00 GMT</ionofm:endDate>

This is related to the duration of an item and is used for mainly in the Stream metadata RSS to indicate the running time of upcoming items. This complies to the same RFC 822 value that is used for the standard RSS <pubDate> field.

Web player location

<ionofm:player_url>https://iframe.iono.fm/s/1</ionofm:player_url>

Optional field that provides a link to a web player instance for this object. Can apply to both the main channel object and any item objects in the feed. The link will point to an iframe web player capable of playing the object in question.

Currently playing metadata

<ionofm:metadata_url>https://edge.iono.fm/xmetadata/stream_name</ionofm:metadata_url>

This is an optional field that is populated when the stream has currently playing metadata associated with it.