= hellahella Web Interface =

The hellahella web interface is written using a new Python framework called [http://pylons.groovie.org/ Pylons]. A official release of hellahella is not currently available, however the development version is quite stable and is being used extensively on a variety of platforms.

If you were previously using the Rails version of hellahella, its highly suggested that you upgrade as the new version is:

 * Faster
 * Consumes less CPU resources
 * Can use the force option to change the actively downloading nzb
 * Doesn't have a flamingly lame theme (More theme options would be great, please email/irc us with them!)

== Requirements ==

 * Python >= 2.4 (Some reports of it working properly on Python 2.3 as well)
 * [http://subversion.tigris.org/ Subversion] 

== Installing ==

 * Download [http://peak.telecommunity.com/dist/ez_setup.py] if you don't have setuptools (easy_install) available already
 * Install hellahella:
    * {{{ sudo python ez_setup.py -U hellahella==dev }}}

'''Note:''' When you want to upgrade hellahella, run {{{ sudo easy_install -U hellahella==dev }}}

== Configure ==

 * Create a config file with {{{paster make-config hellahella hella.ini}}}
 * Edit the hella.ini file
    * Set the nzb_server information as appropriate (Bad things happen if hellanzb is not running, or this information is wrong)
    * Set the username/password to what you'd like to use to login
    * Set the cache_dir (Leaving it the same will just create that directory wherever you happen to start the server from)
    * Change the port/ip binding if desired

== Setup Hellahella ==

Tweak the config file as appropriate and then setup the application::
 * {{{ paster setup-app hella.ini}}}
''Note: hellahella versions before r918 may emit this harmless warning during setup-app:

'' "No ez_setup.websetup module found for setup"

'' Either ignore it and proceed with the installation, or upgrade to the latest hellahella to avoid this message

After this is performed proceed to starting hellahella
== Run ==

To start hellahella with your conf file:

 * {{{ paster serve hella.ini }}}

The {{{ paster serve }}} command has a variety of options to make it easy to run as a daemon, change the pid file, log file, etc. For a full list of options:

 * {{{ paster serve -h }}}

Enjoy!

== FAQ ==

 * I can't run {{{ paster/easy_install }}}, it says they're not found!
    * You're likely running OSX, which puts Python shell scripts in odd locations. Check the messages from the ez_setup install to see where easy_install was copied to, and add that directory to your path
 * There's an {{{ Error(Protocol Error): ... xmlrpclib.py }}}
    * This will occur if hellanzb is not running, or hellahella is unable to contact and login. Ensure that your nzb_server settings are accurate and that hellanzb is running.