Incorrect or missing information? Switches
|Server load-balancing||A number of newsservers has multiple IP-addresses, these can be IPv4 or IPv6.
|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
|Only for optional servers||You can choose to use limited retries only for your "optional" servers. This will prevent "Out of retention" failures when your main server is inadvertently off-line|
|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.|
|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 untill they are at least this age. Setting job priority to Force will skip the delay. [only 2.0.0+]|
|Only get articles for top of the queue||When a top-job stalls for some reason, start downloading segments for the next job (costs more memory). This prevents a job from blocking the queue when you have an unreliable Usenet server. If you need this behaviour, 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. [0.7.8+ only]|
|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 analyse 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 troyan 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.|
|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. Pevents 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.
Use MultiPar for verification and repair. MultiPar uses the latest optimizations, multiple cores and can utilize the GPU, resulting in repairs often being twice as fast. Created by Yutaka Sawada.
GPU support is not enabled by default since it can also result in slower repair. To enable GPU support fill
|Extra PAR2 parameters||
Extra arguments that will be passed when running
|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.|
|Cleanup List||List of file (extensions) that should be deleted in the cleanup stage. Examples:
|Enable folder rename||When SABnzbd does unpacking it will do that in a folder prefixed with
|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.|
|Replace illegal characters in folder names||Replace illegal characters in folder names by equivalents. If you switch this off, illegal characters will be just removed.|
|Make Windows compatible||Especially useful for servers and sometimes external disks. Make sure names are compatible with Windows.|
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:
|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.
|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.
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 macOS and Linux
NOTE For Windows, see below.
The macOS distribution of SABnzbd includes a multi-core version of the PAR2 program which will see improvements for those with multi-core processors. On Linux 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.
-t1Use it single-core
-t0[par2tbb/macOS only] Use multi-core for repairs but not for verify (prevents disk trashing)
If you use the macOS release or the
par2-tbb version on other platforms you can also set the process priority:
-pNto process at normal priority [default]
-pLto process at low priority
-pIto 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.
/lcSet this if you want to set number of using threads or want to disable extra feature (SSE2 is always used).
nis from 1 to 11 for specific number of cores
/lc12to use quarter number of physical cores
/lc13to use half of physical cores
/lc14to use 3/4 number of physical cores
/lc15to use the number of physical cores (disable Hyper-Threading)
You may set additional combinations by adding the following options to the already specified value:
+16to disable SSSE3
+128to disable CLMUL
+256to disable JIT
+512to disable AVX2
+64(slower device) to enable GPU acceleration
/lc1to use single core,
/lc32to enable GPU usage or
/lc45to use half cores and GPU usage.
/mSet 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
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
For more info, see the ionice man-page
Be careful, using wrong parameters will make all external tools fail!