Special settings
There are some special settings that are not accessible from the Web user interface,
but can be changed in the sabnzbd.ini file.
All options are in the [misc] section.
When changing: first stop SABnzbd, change the INI file, then start SABnzbd.
| Field name | Default | Meaning |
|---|---|---|
| config_lock | 0 | If set, forbids all access to the Config pages. |
| no_penalties | 0 | Some Usenet servers have intermittent login (or other) problems. For these the server blocking method is not very favourable. Setting this option that will limit blocks to 1 minute. |
| ignore_wrong_unrar | 0 | On Linux, SABnzbd checks whether the installed unrar or rar program is supported and issues a warning if not. Set this option if you think you know better. |
| replace_dots | 0 | Some NZB sites use dots in filenames instead of spaces. If you prefer spaces in the folder names, set this option. The substitution will only work if there are not already some spaces in the name. |
| create_group_folders | 0 | Older versions of SABnzbd had the possibility to move downloads to folders named after the actual Usenet group. This option is made more or less obsolete by the category system. If you still want the old behaviour, remove all categories and set this option to 1 |
| folder_max_length | 128 | On Windows, the total path is limited to 255 characters. A combination of long foldernames and long filenames may lead to problems. Set this option to limit the folder name, it will be truncated to the specified number. 64 is a safe value. The option will also work for other operating systems. |
| warned_old_queue | 0 | For internal use only: this "option" is set when SABnzbd has warned you about the presence of an old (0.4.x) queue, so it won't do it again. |
| folder_rename | 1 | Normally SABnzbd uses foldername prefixes like __UNPACK__ and __FAILED__ to indicate that the post-processing isn't complete yet or failed. If you don't want that, set this option to 0. |
| unpack_check | 1 | If enabled, SABnzbd will check if the unpack program has actually created all expected files. Sometimes this fails on combinations of operating systems and rar files. In case you often have false error reports, disable this option |
| size_limit | None | Any download that exceeds this value will be paused at get priority "low". You can use the K/M/G notation, so e.g. 4.7G (releease 0.5.1+) |
| queue_complete_pers | 0 | Set this to 1 if you want end-of-queue actions Shutdown/Standby/Hibernate to be persistent (remembered) after restarts (only in 0.5.4+) |
| allow_64bit_tools | 1 | If your 64bit Windows system has problems running the 64bit releases of par2 and unrar, you can force the use of the 32bit releases. (only in 0.5.4+) |
| par2_multicore | 1 | If your system has trouble running the multi-core version of the par2 program, set this to 0 (only in 0.5.4+) |
| api_warnings | 1 | When the API is accessed by external tools without proper authentication, SABnzbd will show a warning. This is a security warning that you should take seriously. However, it seems that there are some security tools that try to access anything that looks like a webserver. If you cannot disable the cause of the warnings, you can choose to disable the warning. (Only in 0.5.5+) |
| never_repair | 0 | Only perform QuickCheck and par2-verify, but never par2-repair. Use this when your low-performance system has trouble running repairs. All available par2 files will be downloaded, so you can let another system do the repair. If the download verifies OK, post-processing will be done as usual. (Only in 0.6.0+) |
| allow_streaming | 0 | Experimental option allowing streaming. You'll need a mediaplayer that can play from an incomplete set of unprocessed files. Jobs will not be post-processed, but remain in the temporary download folder and finally end up in History as "failed". From there you can either post-process the job after all or just delete everything. (Only in 0.6.0+) |
| ignore_unrar_dates | 0 | Normally unpacked files will get the date/time stamp they have in the archive. If you set this option, the files will get the date/time of unpacking (Only in 0.6.0+) |
| rss_filenames | 0 | Normally the RSS titles are used to name jobs. If you prefer the (usually) more compact NZB file names that are generated by index sites, set this to 1. The RSS matching still occurs on titles only! (Only in 0.6.3+) |
| newzbin, newzbin_url | www.newzbin2.es | Base URL of newzbin2; change it should they move again. Be careful: existing RSS feeds and pending URL fetches will not be changed! (Only in 0.6.15+) |
| use_pickle | 0 | Only set to 1 when there is a problem with one of the standard Python libs: More info. (Only in 0.6.15+) |
OSX-only options
| Special file | Meaning |
|---|---|
| ~/Library/Application Support/SABnzbd/notDisplayMenu | Create this empty file to disable SABnzbd's icon in the status bar |
| ~/Library/Application Support/SABnzbd/notDisplaySpeed | Create this empty file to prevent the display of downloading speed next to SABnzbd's icon in the status bar |
