wiki:rpld/StreamingOpus

Streaming Ogg Opus with RoarAudio PlayList Daemon (rpld) and SavannahIce

This mini Tutorial will tell you how to stream Ogg Opus with RoarAudio PlayList Daemon (later: rpld) and SavannahIce?. It does not go into details. See rpld/StreamingToIcecast for a more detailed tutorial.

Step 0: What do I need? OR: Installing software

What you need to complete this tutorial are the following software packages:

  • RoarAudio PlayList Daemon (>= 0.1.4)
  • SavannahIce?
  • vclt-tools (>= 0.1.3)
  • libroar (>= 1.0beta6)

It will also work with older versions but it is more complicated to set up so this is out of scope of this document.

If you are using packages from your OS please verify they match the required versions. Some systems (e.g. Ubuntu) has very outdated versions of the packages.

Step 1: Create a playlist

To do this run:

 $ dir2vclt --path-mode=absolute /path/to/opus/files/ /tmp/playlist.vclt

Replace the path with the path to your files.

Step 2: Setting up rpld

To do this we need to create a new store:

 $ rpld-storemgr --store-path ~/rpld-store/ create SavannahIce http://source:password@host:8000/mystream.ogg

The URL needs to be replaced with the data for your Icecast server.

step 3: Importing playlist

In order to import your playlist just use:

 $ rpld-storemgr --store-path ~/rpld-store/ import playlist vclt /tmp/playlist.vclt

step 4: Starting rpld

To start rpld just type:

 $ rpld-storemgr --store-path ~/rpld-store/ run --daemon --bind ~/.rpld --play

Step 5: Setting default pointer

The Default pointer is a rule to tell rpld what to play. We can now set it to the first entry of our playlist and rpld will play our playlist over and over again or set it to random playback.

To set it to the first entry just type:

 $ rpld-setpointer default num:0 playlist

For random playback we use:

 $ rpld-setpointer default random: playlist

Step 6: Hitting play

To start playback just use:

 $ rpld-ctl play

Restarting playback after reboot

To restart playback after reboot just do the same as described in step 4.

Final notes

  • The file /tmp/playlist.vclt can be deleted after import: rm /tmp/playlist.vclt
  • rpld saves it's state in ~/rpld-store/. If you no longer want to use rpld just delete this directory.
  • This tutorial also works for Ogg Vorbis, Ogg Speex and Ogg FLAC files.
  • Mixing files of different types/codecs/codec parameters may confuse (borken) players. You should avoid this.

Have fun

Now listen to your music and have a lot fun.

Last modified 12 years ago Last modified on 09/25/12 02:51:40