One thing I forgot to mention about Newsgroups is the SPEED. These form of downloading is so much faster than using any other P2P form due to the way it works.
Anyway, follow this carefully, I did have issues, and couldn't get it to work the first time I tried. Let me know if you have any questions about the install. Next blog will share some widgets and other items that will add to your newsgroup downloading experience.
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!
(to do this just type hellanzb.py and press return. You need to leave terminal running for this to continue to work. However next post will be about using widget terminal windows instead.)