streaming from your fileserver using mpd and icecast

Posted by Nico Golde in
Wednesday, March 26. 2008

My mobile music player is often missing the files I want to hear right now if I'm under way because my music collection is too big to fit on it.
Long time ago I used gnump3d which seems to be unmaintained in Debian for quite some time and then I often listened to some live streams, network connections are available nearly everywhere.
But I always wanted my own live stream with music I want to hear. There are several solutions out there for this task but they all require the creation of a playlist before the streaming starts.

Fortunately mpd provides the possibility to define different output targets and also one for streaming to a shoutcast or compatible server like icecast.

So after apt-get install mpd icecast2 (on a Debian box) you have to edit /etc/mpd.conf
There is not much to do, be sure to set music_directory to the place your music is located and the configure the output part.
Add the following to your mpd.conf and adapt some values:

audio_output {
type "shout"
name "foobar stream"
port "8000"
host "localhost"
format "44100:16:2"
mount "/stream.ogg"
password "somepass"
quality "2"
user "source"
}

The type defines that this output will be streamed to a shoutcast target. The name will be displayed by the client you use to play your stream. 8000 is the port icecast2 will listen on host "localhost" (in this example the icecast2 server is on the same host). format specifies the audio format of the stream, the first number is the sample rate in Hz, the second number is the number of bits per sample and the last number defines the number of channels (2 is stereo here). Those values should work for most of you. mount specifies the path under which the stream is available later from the server root, in this example http://localhost:8000/stream.ogg.
quality defines the ogg encoding "quality". You can also specify the bitrate instead of it. The user and password values are used to authenticate mpd at the source input for icecast2.

There seems to be a bug in the 0.13 release (which is also in Debian) of mpd that prevents this from working. I don't know the details about this bug but adding

audio_output {
type "alsa"
name "fake out"
driver "null"
}

fixes it.

Make sure to set START_MPD=true in /etc/default/mpd to enable mpd.
That's all that needs to be done for mpd.

The next step is to edit /etc/icecast2/icecast.xml.
The default configuration nearly ready to use. Configure the authentication part:

<authentication>
<source-password>somepass</source-password>
<admin-user>admin</admin-user>
<admin-password>someadminpass</admin-password>
</authentication>

The source password is the one we specified in the mpd configuration. This is needed to authenticate mpd with icecast. source is the default user name icecast uses here. Additionally we define an admin-user that can be used to add users to icecast later because we want to protect the stream by a username and a password.
Then set

<hostname>you.somehost.org</hostname>

.
This hostname is used to generate URLs in icecast that a user receives.

Because we want a very simple authentication for the stream we need to add some options for the mount (/stream.ogg):

<mount>
<mount-name>/stream.ogg</mount-name>
<max-listeners>1</max-listeners>
<authentication type="htpasswd">
<option name="filename" value="/etc/icecast2/htpasswd"/>
<option name="allow_duplicate_users" value="0"/>
</authentication>
<on-connect>/home/icecast/bin/stream-start</on-connect>
<on-disconnect>/home/icecast/bin/stream-stop</on-disconnect>
</mount>

I think the xml tags are pretty much self-explanatory. Keep in mind to set the filename to a location the icecast daemon has access to, that's why I used /etc/icecast2. Then you can add users with htpasswd or using the web interface on port 8000 and add a user there.

The last thing to do is to adjust the <alias source="/" dest="/status.xsl"/> setting. Change status.xsl to auth.xsl people need to authenticate if they connect to the web interface before seeing the stream information.

Now you can login via ssh on your home server and use your favorite mpd client to configure playlists on the fly, I use ncmpc for this. Of course the authentication is not secure, people who sniff your traffic can see your login data.
One thing to keep in mind is to restart mpd after restarting icecast otherwise mpd will hang and not continue to stream, this seems to be a bug.

After routing through your NAT, you should be able to play your stream via http://you.somehost.org:8000/stream.ogg.

Comments (5) - Trackbacks (0)

Defined tags for this entry: configuration, debian, icecast, mpd, music, software, streaming

Related entries by tags:

Trackbacks

Trackback specific URI for this entry

No Trackbacks

Comments

Display comments as (Linear | Threaded)

If you ever wanted to submit this entry, or entries like it to debian-administration they'd be more than welcome.

#1 Steve Kemp (Homepage) on 2008-03-27 01:09 (Reply)

i was not sure if my blog article would meet the quality standards of debian-administration, will submit next time.

#1.1 nion on 2008-03-27 19:26 (Reply)

I am doing such a thing in a different way. My central multimedia server at my home LAN is a vdr streamdev server. Because I sometimes need to watch TV or listen to radio somewhere away from my home LAN, is there a need to first stream the MPEG2 streams (standard TV/radio) and second to compress these into a more bandwidth saving format. The application of choice for this is vlc, since you can easily convert different input and output streams in all possible formats. VLC is available without X11 as package in some distributions.

If the connection to the home LAN is unreliable, then I have experienced that using a single-cast udp to the current location provides better throughput than having a direct connection to the multimedia server.
On the server:
vlc --intf dummy "$srcURIforstream" ":sout=#transcode{vcodec=h264,vb=$kbits,scale=0.5,threads=2,acodec=mp3,ab=32,channels=1}:duplicate{dst=std{access=udp,mux=ts,dst=udp://$IPofcurlocation:$port"

If the "method" is simply changed to "http" and the "dt" to the local listening URI, then vlc opens a HTTP stream server for that input stream to be output. "kbits" needs to be adjusted for the output rate, like "scale" too. All of this are the parameters for the bandwidth usage. "threads" is needed for mp4 encoding. On a simply 3.0Ghz PIV 110% CPU usage were shown by top, but exchanging the CPU to a Core2Duo helped reducing it to 60%.

The client is simply:

vlc udp://@:$port

or

vlc http://$homeLAN:$port

There are security issues with streaming the raw encoded data over the Internet, but for live data SSH is a bit too slow and wasting too much bandwidth, if you want to compress a 8Mbit/s MPEG2 stream through the 30kbit/s upload of a DSL line, in good PAL quality.

It's a cheap open source way to stream TV everywhere.

Sincerely,

Christoph

#2 Zwansch (Homepage) on 2008-03-27 19:21 (Reply)

there's a crucial typo in your examples;
driver "null"
this is wrong, and actually plays the sound out on the server machine through alsa
it should be;
device "null"

#3 S on 2008-05-19 16:57 (Reply)

are you sure? in the docs i read this is driver "null" and it works fine here

#3.1 nion on 2008-05-20 03:56 (Reply)

Add Comment

Name
Email
Homepage
In reply to
Comment	Enclosing asterisks marks text as bold (word), underscore are made via _word_. Standard emoticons like :-) and ;-) are converted to images. You can use [geshi lang=lang_name [,ln={y\|n}]][/geshi] tags to embed source code snippets. E-Mail addresses will not be displayed and will only be used for E-Mail notifications. To prevent automated Bots from commentspamming, please enter the string you see in the image below in the appropriate input box. Your comment will only be submitted if the strings match. Please ensure that your browser supports and accepts cookies, or your comment cannot be verified correctly. Enter the string from the spam-prevention image above: You can use [geshi lang=lang_name [,ln={y\|n}]][/geshi] tags to embed source code snippets.
	Remember Information?