SABnzbd

Wiki

Incorrect or missing information? Switches

This Wiki page is for an older version of SABnzbd.
You can download the most recent stable version (SABnzbd 2.3) on our downloads page.

Server

Server load-balancing A number of newsservers has multiple IP-addresses, these can be IPv4 or IPv6.
  • Prevent load-balancing = The first IP-address returned will be used for all connections.
  • Allow load-balancing = Each connection will be randomly selected from the available addresses.
  • Allow load-balancing with optimization for IPv6 = For each connection the fastest IP-address is selected, where IPv6-addresses are given a slight head-start.
SSL Ciphers See SSL Ciphers.
Maximum retries To prevent deadlock, SABnzbd will only try each server a limited amount of times. You can increase the value or set it to 0 to enable endless retries.
Disconnect on empty queue Disconnect from Usenet server(s) when queue is empty or paused. This will help you switch between different systems. Set this option off when your server keeps complaining that you have too many connections open.

Queue

Pre-queue user script See: User's pre-queue script.
Propagation delay If you experience very young posts failing due to missing blocks your server might still be in the process of receiving the posts. Delaying the these very young posts a few minutes might solve these issues. Posts will be paused until they are at least this age.
Setting job priority to Force will skip the delay.
Only get articles for top of the queue When a top-job stalls for some reason, start downloading segments for the next job. This prevents a job from blocking the queue when you have an unreliable Usenet server. If you need this behavior, set the option off. If you have a reliable server (most paid servers), you might as well set this on.
Check before download

To prevent wasteful downloading, you can let SABnzbd check the presence of a job on the server, before actually downloading it. If less than 100.2% of the total available data (including par2 files) is available, the job will be send to History as failed. When you click "Retry", SABnzbd will attempt the download anyway.

NOTE The check slows down the total download considerably, use only when you're not in a hurry but wish not to waste your quota instead. Also it cannot be completely reliable, due to the way some servers remove posts.

Abort jobs that cannot be completed If on, when during download it becomes clear that less than 99% of the total data can be downloaded, the job will be sent to History as a failed one. Should you retry the job, the check will not be done again, but the whole job will be tried instead.
Detect duplicate downloads This option will compare the name of the NZB file against all NZB titles in History and items in your .nzb Backup Folder. It will also look whether the content of the NZB is effectively the same.
Detect duplicate episodes in series This option will analyze NZB titles for Series/Season/Episode information and will check whether the episode has already been downloaded. It will check against the History database.
Action when encrypted RAR is downloaded For more info see Password-protected RARs. You can choose to either continue, abort or pause the download.
Action when unwanted extension detected The presence of .exe files is often a sign of a trojan horse or virus being part of the post. You can abort or pause downloads that contain files with the listed extensions. Example exe,com,cmd,bat will trigger on the most used Windows executable content.
Sort by age When you use a server with a low retention time, you can choose to download the oldest parts of a job first. This way you have more chance on completing the download.
Direct Unpack Jobs will start unpacking during the downloading to reduce post-processing time. Only works for jobs that do not need repair and do not have strongly obfuscated filenames.
This feature is enabled automatically when your disk-speed is greater than 40MB/s. It will not be enabled automatically again if you manual disable it.

Post processing

Pause downloading during post-processing Will pause the queue while verifying and repairing, only needed for resource-constrained systems (like NAS-devices).
Download all par2 files Download all par2 files when (after verification) the job was damaged. Prevents multiple rounds of verification.
NOTE SABnzbd will already download extra par2 files if it detects problems during the download, so usually this option is not required.
Extra PAR2 parameters

Extra arguments that will be passed when running par2 or MultiPar for verification and repair.

Detailed information: Windows and Linux. No extra parameters are available on macOS.

Enable SFV-based checks If no par2 files are available, SFV files (if present) will be used to check files
Process only verified jobs When the download is incorrect and not repairable it may be safer to skip further post-processing.
Enable recursive unpacking Unpack archives (rar, zip, 7z) within archives.
Ignore any folders inside archives All files will go into a single folder.
User script can flag job as failed Some scripts will return a non-zero exit code when they encounter a problem. You can opt to let a non-zero exit code mark the job as failed. This can be useful when you're using an indexer that offers alternative NZB files or use a front-end (like SickBeard) that will look for alternatives when a job fails.
On failure, try alternative NZB Some servers provide an alternative NZB when a download fails and we can try that one.
Nice parameters See Nice to reduce CPU priority.
IONice parameters See IONice to reduce disk priority.
Ignore samples If enabled, delete anything that looks like sample files after completion of post-processing.
Use tags from indexer Enable meta-tags coming from indexers or from the content of the NZB. These tags contain cleaned up versions of titles, episode names, etc. If you prefer that everything is derived from the NZB name, disable.
Cleanup List List of file (extensions) that should be deleted in the cleanup stage. Examples: .nfo, .nfo, .sfv (You can leave out the dots, so nfo, nzb, sfv will do the same.)
History Retention Automatically delete completed jobs from History when new jobs are added or every day at midnight.
  • Keep all jobs = Do not auto-delete any history.
  • Keep maximum number of completed jobs = Specify exact amount of jobs to keep, removing the oldest ones.
  • Keep completed jobs maximum number of days = Delete jobs automatically when they are older than the set amount of days.
  • Do not keep any completed jobs = No jobs are saved in the History.
