Skip to content
SABnzbd - The automated Usenet download tool
Python JavaScript CSS Other
Latest commit 8e0846a Jun 23, 2016 @shypike shypike Require Python 2.7 only
Also fix a typo and remove obsolete debugging function.
Failed to load latest commit information.
cherrypy Accept MIME records that have only LF line endings. May 11, 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 Avoid auto-filling from password managers (#596) Jun 15, 2016
licenses Remove Json.py license Sep 3, 2015
linux systemd service: add wiki link, remove group handling, housekeeping Apr 29, 2016
osx Update unrar for OSX to 5.30 Nov 26, 2015
po Update main POT file. May 14, 2016
sabnzbd Fix missing attribute in NzbObject Jun 20, 2016
scripts Some pep8 cleanup (whitespace/docstring only), focus on root dir alon… Sep 23, 2015
solaris Adds solaris manifest May 9, 2014
tools extract_pot.py: 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 version numbering in develop branch Mar 16, 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 version numbering in develop branch Mar 16, 2016
ISSUES.txt Fix links in text files to pooit to 1.0.0 entries in the Wiki. Feb 1, 2016
LICENSE.txt Update to 2016. Jan 13, 2016
PKG-INFO Update text files for 1.1.0Beta1 Jun 10, 2016
README.md Small fix in README May 23, 2016
README.mkd Update text files for 1.1.0Beta1 Jun 10, 2016
SABHelper.py moved regex define before use (save memory when code branch isnt ran)… Sep 30, 2015
SABnzbd.py Require Python 2.7 only Jun 23, 2016
portable.cmd Add start script for portable Windows installations Apr 22, 2016

README.md

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: http://sabnzbd.org.

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:

python SABnzbd.py

Or, if you want to run in the background:

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

If you want multi-language support, run:

python tools/make_mo.py

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)

Condtions:

  • 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.
Something went wrong with that request. Please try again.