SABnzbd - The automated Usenet download tool
Pull request Compare This branch is 1714 commits behind sabnzbd:master.
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
cherrypy
email
gntp
icons
interfaces
licenses
osx
po
sabnzbd
tools
util
win
.gitignore
ABOUT.txt
CHANGELOG.txt
COPYRIGHT.txt
GPL2.txt
GPL3.txt
INSTALL.txt
ISSUES.txt
LICENSE.txt
NSIS_Installer.nsi
PKG-INFO
README.md
README.rtf
README.txt
SABHelper.py
SABnzbd.py
Sample-PostProc.cmd
Sample-PostProc.sh
package.py
setup.py

README.md

SABnzbd - The automated Usenet download tool

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.