September 4, 2019

Generating Icecast metadata from RTMP

Nimble Streamer can re-package incoming RTMP stream into outgoing Icecast stream, it's part of our extensive audio streaming feature set.
RTMP protocol has the ability to carry Icecast metadata and encoders like Omnia Z/IPStream X/2StreamS Live Legacy Encoder and some others may produce this kind of streams.
So Nimble Streamer can pass that metadata from RTMP input to Icecast output.

If you need to process the input RTMP Icecast metadata for further use in Icecast, you need to enable this capability on server or per-application level. If you want to pass the RTMP Icecast metadata through Live Transcoder, you also need to enable it.

To enable the feature globally for entire server, go to Nimble Streamer / Live streams settings menu to open the setup page and choose the required server from the drop-down list. By default, the Global tab will be opened. Here you need to select Icecast protocol to have it in the output. This will show Generate Icecast metadata checkbox which you also need to select as shown below.

If you'd like to define this separately for specific application then choose Applications tab. Click on existing application's settings or click on Add application settings button to create a new one. Its settings will be similar to those described above so you need to select Icecast among protocols and click Generate Icecast metadata checkbox.

Once you save settings and re-start your input RTMP stream, the streams in the affected applications will have the Icecast metadata. You can use it as part of Icecast streaming or for passing through Transcoder scenarios.

Notice that RTMP output streams will have the Icecast metadata regardless or the described setting. This means that if you re-publish such RTMP stream or make it available for further pulled, it will have the Icecast metadata. However if you decide to transcode the stream and keep the Icecast metadata, you'll have to follow this setup process.

Also notice the Icecast metadata ingest via Nimble API which allows using RTMP is further processing and transfer.

Contact us if you have any questions regarding any of our features.

Related documentation

Live Transcoder for Nimble StreamerAudio streaming feature setRTMP support