Document the Remote pairing process

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
 -----------------