SABnzbd - The automated Usenet download tool
Python JavaScript CSS Other
Latest commit 28dd8f3 Jul 23, 2016 @shypike shypike Update translations
Failed to load latest commit information.
cherrypy Patch CherryPy 6.0.2 : Implement 301 redirection for http-->https Jul 5, 2016
email Email notification for failed URL fetches. Feb 25, 2012
gntp Remove warning about Growl when user has disabled message class in Gr… Sep 24, 2012
icons Create new ICO files Apr 22, 2016
interfaces Fix Notification Script and add Parameters-field (#629) Jul 19, 2016
licenses Add the module "six". Jul 13, 2016
linux Update Wiki-link Jun 30, 2016
osx Update unrar for OSX to 5.30 Nov 26, 2015
po Update translations Jul 23, 2016
sabnzbd Erase server error and warning when an article has been received. Jul 20, 2016
scripts Some pep8 cleanup (whitespace/docstring only), focus on root dir alon… Sep 23, 2015
six Add the module "six". Jul 13, 2016
solaris Adds solaris manifest May 9, 2014
tools Make NSIS file presence optional. Mar 20, 2016
util Some pep8 cleanup (whitespace/docstring only), focus on root dir alon… Sep 23, 2015
win Update 7zip for Windows to latest release and enforce 7zip format whe… May 15, 2016
.gitignore Support testing email based on values in UI instead of stored config. May 10, 2014
ABOUT.txt Update Wiki-link Jun 30, 2016
COPYRIGHT.txt Update to 2016. Jan 13, 2016
Dockerfile Add Dockerfile Nov 22, 2014
GPL2.txt Eliminate superfluous 'main' folder Mar 21, 2010
GPL3.txt Eliminate superfluous 'main' folder Mar 21, 2010
INSTALL.txt Update Wiki-link Jun 30, 2016
ISSUES.txt Update Wiki-link Jun 30, 2016
LICENSE.txt Update to 2016. Jan 13, 2016
PKG-INFO Update text file for 1.1.0RC2 Jul 20, 2016 Update Wiki-link Jun 30, 2016
README.mkd Add credit for XSS vulnerability discovery Jul 21, 2016 moved regex define before use (save memory when code branch isnt ran)… Sep 30, 2015 Require Python 2.7 only Jun 23, 2016
portable.cmd Make sure that the invoking window disappears Jul 13, 2016

SABnzbd - The automated Usenet download tool

This Unicode release is not compatible with 0.7.x queues!

There is also an issue with upgrading of the "sabnzbd.ini" file. Make sure that you have a backup!

Saved queues may not be compatible after updates.

SABnzbd is an Open Source Binary Newsreader written in Python.

It's totally free, incredibly easy to use, and works practically everywhere.

SABnzbd makes Usenet as simple and streamlined as possible by automating everything we can. All you have to do is add an .nzb. SABnzbd takes over from there, where it will be automatically downloaded, verified, repaired, extracted and filed away with zero human interaction.

If you want to know more you can head over to our website:

Resolving Dependencies

SABnzbd has a good deal of dependencies you'll need before you can get running. If you've previously run SABnzbd from one of the various Linux packages floating around (Ubuntu, Debian, Fedora, etc), then you likely already have all the needed dependencies. If not, here's what you're looking for:

  • python (We support Python 2.6 and 2.7)
  • python-cheetah
  • python-dbus
  • python-openssl
  • python-support
  • python-yenc
  • par2 (Multi-threaded par2 installation guide can be found here )
  • unrar (Make sure you get the "official" non-free version of unrar)
  • unzip
  • 7zip

Your package manager should supply these. If not, we've got links in our more in-depth installation guide.

Running SABnzbd from source

Once you've sorted out all the dependencies, simply run:


Or, if you want to run in the background:

python -d -f /path/to/sabnzbd.ini

If you want multi-language support, run:

python tools/

Our many other command line options are explained in depth here.

About Our Repo

The workflow we use, is a simplified form of "GitFlow". Basically:

  • "master" contains only stable releases (which have been merged to "master")
  • "develop" is the target for integration
  • "1.0.x" is a release and maintenance branch for 1.0.x: 1.0.0 -> 1.0.1 -> 1.0.2
  • "1.1.x" is a release and maintenance branch for 1.1.x: 1.1.0 -> 1.1.1 -> 1.1.2
  • "feature/my_feature" is a temporary feature branch
  • "hotfix/my_hotfix is an optional temporary branch for bugfix(es)


  • Merging of a stable release into "master" will be simple: the release branch is always right.
  • "master" is not merged back to "develop"
  • "develop" is not re-based on "master".
  • Release branches branch from "develop" only.
  • Bugfixes created specifically for a release branch are done there (because they are specific, they're not cherry-picked to "develop").
  • Bugfixes done on "develop" may be cherry-picked to a release branch.
  • We will not release a 1.0.2 if a 1.1.0 has already been released.