--- a
+++ b/README
@@ -0,0 +1,35 @@
+upmpdcli: an UPnP front-end to the Music Player Daemon
+
+upmpdcli implements an UPnP Media Renderer, using MPD to perform the real
+work.
+
+It has been tested with a number of UPnP control points running on an
+Android tablet. Audionet and Bubble UPnP work best with it.
+
+How things work: 
+
+The Control Points uses the UPnP protocols to browse the tracks on the
+Media Server and choses URIs to be played. It then talks UPnP to umpdcli,
+which uses the mpd client protocol to place the URIs into the MPD
+playlist. mpd finally retrieves the data from the Media Server using HTTP.
+
+
+           [UPnP  Control  Point]
+            ^                  ^
+            |                  |
+          (UPnP)             (UPnP)
+            |                  |
+            V                  |
+        [upmpdcli]             |
+            ^                  |
+            |                  |
+      (MPD protocol)           |
+            |                  |
+            V                  V
+          [MPD]<--(HTTP)-->[UPnP Media Server]
+
+
+Each of the Control point, Media Server, mpd and upmpdcli processes can run
+on any network host, for example for mpd and upmpdcli to run on the same
+host.
+