= hellanzb =

'''hellanzb has ~~not~~ been abandoned, although the last release (0.13) is considered stable by the developers and testing team. Continued development is largely on an as needed basis.'''


[http://sabnzbd.org/ sabnzbd] might be a good alternative.

{{{
#!html
 <a href="http://www.giganews.com/?a=hellanzb"><img
    style="float:right; margin:0 0 10px 10px;cursor:pointer; cursor:hand;width: 160px; height: 235px;"
    src="http://www.giganews.com/banners/hellanzb/gn_small_banner.gif"
    alt="Giganews Newsgroups" /></a>

hellanzb is a <a class="ext-link" href="http://www.python.org/"><span class="icon">Python</span></a> application designed for *nix environments that retrieves <a class="wiki" href="/trac/hellanzb/wiki/nzb">nzb</a> files and fully processes them. The goal being to make getting files from Usenet (e.g.: <a href="http://www.giganews.com/?a=hellanzb">Giganews Newsgroups</a>) as hands-free as possible. Once fully installed, all thats required is moving an nzb file to the queue directory. The rest; fetching, par-checking, un-raring, etc. is taken care of by hellanzb.
}}}



hellanzb also will send notices of when it has completed a file or encountered an error via [http://growl.info/ Growl].

'''hellanzb 0.13 has been released! [March 26 2007]

{{{
#!html
<!--
'''hellanzb 0.12 has been released! [February 19 2007]

'''hellanzb 0.11 has been released! [January 29 2007]

'''hellanzb 0.10 has been released! [November 13 2006]

'''hellanzb 0.9 has been released! [March 24 2006]

'''hellanzb 0.8 has been released! [December 26 2005]

'''hellanzb 0.7 has been released! [September 18 2005]

'''hellanzb 0.6 has been released! [June 30 2005]

'''hellanzb 0.5 has been released! [May 26 2005]
-->
}}}

The latest stable releases of hellanzb are available from http://www.hellanzb.com/distfiles/.



Enjoy!

''KnowledgeTap Development Group''

'''Note: To prevent spam bots, you must now login as guest/guest to create or modify tickets. After logging in, you may modify the "Your email or username" field in the new ticket page.'''
'''Note further: When submitting a bug we would REALLY REALLY appreciate if you included your email so that we can get further information from you if we need it.'''

== Supported Platforms ==
hellanzb officially supports:
 * FreeBSD (via a supplied FreeBSD port file)
 * OS X (via a supplied Darwinports dport file)
hellanzb should work on any UNIX platform ([wiki:HellanzbOnWindows Windows notes: click here)], but installing it via the stable releases of the port/dport (NOT -trunk releases) on the supported platforms is by far the easiest and most surefire way to use hellanzb. M$ Windows is NOT supported.

== Features ==
 * Downloads and post processes your archives all for you. Post processing automatically takes place in the background while hellanzb continues downloading the next archive in your queue!

 * Configurable queue (like nzbq and similar apps), allows on the fly (during download) organization to the queue, operations such as:
    * arranging the order of your download queue
    * force downloading of a file in your queue (postponing the current download)
    * pause/continue/cancel the current download
    * all remote operations are also available as [wiki:XmlRpc XML-RPC calls]

 * Extremely quick, low CPU usage, integrated Usenet retriever built on twisted
    * for those with multiple usenet servers, supports automatic failover. Multiple server pools (defineServer lines) can automatically requeue articles totally missing from their respective servers for redownloading on other server pools
    * supports bandwidth throttling
    * automatically reconnects and anti idles NNTP connections

 * Hella smart post processor, automatically handles:
    * par2/par1 verification and repair (can handle archives with multiple par file sets)
    * unraring (can handle archives with multiple rar sets)
    * joining split .ts files and files split via hjsplit and similar tools
    * configurable music decompression via external cmd line apps. can spawn multiple decompress processes (especially handy for multi processor/SMP servers)
    * picks up post processing where it left off (if canceled due to exiting the program/CTRL-C) after restarting hellanzb
    * post processes all sub directories
    * and optionally deletes all processed files after successful post processing (like rars and pars)

 * Supports using a faster C based yDecoder (optional). Requires yEnc module for python, available from: http://www.hellanzb.com/hellanzb-content/yenc-0.3.tar.gz

 * Supports downloading NZBs with the specified msgid from http://www.newzbin.com 

 * Mac OS X Growl notification support (http://www.growl.info)

 * Linux [http://www.galago-project.org/news/index.php libnotify] notification support

 * Can optionally log its status to a log file, with automatic rollover & cutoff

 * Can optionally run as a daemon process

 * Fast Web UI via HellaHella with bookmarklet's for '''one-click downloading at newzbin'''

 * Automated Episode Downloading with [http://pads.piesweb.co.uk/ PADS] or other Automated Episode Downloaders (see below)

== Screenshots ==

{{{
#!html
<table border='0' cellspacing='1' cellpadding='1' style='background-color: white'>
<tr>
    <td valign='bottom' align='center' style='font-size: 10px' width='175px'>
        <a href="http://www.hellanzb.com/hellanzb-content/images/hellanzb-0.5-pre_ss_01.png"><img src="http://www.hellanzb.com/hellanzb-content/images/hellanzb-0.5-pre_ss_thumb_01.png"/></a><br/><b>hellanzb v0.5-pre starting up with Mac OS X Growl notifications</b>
    </td>
    <td valign='bottom' align='center' style='font-size: 10px' width='15px'>
    <td valign='bottom' align='center' style='font-size: 10px' width='175px'>
        <a href="http://www.hellanzb.com/hellanzb-content/images/hellanzb-0.5-pre_ss_02.png"><img src="http://www.hellanzb.com/hellanzb-content/images/hellanzb-0.5-pre_ss_thumb_02.png"/></a><br/><b>hellanzb v0.5-pre CTRL-C delayed because of background post processing</b>
    </td>
    <td valign='bottom' align='center' style='font-size: 10px' width='15px'>
    <td valign='bottom' align='center' style='font-size: 10px' width='175px'>
        <a href="http://www.hellanzb.com/hellanzb-content/images/hellanzb-0.5-pre_ss_03.png"><img src="http://www.hellanzb.com/hellanzb-content/images/hellanzb-0.5-pre_ss_thumb_03.png"/></a><br/><b>hellanzb v0.5-pre second CTRL-C kills the background work and exits</b>
    </td>
    <!--
    <td valign='bottom' align='center' style='font-size: 10px' width='175px'>
        <a href="http://www.hellanzb.com/hellanzb-content/images/hellanzb-0.5_ss_01.png"><img src="http://www.hellanzb.com/hellanzb-content/images/hellanzb-0.5_ss_thumb_01.png"/></a><br/><b>hellanzb v0.5-pre starting up with Mac OS X Growl notifications</b>
    </td>
    -->
</tr>
</table>
}}}

== hellanzb related apps ==

=== Web Interfaces ===
 * [http://github.com/krunk/hellaruby/tree/master HellaRuby] (a merb/ruby framework interface)

 * [http://hellanzb.com/trac/hellanzb/wiki/HellaHella hellahella] (pylons web interface)

 * [http://www.buks-island.org/statics/projects/wp-hellanzb wp-hellanzb] (Wordpress web interface)

 * [http://zussaweb.mijnflat.net Zussaweb] PHP based web interface for the hellanzb program (updated).

 * [http://cheezyblog.net/software/hellaworld HellaWorld] (An alternative PHP web interface)

 * [http://github.com/leedo/hellasmella HellaSmella] (perl web interface with newzbin integration, uses catalyst framework)

 * [http://zeus.dogtoe.com/projects/hellaphp/ HellaPHP] (Another alternative PHP web interface that takes the minimalistic approach)

=== Browser/Program Extensions ===

 * [http://home.parse.nl/~michiel/hellanzb-widget Hellanzb Widget for Apple Dashboard] (broken by Safari 3.1.2 update)

 * [http://www.npike.net/?q=node/55 Yahoo! Konfabulator: hellaNZBMonitor]

 * [http://z0g.org/hellafox/ hellafox] firefox extension

 * [http://www.tiberious.org/wiki/index.php/Nzbirc NZBirc] (irc interface, for hellanzb, newzbin and tvrage, also does automatic tv downloading)

 * [http://ashysoft.wordpress.com/ HellaScreenlet] (Screenlet (screenlets.org))

 * [http://code.google.com/p/to-hella-nzb/ toHellaNZB] (A simple Mac OS X download helper to move NZB's to the daemon.queue directory.)

=== GUIs ===

 * [http://www.lottanzb.org LottaNZB] (A GTK front-end)

 * [http://sourceforge.net/projects/hellagui hellaGUI] (Another GTK front-end)

 * [http://www.gtk-apps.org/content/show.php/myHella?content=69738 myHella] (a GTK front-end also written in Python)

 * [http://sourceforge.net/projects/cocoahellanzb/ CocoaHellanzb] (A Cocoa front-end for Mac OS X)

=== Automated Episode Downloaders ===
 * [http://code.google.com/p/hellavcr/ hellaVCR] (PHP driven TV show downloader that integrates with hellanzb, newzbin, tvrage and thetvdb)

 * [http://pads.piesweb.co.uk/ PADS] (TV Show downloader which uses MYEpisodes/Newzbin)

 * [http://aaron.gy/stuff/floamtv floamtv.py] (Python TV Show downloader that uses TVRage/Newzbin)

 * [http://sourceforge.net/projects/prenominalnzb PrenominalNZB] (Perl TV Show downloader using TVRage/Newzbin)

 * [http://www.nzbivo.info/ NZBivo] (Perl TV Show downloader using TVRage/Tvnzb)

 * [http://ashysoft.wordpress.com/ Leechr] (Python TV Show downloader that uses MyEpisodes/NewzLeech)

 * [http://www.tiberious.org/wiki/index.php/Nzbirc NZBirc] (irc interface, the original TV show downloader that uses TVRage/Newzbin)

=== Other ===

 * [http://code.google.com/p/helladroid/ HellaDroid] - Android HellaNZB client (using XMLRPC), can also search on Newzbin and add results to queue

 * [http://blog.buckrobinson.com/info/hellanzb-iphone-ipod-touch-interface-hellaphone/ HellaPhone] (Hella comes to iPhone !)

 * [http://alex.foxybanana.com/fvwmscriptmux.html FvwmScriptMux] HellaNZB status using fvwmscript GIT: [http://git.geekfire.com/?p=FvwmScriptMuxer.git;a=summary]

 * [http://reiterator.net/doku.php?id=hellaconk HellaConk] (Python script to show HellaNZB status in conky)
 
 * [http://github.com/amazingsyco/fightclub/tree/master FightClub] Cocoa library to acces HellaNZB servers on Mac/iPhone (for developers)

 * [http://hellatweet.mikeheijmans.com/ HellaTweet] A ruby script to update a twitter feed

 * [http://ashok.org.uk/code/hella/ hella curses] A very simple curses/terminal interface

== Prerequisites ==
''(FreeBSD and OS X ports/dports will install these for you)''
 * [http://twistedmatrix.com/ twisted] -- twisted (the networking stack hellanzb runs on top of) version 2.0 or greater *and*
 * [http://twistedmatrix.com/projects/web twisted web] -- twisted web module
 
     OR
     
 * [http://twistedmatrix.com/ twisted] -- twisted version 1.3    

You will want the command line (CLI) versions of the following: [[BR]]
 * [http://www.rarsoft.com/ rar (or unrar)] -- rar extraction tool
 * [http://parchive.sourceforge.net/ par2cmdline] -- par/par2 Parity checker

'''Optional'''
 * [http://www.monkeysaudio.com/ mac] -- Monkey Audio decoding
 * [http://flac.sourceforge.net/ flac] -- Free Lossless Audio Codec decoding

=== Growl Support (Optional) ===
{{{
#!html
<p>
    <a href="http://www.growl.info"><img src="http://www.hellanzb.com/images/growl.jpg"/></a>
</p>
}}}
 * [http://www.growl.info/ Growl] -- Mac OS X Graphical notifier. Requires version 0.7.2 or later

== Developer Resources ==
[[Image(http://www.hellanzb.com/hellanzb-content/anim-daemon.gif)]]
 * [http://www.hellanzb.com/trac/wiki/DeveloperNotes DeveloperNotes] -- Some notes on hellanzb development 

 The code is available from:

  http://github.com/pjenvey/hellanzb

Use the following command to clone the repository:

  ''git clone git://github.com/pjenvey/hellanzb.git''
  
== Where to get help ==
 * [http://hellanzb.com/hellanzb-content/INSTALL_hellanzb_OSX.txt INSTALL_hellanzb_OSX.txt] Installing the latest hellanzb on OS X walkthrough
 * [http://www.hellanzb.com/trac/file/trunk/README Latest README file] (Browse [http://www.hellanzb.com/trac/browser/tags/ SVN tags] for a specific version)
 * [http://www.hellanzb.com/trac/report Bug tracking System]
 * IRC - irc.freenode.net, #hellanzb

== Donations ==
Please support open source software, thanks!
{{{
#!html
<p><b>Donate using PayPal:</b>
<form action="https://www.paypal.com/cgi-bin/webscr" method="post">
<input type="hidden" name="cmd" value="_s-xclick">
<input type="image" src="https://www.paypal.com/en_US/i/btn/x-click-but21.gif" border="0" name="submit" alt="Make payments with PayPal - it's fast, free and secure!">
<input type="hidden" name="encrypted" value="-----BEGIN PKCS7-----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-----END PKCS7-----
">
</form>
<div style="width:480px; border: 1px solid #DDDDDD; text-align: center;
 background: #FFFFFF; padding: 5px; font:12px verdana;">
 <b><a href="http://www.giganews.com/?a=hellanzb">Unlimited and
  Uncensored Usenet Service</a></b><br />
 240 days binary retention, Unlimited Access, 99%+ Completion!<br />
 Signup for Giganews' free trial account and try for yourself.<br />
<b><a href="http://www.giganews.com/?a=hellanzb">www.giganews.com</a>
</b><img src="http://www.giganews.com/images/rpp.gif?token=hellanzb" />
</div>
}}}

=== Disclaimer ===
It is absolutely '''not the intent''' of the hellanzb developers that this software be used for downloading copyrighted content. Be nice.