Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
SABnzbd - The automated Usenet download tool
Failed to load latest commit information.
cherrypy CherryPy Patch: allow UTF-8 encoding of headers.
email Email notification for failed URL fetches.
gntp Remove warning about Growl when user has disabled message class in Gr…
icons Replace current icon files with smaller ones (thanks, inpheaux).
interfaces Remove "do not download samples" option.
licenses Remove obsolete build support files.
linux add (example) systemd unit file
osx Add 64bit only par2-sl for OSX.
po Update translation source file.
sabnzbd Remove "fail_on_crc" option and move "overwrite_files" from Special t…
solaris Adds solaris manifest
tools Update language templates.
util moved pystone module to sabnzbd/utils
win Update par2-tbb for Windows to version 0.4
.gitignore Support testing email based on values in UI instead of stored config.
ABOUT.txt Update text files for 0.7.11
CHANGELOG.txt Merge branch 'master' into develop
COPYRIGHT.txt Update text files for 0.7.8
Dockerfile Add Dockerfile
GPL2.txt Eliminate superfluous 'main' folder
GPL3.txt Eliminate superfluous 'main' folder
INSTALL.txt Update text files for 0.7.11
ISSUES.txt Added an issue and made some language corrections.
LICENSE.txt Update text files for 0.7.8
PKG-INFO Update text files for 0.7.11
README.md Update the warning in README.md
README.mkd Update README.mkd with 0.8.0 info.
SABHelper.py Update copyright stuff.
SABnzbd.py Determine and show publick IPv4 address (if +Debug is on)
Sample-PostProc.cmd Eliminate superfluous 'main' folder
Sample-PostProc.sh Eliminate superfluous 'main' folder

README.md

SABnzbd - The automated Usenet download tool

WARNING

!!! CURRENTLY THIS BRANCH IS NOT STABLE, DUE TO THE TRANSITION TO UNICODE !!!

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.5-2.7, preferably 2.6 or 2.7.)
  • python-cheetah
  • python-configobj
  • python-feedparser
  • python-dbus
  • python-openssl
  • python-support
  • python-yenc
  • par2 (Multi-threaded par2 can be downloaded from ChuChuSoft )
  • unrar (Make sure you get the "official" non-free version of unrar)
  • unzip

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 -d -f /path/to/sabnzbd.ini

If you want multi-language support, run:

python tools/make_mo.py

Our many other commandline options are explained in depth here.

About Our Repo

We're going to be attempting to follow the gitflow model, so you can consider "master" to be whatever our present stable release build is (presently 0.6.x) and "develop" to be whatever our next build will be (presently 0.7.x). Once we transition from unstable to stable dev builds we'll create release branches, and encourage you to follow along and help us test.

Something went wrong with that request. Please try again.