GnuMP3d is a streaming music server. It streams MP3 and Ogg files into a network. It is possible to play those streams with mediaplayers like VLC, WinAMP, XMMS, and many more. Additionally, use it as a database with a search function for the music files.

Setup GnuMP3d

GnuMP3d searches for music in the directory /var/mp3 on the IPFire, so files must be stored there. You also may create a symlink in /var/mp3 to the music directory with:

ln -s /source /destination

Update the index

If you copy/link new files/folders into the music directory, just do a


on the console to update the index. The new files can then be found via the search function.

Use GnuMP3d

Gnump3d has its own webinterface which can be accessed via http://ip-ipfire:8888.

  • music - The directory tree, shows the original directory from /var/mp3**)
  • tagbrowse - Sort by artist, title, year und genre)
  • playlist - Produces playlist from several files)
  • random - Generates random playlists or select a random folders)
  • prefs - Adjustments for the appearance of the webinterface)
  • search - Full text search in the database)
  • stats - Statistics of the database and shows which tracks are playing now)

Make GnuMP3d accessible from outside with a password

Heres a small guide to access the gnump3d from outside (internet); with a password protection by the mod_proxy module of the Apache.

  • Download the file "gnump3ddpw.conf" from here and copy it into /etc/httpd/conf/vhosts.d/ on the IPFire.
  • than create the user over the command line

htpasswd -c /etc/gnump3d/gnump3d.user user1

create the first user (replace user1 with you desired user name). The password dialog will follow.

  • with

htpasswd /etc/gnump3d/gnump3d.user user2

(without the -c you can create more users, if needed)

  • Then update /etc/gnump3d/gnump3d.conf on the IPFire:
use_client_host = 0                   # is rather far down in that config and is out-commentated!
host_rewrite = externalurl:8889       # replace external URL by your dyndns name or IP
  • After this modification you should restart apache and gnump3d with the following commands:

Restart Apache with
/etc/init.d/apache restart
Restart Gnump3d with
/etc/init.d/gnump3d restart

and test it.

  • You need to open the port (8889) and may close the old one (8888).

This nice function was enabled by Arne F.!! Thanks again here.

Add Album Cover to GnuMP3d

In order to disply the album cover on the webpage the following changes have to be done

  • Open gnump3d config file
nano /etc/gnump3d/gnump3d.conf
  • Replace this line
directory_format = <tr><td width="10%">&nbsp;</td><td><a href="$LINK">$DIR_NAME</a>$NEW</td><td>$SONG_COUNT</td><td>$DIR_COUNT</td><td>[$RECURSE]</td></tr></a>
  • with this
directory_format = <tr><td><a href="$LINK"><img src="$LINKfolder.jpg" width="100" height="100" border ="0" alt="image not found"></a></td><td><a href="$LINK">$DIR_NAME</a>$NEW</td><td>$SONG_COUNT</td><td>$DIR_COUNT</td><td>[$RECURSE]</td></tr></a>
  • restart the application
/etc/init.d/gnump3d restart

Note the PRECONDITION is that the album covers have the name "folder.jpg".

The result looks like this