diff --git a/README b/README index f6572748..dee9c075 100644 --- a/README +++ b/README @@ -27,6 +27,60 @@ A single forked-daapd instance can handle several clients concurrently, regardless of the protocol. +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: + + Foobar + 5387 + + - 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 = [49160] + 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. + + Supported formats -----------------