-------------------------------------------------------------------------
---- hellanzb-0.10 installation for stupid^H^H^H^H^H^H Mac OS X users ----
-------------------------------------------------------------------------

Step 0) Install Apple's Xcode Developer Tools
Install Xcode, available from http://developer.apple.com/tools/xcode/

(Xcode is required for the GCC compiler that accompanies it)

Step 1) Install DarwinPorts
----------------------------------------
(NOTE: These instructions are tailored for DarwinPorts 1.0. If installing a later version
of DarwinPorts, please refer to its README file to complete its installation.

These instructions also assume you are using Mac OS X 10.3 or later)

Get the DarwinPorts 1.0 .dmg from:

http://www.darwinports.org/getdp/

Open the .dmg, double click on the Installer and follow the instructions to install
DarwinPorts

Open Terminal.app (Applications/Utilities/Terminal.app)

Run the following commands in Terminal.app:
   
    touch ~/.profile

    open -a TextEdit ~/.profile

This will open the file .profile in your home directory for editing in TextEdit

In TextEdit, add the following line to the end of .profile:

export PATH=$PATH:/opt/local/bin

Save the file and quit TextEdit
Quit Terminal.app

DarwinPorts is now installed


Step 2) Update DarwinPorts
----------------------------------------
Open Terminal.app (Applications/Utilities/Terminal.app)

You MUST be using a NEW Terminal.app window from the last step, to utilize the changes
made to your .profile

Run the following command in Terminal.app:

    sudo port -d selfupdate

(You must enter your password when prompted)


Step 3) Install hellanzb via DarwinPorts
----------------------------------------
Run the following command in Terminal.app:

    sudo port install hellanzb

(You must enter your password when prompted)

This will trigger the installation of hellanzb. It may take some time, especially on G4
processors, as hellanzb and its dependencies are compiled and installed


Step 4) Configuring hellanzb
----------------------------------------
Before using hellanzb, you must edit its configuration file. Open hellanzb's configuration
file in TextEdit, run the following command in Terminal.app:

    open -a TextEdit /opt/local/etc/hellanzb.conf

The only configuration file options you should worry about changing are:

o The entire defineServer section
o Hellanzb.PREFIX_DIR
o Hellanzb.QUEUE_DIR (If you want, see below)
o the defineMusicType lines (see below)


A good location for your 'Hellanzb.PREFIX_DIR' is your home directory, E.g.:

Hellanzb.PREFIX_DIR = '/Users/grandma/'

(Don't forget the trailing slash in Hellanzb.PREFIX_DIR!!)


In Mac OS X, Safari will automatically download NZB files when you click on newzbin.com's
'Get Message-ID' button. It is recommended that you set hellanzb's 'Hellanzb.QUEUE_DIR' to
your Safari Downloads directory. hellanzb will then automatically pick up whatever NZB you
download. E.g.:

Hellanzb.QUEUE_DIR = '/Users/grandma/Desktop/Downloads/'


Mac OS X support for .flac and .shn is lacking. Uncomment (by removing the preceeding '#'
character) the following two lines in your configuration file and hellanzb will
automatically decompress these formats to iTunes compatible .wav:

defineMusicType('flac', 'flac -d <FILE>', 'wav')
defineMusicType('shn', 'shorten -x < <FILE> > <DESTFILE>', 'wav')


Step 5) And Finally
----------------------------------------
Please also refer to hellanzb's README file for more information.
This is available from:
http://www.hellanzb.com/trac/file/tags/0.10/README

Once you've read the README, simply run:

    hellanzb.py

in a Terminal.app window to start hellanzb!

You're on your own for getting Growl setup ;]