SABnzbd - The automated Usenet download tool
Python JavaScript CSS Other
Permalink
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 Multi-delete would refresh the queue for every deleted item Aug 23, 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 Extend Rating functionality Aug 17, 2016
sabnzbd Merge pull request #668 from sanderjo/develop Aug 26, 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_mo.py now detects warnings about missing arguments in texts. Aug 10, 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 Ignore .pyd too Aug 9, 2016
ABOUT.txt Remove code for v0.5.x Aug 1, 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 files for 1.1.0RC4 Aug 29, 2016
README.md Update Wiki-link Jun 30, 2016
README.mkd Update text files for 1.1.0RC4 Aug 29, 2016
SABHelper.py moved regex define before use (save memory when code branch isnt ran)… Sep 30, 2015
SABnzbd.py #656 Move switches to Specials for Unrar/Unzip/7zip/FileJoin/TSJoin Aug 15, 2016
portable.cmd Make sure that the invoking window disappears Jul 13, 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.