| | 1 | = Streaming to Icecast with roard and RoarAudio PlayList Daemon (rpld) = |
| | 2 | This tutorial is to tell you how to setup roard and RoarAudio PlayList Daemon to stream to a Icecast server. This does not cover installint Icecast itself nor using a diffrent RoarAudio server than roard. |
| | 3 | |
| | 4 | == Introduction and Concept == |
| | 5 | As you may already have noticed the name of RoarAudio PlayList Daemon (later rpld) contains the word PlayList. This name is chosen for a simple reason: In fact rpld is not audio player or something like that. It's a playlist manager build on top of the RoarAudio sound system. It does: |
| | 6 | * Handle playlists |
| | 7 | * Push data from files or streams in playlist to the sound server |
| | 8 | * It controls playback by passing control information between clients and sound server |
| | 9 | |
| | 10 | It does not: |
| | 11 | * Play back anything itself |
| | 12 | * Decode or encode audio |
| | 13 | |
| | 14 | However because clients never be in contact with the sound server this may sometimes look a bit like rpld be a full audio player. |
| | 15 | |
| | 16 | As rpld does not handle audio itself setup for streaming is done on roard's end. It is configured to have a so called 'output' to icecast and encoding as Ogg Vorbis. |
| | 17 | |
| | 18 | == Installation == |
| | 19 | Before we can start you need to install the following software: |
| | 20 | * roard from RoarAudio Package |
| | 21 | * rpld |
| | 22 | * vclt-tools |
| | 23 | |
| | 24 | If your operating system ships them we suggest you to use those versions and not compile your own binary. |
| | 25 | |
| | 26 | === Installing on Debian === |
| | 27 | Just type as root: |
| | 28 | # apt-get install roaraudio roarplaylistd vclt-tools |
| | 29 | |
| | 30 | === Installing from source === |
| | 31 | Note: This is a very brief description and may or may not be extended later. |
| | 32 | |
| | 33 | First go to http://roaraudio.keep-cool.org/downloads.html and download the packages listed above. |
| | 34 | |
| | 35 | Before you continue you should install the following stuff, too: |
| | 36 | * Essential packages for compiling (compiler, linker, make, system headers,...) |
| | 37 | * libvorbis |
| | 38 | * libshout |
| | 39 | * libuuid (from e2fsprogs) |
| | 40 | * vorbis-tools |
| | 41 | |
| | 42 | Don't forget to install the -dev or -devel packages. |
| | 43 | Some more libraries are listed in the READMEs for the packages. |
| | 44 | |
| | 45 | For all the packages the building is done like: |
| | 46 | $ tar -xvzf ''package''.tar.gz |
| | 47 | $ cd ''package'' |
| | 48 | $ ./configure |
| | 49 | $ make |
| | 50 | # make install |
| | 51 | |
| | 52 | == Setting up roard == |
| | 53 | |
| | 54 | == Setting up rpld == |
