Pairing with Remote on iPod/iPhone
forked-daapd can be paired with Apple's Remote application for iPod/iPhone;
this is how the pairing process works:
- start forked-daapd
- start Remote, go to Choose Library, Add Library
- prepare a text file with a filename ending with .remote; the filename
doesn't matter, only the .remote ending does. This file must contain
two lines: the first line is the name of your iPod/iPhone, the second
is the 4-digit pairing code displayed by Remote.
If your iPod/iPhone is named "Foobar" and Remote gives you the pairing
code 5387, the file content will be:
- move this file somewhere in your library
At this point, you should be done with the pairing process and Remote should
display the name of your forked-daapd library. You can delete the .remote file
once the pairing process is done.
If Remote doesn't display the name of your forked-daapd library at this point,
the pairing process failed.
This will usually be because the .remote file did not contain the correct name
or pairing code. Start over the pairing process and try again.
If in doubt, enable a more verbose level of logging and check that forked-daapd
receives the mDNS announcement from your iPod/iPhone when the pairing code is
displayed by Remote (you can also use avahi-browse for this purpose, see below).
If not, you have a network issue and mDNS doesn't work properly on your network.
If you are unsure about your iPod/iPhone's name, here's how you can check for
the correct value:
- in a terminal, run avahi-browse -r -k _touch-remote._tcp
- start Remote, goto Choose Library, Add Library
- after a couple seconds at most, you should get something similar to this:
+ ath0 IPv4 59eff13ea2f98dbbef6c162f9df71b784a3ef9a3 _touch-remote._tcp local
= ath0 IPv4 59eff13ea2f98dbbef6c162f9df71b784a3ef9a3 _touch-remote._tcp local
hostname = [Foobar.local]
address = [192.168.1.1]
port = 
txt = ["DvTy=iPod touch" "RemN=Remote" "txtvers=1" "RemV=10000" "Pair=FAEA410630AEC05E" "DvNm=Foobar"]
The name of your iPod/iPhone is the value of the DvNm field above. In this
example, the correct value is Foobar.
Hit Ctrl-C to terminate avahi-browse.