iTunes server (forked-daapd)

Please note that forked-daapd does not currently work with Apple Remote 3

This page is intented for people who want to run an itunes server on their OpenWrt device, controlling it via Apple Remote on iPod Touch/iPhone/iPad. You’ll need a device with good cpu/memory. The device will probably also need attached USB storage. Your USB storage must have your music library, and it must also be set up so that custom packages will be installed on it. See extroot for more information about that.

OpenWrt currently offers the package mt-daapd, which is also an iTunes server, but which doesn’t support Remote and which is unmaintained. forked-daapd is a rewrite by Julian Blache. Here’s how to get it up and running.

Pre-built packages (currently only for trunk and ar71xx)
  1. Edit /etc/opkg.conf and add:
    src/gz forked-daapd http://www.gyfgafguf.dk/openwrt/packages/ar71xx
  2. Run
    opkg update
    opkg install forked-daapd

If you can't install this package because a dependency failed, try to use this instead:

opkg --force-depends install forked-daapd
If you use "–force-depends" you must check afterwards that you have the following packages installed and working: libgcrypt, libunistring, libevent, libantlr3c, confuse, alsa-lib, libffmpeg-full, mxml, libavl, libavahi-client, avahi-daemon, sqlite3-cli

Building yourself
  1. Read about building your own packages with SDK here: Using the SDK

Running forked-daapd

Edit /etc/forked-daapd.conf. Set the path to your music library and set the path to the forked-daapd database. Start the server by running "/etc/init.d/forked-daapd start”. The server should now start scanning your library. You can check /var/log/forked-daapd.log if you want to see what is going on. To stop forked-daapd run “/etc/init.d/forked-daapd stop”. If the server is not starting make sure avahi-daemon and dbus are running.

More instructions, like how to get Remote working, are available in this readme.

Bugs (or: please help fix these!)

  1. does not work with Apple Remote 3, so the package is currently not much use
  2. libunistring is built without libiconv-full, which means UTF8-conversions don’t really work.
  3. forked-daapd will crash if your music library is on a FAT-partition which is not mounted with the correct codepage.

Notes

This is third-party software, use at own risk. If you have trouble with these packages, or if you can contribute, please discuss in this thread: https://forum.openwrt.org/viewtopic.php?id=30302

Back to top

inbox/howto/forked-daapd.txt · Last modified: 2013/05/20 19:42 by ejurgensen