Hocuspucus is a small and extensible webserver for controlling key Linux
apps remotely via a browser. This means you can adjust the audio volume,
change playlists, etc. from any browser, including the one in your mobile
phone or tablet.


Homepage: http://muth.org/Robert/Hocuspocus
Code:     http://code.google.com/p/hocuspocus/

Prerequisites
=============

Hocuspocus' only prerequisite is the tornado library v2.3 -- older versions
may work as well but have not been tested -- and a recent
Python (2.6 or later) installation.

You can install the tornado library by running

make install_tornado


Additional dependencies are introduced by the various plugins
and will be reported upon launch.


Launching
=========

After the prerequisites have been met, simply run

./hocuspocus.py


Configuration and Customization
===============================

Most of HocusPokus' configuation can be controlled by editing

hocuspocus.conf


Running Headless
================

Besides regualar desktop system, hocuspocus is also suitable for
headless system.


FAQ
===

Q: What about authentication?
A: NYI