SABnzbd - The automated Usenet download tool http://sabnzbd.org
  • Python 83.5%
  • JavaScript 9.6%
  • CSS 3.5%
  • NSIS 2.8%
  • HTML 0.5%
Find a file
Safihre 395f8dc4c5
Some checks are pending
Build binaries and source distribution / Build Windows binary (arm64) (push) Waiting to run
Build binaries and source distribution / Build Windows binary (x64) (push) Waiting to run
Build binaries and source distribution / Build macOS binary (push) Waiting to run
Build binaries and source distribution / Prepare Release (push) Blocked by required conditions
Build and publish Snap packages / Build Snap Packages (arm64) (push) Waiting to run
Build and publish Snap packages / Build Snap Packages (x64) (push) Waiting to run
CI Tests / Black Code Formatter (push) Waiting to run
CI Tests / Test Linux - Python 3.10 (push) Waiting to run
CI Tests / Test Linux - Python 3.11 (push) Waiting to run
CI Tests / Test Linux - Python 3.12 (push) Waiting to run
CI Tests / Test Linux - Python 3.13 (push) Waiting to run
CI Tests / Test Linux - Python 3.14 (push) Waiting to run
CI Tests / Test Linux - Python 3.9 (push) Waiting to run
CI Tests / Test Windows - Python 3.14 (push) Waiting to run
CI Tests / Test macOS - Python 3.14 (push) Waiting to run
Update translatable texts / Update translatable texts (push) Waiting to run
Only build snaps for tags and relevant file changes
2026-04-14 18:01:18 +02:00
.github Only build snaps for tags and relevant file changes 2026-04-14 18:01:18 +02:00
.tx Update Transifex client to supported version 2022-10-25 20:16:55 +02:00
builder Put releasing a new version behind manual approval 2026-04-14 09:42:13 +02:00
context Use blocking writes instead of buffering (#3248) 2026-01-02 12:49:42 +01:00
email replace leftover wikidot url about email templates (#3018) 2025-01-14 09:07:31 +01:00
icons Rename osx to macos in the code 2025-05-05 22:15:02 +02:00
interfaces Set pipeling requests to 2 for new servers (#3362) 2026-03-23 22:51:02 +01:00
licenses Fix typos (#2339) 2022-11-14 07:21:42 +01:00
linux Change text files for 5.0.0RC1 2026-03-30 10:43:05 +02:00
macos 7zip 26.0 + par2cmdline-turbo 1.4.0 (#3321) 2026-02-16 09:25:29 +00:00
po Update translatable texts 2026-04-06 07:12:35 +00:00
sabnzbd Update text files for 5.0.0RC3 2026-04-13 18:46:00 +02:00
scripts Make black 26.1.0 happy again - almost 2026-01-19 12:42:51 +01:00
snap Small tweaks to snapcraft.yml 2026-03-30 11:04:20 +02:00
tests Tavern issue fixed 2026-04-10 10:21:34 +02:00
tools Check nsis exists before use (#3374) 2026-04-10 12:18:45 +02:00
win 7zip 26.0 + par2cmdline-turbo 1.4.0 (#3321) 2026-02-16 09:25:29 +00:00
.git-blame-ignore-revs Add changes to web_host and web_port to ignored revs 2024-07-14 23:23:26 +02:00
.gitignore Add .claude to gitignore 2026-03-30 10:38:47 +02:00
COPYRIGHT.txt Update copyright to 2026 2026-02-09 16:44:38 +01:00
GPL2.txt Eliminate superfluous 'main' folder 2010-03-21 12:58:33 +01:00
GPL3.txt Eliminate superfluous 'main' folder 2010-03-21 12:58:33 +01:00
INSTALL.txt Update copyright to 2026 2026-02-09 16:44:38 +01:00
ISSUES.txt Only download force priority items when paused (#2679) 2023-09-18 11:17:52 +02:00
LICENSE.txt Update copyright to 2026 2026-02-09 16:44:38 +01:00
portable.cmd Make sure that the invoking window disappears 2016-07-13 08:36:05 +02:00
README.md Drop support for Python 3.8 2025-11-21 10:00:09 +01:00
README.mkd Update text files for 5.0.0RC3 2026-04-13 18:46:00 +02:00
requirements.txt Update all dependencies (#3376) 2026-04-13 01:39:43 +00:00
SABnzbd.py Replace chardet by charset_normalizer 2026-03-09 12:59:48 +01:00

SABnzbd - The automated Usenet download tool

License Join our Discord

SABnzbd is an Open Source Binary Newsreader written in Python.

It's totally free, 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. SABnzbd offers an easy setup wizard and has self-analysis tools to verify your setup.

If you want to know more you can head over to our website: https://sabnzbd.org.

Resolving Dependencies

SABnzbd has a few dependencies you'll need before you can get running. If you've previously run SABnzbd from one of the various Linux packages, then you likely already have all the needed dependencies. If not, here's what you're looking for:

  • python (Python 3.9 and above, often called python3)
  • Python modules listed in requirements.txt. Install with python3 -m pip install -r requirements.txt -U
  • par2 (Multi-threaded par2 installation guide can be found here)
  • unrar (make sure you get the "official" non-free version of unrar)

Optional:

  • See requirements.txt

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

Running SABnzbd from source

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

python3 -OO SABnzbd.py

Or, if you want to run in the background:

python3 -OO SABnzbd.py -d -f /path/to/sabnzbd.ini

If you want multi-language support, run:

python3 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) and is intended for end-users.
  • develop is the target for integration and is not intended for end-users.
  • 1.1.x is a release and maintenance branch for 1.1.x (1.1.0 -> 1.1.1 -> 1.1.2) and is not intended for end-users.
  • feature/my_feature is a temporary feature branch based on develop.
  • bugfix/my_bugfix is an optional temporary branch for bugfix(es) based on develop.

Conditions:

  • 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.

Privacy Policy

This program will not transfer any information to other networked systems unless specifically requested by the user or the person installing or operating it.

Code Signing Policy

For our Windows release, free code signing is provided by SignPath.io, certificate by SignPath Foundation.