Initial commit

LICENSE

@@ -0,0 +1,26 @@
+Copyright (c) 2011, Per Rovegård <per@rovegard.se>
+All rights reserved.
+
+Redistribution and use in source and binary forms, with or without
+modification, are permitted provided that the following conditions
+are met:
+1. Redistributions of source code must retain the above copyright
+   notice, this list of conditions and the following disclaimer.
+2. Redistributions in binary form must reproduce the above copyright
+   notice, this list of conditions and the following disclaimer in the
+   documentation and/or other materials provided with the distribution.
+3. Neither the name of the authors nor the names of its contributors
+   may be used to endorse or promote products derived from this software
+   without specific prior written permission.
+
+THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
+AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
+IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
+ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
+LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
+CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
+SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
+INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
+CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
+ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
+POSSIBILITY OF SUCH DAMAGE.

README

@@ -0,0 +1,68 @@
+airpnp 0.1
+18 Jul 2011
+README
+=================
+
+Airpnp is a simple server that acts as a bridge between AirPlay devices (such as
+the iPhone or the iPad) and regular UPnP media renderers. Its mode of operation
+can be summarized as follows:
+
+* When running, detects UPnP devices on the network through M-SEARCH discovery
+  and notification monitoring.
+* For each MediaRenderer found, publishes an AirPlay service with the
+  corresponding name.
+* Converts incoming AirPlay commands to UPnP control messages which are sent to
+  the media renderer.
+
+The software is based on totem-plugin-airplay version 1.0.2, which is included.
+The server parts have been rewritten to use Twisted-based networking. The
+official home for the plugin is:
+
+     http://cgit.sukimashita.com/totem-plugin-airplay.git/.
+
+The software also uses UPnP code from pyupnp, which is included. The official
+home for pyupnp is:
+
+    http://code.google.com/p/pyupnp/
+
+
+Dependencies
+------------
+The code has been tested with Python 2.7, but probably works with some earlier
+2.x versions as well.
+
+External dependencies include Twisted and ElementTree.
+
+
+Installation
+------------
+There is currently nothing to install. Simply change to the airpnp directory
+and run:
+
+    python airpnp.py
+
+To run unit tests, run the following from the top-level directory:
+
+    python run_tests.py
+
+
+Contact Information
+-------------------
+Author: Per Rovegård
+Internet: http://airpnp.finkod.se
+E-mail: airpnp@finkod.se
+
+
+Copyright and Licensing
+-----------------------
+Pyupnp is licensed using the 3-clause BSD license. Totem-plugin-airplay is
+licensed using the MIT license. Airpnp as a whole is licensed using the
+3-clause BSD license.
+
+See the file LICENSE for the full license text.
+
+Changelog
+---------
+Version 0.1:
+First public release
+