NOTE Beware that Duplicate Detection and some external tools rely on History information.

Naming

Enable folder rename When SABnzbd does unpacking it will do that in a folder prefixed with _UNPACK_. This is to prevent users or other software from processing the file. Some Windows operating systems (most notably Windows Home Server) cannot handle this. Therefor it's possible to disable the feature.
Replace Spaces in folder names Enable to replace spaces with underscores in folder names.
Replace dots in folder names Enable to replace dots with spaces in folder names.
Make Windows compatible Especially useful for servers and sometimes external disks. Make sure names are compatible with Windows.

Quota

If you're unlucky enough to have an ISP that uses strict download caps, you may want to set a monthly quota for SABnzb.

Size In bytes. Example: 5G (for 5 GB) or 1T (for 1 TB)
Period Daily, Weekly or Monthly quota
Reset day The day of the week or month when your ISP will reset your cap. Use 31 for the last day of the month. Optionally you can add a time of day, like 23:30.
  • So for monthly you would enter 20 23:30, meaning the 20th of each month at 11:30PM.
  • For weekly 2 4:00, meaning every Tuesday at 4AM.
  • Even daily is possible: 3:00
Auto resume Set this on when you want to resume downloading once the quota has been reset. Otherwise you will have to resume manually

Please note file following:

  • Jobs with "Force" priority will ignore the paused state.
  • Pausing is never immediate. All already requested articles will be received and processed. They probably would be counted by your ISP any way.
  • Don't set the quota too high. Leave room for other Internet use.

Indexing

INFORMATION The protocol that SABnzbd uses can be found here if you want to implement this in your indexer: Indexer feedback.

Enable Indexer Integration Set this to enable enhanced functionality including ratings and SABnzbd can report to the indexer if a job couldn't be completed, when connected to a supported indexer.
API Key Insert your Indexer API key in here. Check your profile on the indexer's website.
Enable Filtering Based on the rating supplied by the indexer at time the NZB is added, you can automatically pause or abort jobs that do not meet the specified criteria.

Extra Par2 Parameters for Linux

NOTE For Windows, see below.

You will need to install the multi-core versions of par2 yourself, as described here.

The behavior of multi-core PAR2 can be influenced by an extra parameter. By default it will use all available cores.

  • -t1 Use it single-core
  • -t<n> Use n cores
  • -t0 [par2tbb] Use multi-core for repairs but not for verify (prevents disk trashing)

If you use the par2-tbb version you can also set the process priority:

  • -pN to process at normal priority [default]
  • -pL to process at low priority
  • -pI to process at idle (lowest) priority

NOTE Specifying more than 1 extra parameter might not always work.


Extra Par2 Parameters for Windows

The Windows version of SABnzbd has MultiPar integrated which allows you to specify the multi-core behavior and memory usage. Additionally, you can also enable the use of the GPU. Beware: GPU performance varies between systems and can also be slower on some systems.

  • /lc Set this if you want to set number of using threads or want to disable extra feature (SSE2 is always used).

    • /lc<n> where n is from 1 to 11 for specific number of cores
    • /lc12 to use quarter number of physical cores
    • /lc13 to use half of physical cores
    • /lc14 to use 3/4 number of physical cores
    • /lc15 to use the number of physical cores (disable Hyper-Threading)

    You may set additional combinations by adding the following options to the already specified value:

    • +16 to disable SSSE3
    • +128 to disable CLMUL
    • +256 to disable JIT
    • +512 to disable AVX2
    • +32 or +64 (slower device) to enable GPU acceleration

    For example: /lc1 to use single core, /lc32 to enable GPU usage or /lc45 to use half cores and GPU usage.

  • /m Set this if you want to set memory usage. Value is specified from 1 to 7 (1/7th to 7/8th):

    • /m0 = Default (between 6/8 and 7/8 mostly)
    • /m1 = 1/8, 12.5%
    • /m4 = 4/8, 50%
    • /m7 = 7/8, 87.5%

NOTE Specifying more than 1 extra parameter might not always work.


Nice to reduce CPU priority

When SABnzbd runs external tools like par2 and unrar, these tools may use up all CPU capacity. If you set parameters in the nice option box, the tool will be used (if installed). You will need to experiment with the parameters. Leaving the box empty will disable the use of nice.
Popular parameters are -n10.
For more info, see the nice man-page


IONice to reduce disk priority

When SABnzbd runs external tools like par2 and unrar, these tools may use up all disk capacity This can make simultaneous use of the system problematic, e.g. when you want to watch a movie. If you set parameters in the ionice option box, the tool will be used (if installed). You will need to experiment with the parameters. Leaving the box empty will disable the use of ionice.
Popular parameters are -c2 -n4.
For more info, see the ionice man-page

Be careful, using wrong parameters will make all external tools fail!