davex
davex
Usenet Providers
TorBox
nntp.torbox.app
Port 563
Usernamedf3a8bbc-52b4-4e03-b1a0-065e1228dc66
Connections25 max
SecuritySSL Enabled
123
BehaviorPool Connections
Cascade (Optional)
Sets the order your providers are used. Drag the cards to arrange them. While this is off, all providers are used together.
NNTP Pipelining (Experimental)
Sends multiple article requests per connection without waiting for each response. Speeds up queue imports and streaming, especially on high-latency providers.
Requests kept in flight per connection (1–64). 8 is a good default. Each provider can override this in its own settings.
Defaults
Global settings used by indexers when no per-indexer override is set.
Sent on indexer search and caps queries. Leave blank to use the default.
Sent when retrieving the .nzb file. Leave blank to use the default.

One JavaScript-style regex per line. Search results whose title matches any pattern are dropped before being returned. Case-insensitive by default — use (?-i:Foo) for case-sensitive. Lines starting with # are comments. Use this to skip releases your setup can't handle, whatever the reason.

Indexers
altHUB
api.althub.co.za
Hostapi.althub.co.za
Rate limitUnlimited
Strict matchingDisabled
Search UADefault
Retrieve UADefault
Result filteringDisabled
ProxyDefault
TimeoutDefault
Result limitDefault
API limitUnlimited
Download limitUnlimited
CategoriesDefault
NinjaCentral
ninjacentral.co.za
Hostninjacentral.co.za
Rate limitUnlimited
Strict matchingDisabled
Search UADefault
Retrieve UADefault
Result filteringDisabled
ProxyDefault
TimeoutDefault
Result limitDefault
API limit14000 / 24h
Download limit8000 / 24h
CategoriesDefault
nzbgeek
api.nzbgeek.info
Hostapi.nzbgeek.info
Rate limitUnlimited
Strict matchingDisabled
Search UADefault
Retrieve UADefault
Result filteringDisabled
ProxyDefault
TimeoutDefault
Result limitDefault
API limitUnlimited
Download limitUnlimited
CategoriesDefault
NzbPlanet
api.nzbplanet.net
Hostapi.nzbplanet.net
Rate limitUnlimited
Strict matchingDisabled
Search UADefault
Retrieve UADefault
Result filteringDisabled
ProxyDefault
TimeoutDefault
Result limitDefault
API limit20000 / 24h
Download limitUnlimited
CategoriesDefault
usenet-crawler
www.usenet-crawler.com
Hostwww.usenet-crawler.com
Rate limitUnlimited
Strict matchingDisabled
Search UADefault
Retrieve UADefault
Result filteringDisabled
ProxyDefault
TimeoutDefault
Result limitDefault
API limit10000 / 24h
Download limit10000 / 24h
CategoriesDefault
Search Profiles
JSON Search APIVendor-neutral JSON results. Use from custom clients or scripts.
NewznabNewznab-protocol meta-indexer endpoint. Add to Prowlarr / Sonarr / Radarr.
AddonManifest-based addon endpoint. Install the URL in a compatible client to query this Search Profile.

These fire extra queries to this profile's indexers and spend their hit and rate limits, which you set per indexer in the Indexers tab.

when the ID search finds fewer thanresults

Title search. Up to 5 extra queries per search across this profile's 5 indexers.

when the ID search finds fewer thanresults

Title + episode, then a whole-show query that also catches untagged specials. Up to 10 extra queries per search across this profile's 5 indexers.

Failover
When an item is requested, nzbdav tries the top-ranked release first; if it can't be served fast enough, alternatives are tried automatically. These knobs control how aggressive that fallback is, so a request never hangs on a dead release.

When off, a request just processes the single chosen release (legacy behavior). When on, the watchdog tries alternative releases on failure and dedupes in-flight queue items. Live reports appear in the Watchdog tab in the sidebar.

Hard ceiling for a request. Big UHD releases need ~15–30s for the queue to extract file metadata. If exceeded, the client gets a retry-able error; the queue item keeps processing in the background and a re-request resolves it. Default 30.

If the primary candidate hasn't passed verification by this many seconds, backup candidates start in parallel. Lower = more eager fallback, slightly higher provider load. Default 3.

How many candidates run at the same time in one round. Higher means faster failover when a candidate fails, but more simultaneous indexer requests — too many in parallel can look like spamming and risk a ban. Default 3.

The most candidates one request will try in total before giving up. With the defaults (3 per batch, 10 total) it tries up to 10 candidates, a few at a time, then stops. Also stops sooner if the total budget runs out. Default 10.

`none` (the default) skips the pre-check for the fastest start; every candidate is enqueued right away. `stat` is a cheap NNTP check that weeds out dead releases before the queue commits, avoiding a re-fetch of their NZB from the indexer on every request.

How long a recently-failed release is skipped on subsequent requests, so we don't hammer the same dead release (and its indexer) over and over. Default 5.

Stall failover
If a candidate reports no progress within the window below, it is set aside and the next candidate is attempted, instead of waiting for it to complete. A set-aside candidate is not recorded as failed — it may simply be slow. On by default; requires the failover watchdog above to be on.

When a candidate stops progressing, it is set aside and the next one is attempted. On by default.

A candidate that has started but reported no progress for this many seconds is set aside. A candidate that keeps reporting progress is never set aside. Default 2.

Upper limit on how long a single candidate is given before moving on, regardless of progress — a backstop for a candidate that is queued but not yet started. Default 5.

Variants
Keep multiple size copies of the same item. When you pick a different size for something nzbdav already has, it can fetch that size too, then on future picks serve the copy closest to whatever size you just selected. Off by default.

`smart` is the recommended default once enabled. `collect-all` adds a new copy for every distinct size you pick (no near-exact match) — usually fine since files are mounted, not stored locally; only the metadata grows.

`smart` mode only. Existing copy is reused if its size is within ±N% of what you selected. Outside that → fetch the new variant and keep both. Default 25 (generous to absorb indexer-vs-actual size drift).

Cap on how many size copies of the same item to keep at once. When the cap is hit, the eviction strategy below decides which to drop. Set to 0 for unlimited. Default 3.

When multiple copies exist for the same group, which one to serve. `closest-to-selection` uses what you just picked as the intent signal.

When you pick a size we don't have AND no working source can be fetched, serve the closest existing copy instead of returning an error. Strictly safer than today's behavior. On by default.

Decides which copy is removed when `max copies per group` is hit. LRU is the safe default. `never` means you remove copies manually from the History view.

Eviction skips any copy used within the last N seconds. Safety net so we never remove an item that's still being accessed. Default 60.

Preflight
When a client asks for the list of available articles, nzbdav can quietly do upfront work on the top-ranked ones so the next request reuses that warm state instead of redoing everything from scratch. The harder the mode, the more it does.

light performs a cheap existence check against your provider, so missing articles are skipped without re-asking the indexer. standard additionally caches the article descriptor locally so the next request skips the indexer round-trip entirely. full additionally resolves trailing-archive metadata for any top result that maps to a previously completed item — useful when re-opening something.

Walks the top-ranked results one at a time and stops on the first one that passes the check. So a missing top result automatically falls through to the next one — same idea as the watchdog at click time, but in the background. Default 20.

How long a preflighted result stays warm before it's discarded. Long enough to scroll through and pick something, short enough not to hold stale state. Default 120.

Preflight is best-effort: if an indexer's rate limit would force it to wait longer than this before a request can fire, preflight on that result is skipped. Keeps real requests from being queued behind speculative work. Default 5.

Watchtower
Keeps the titles on your lists pre-resolved to a healthy release and re-verified over time, so each is found and ready before you need it. Pointer-only and safe-by-default: it stores segment maps (kilobytes), never video, and respects your indexer caps. Manage your lists on the Watchtower page; tune the engine here.

When on, the background engine syncs your lists, resolves the biggest healthy release for each item, and keeps it verified over time. When off, nothing runs.

Which Search Profile the resolver uses — this decides which indexers get queried. Default uses the first one.

Match the watchdog uses the same rank order as the watchdog, so the release Watchtower readies is exactly the one the watchdog would select. Largestalways prefers the biggest healthy release (it may differ from what the watchdog would have chosen).

Series expansion
How much of a TV show or anime is warmed when a whole series is tracked. Each series is expanded into its seasons/episodes via TVmaze (TV) or Kitsu (anime), keyless, then resolved and kept fresh like any other item.

Latest season warms only the newest season (default). First seasonwarms only season one — handy for watchlists you may start later. All airedbackfills every released season. Recent keeps just the last few episodes across the whole series. Off stops series from expanding into episodes. Each list can override this on the Watchtower page.

Warm one season bundle per completed season, a single release that covers the whole season and plays per episode, instead of every episode. Still-airing seasons always use single episodes. Default on.

When a finished season has no healthy bundle, warm its individual episodes instead so the season is still covered. The bundle is parked and stops being searched, so this will not keep hitting your indexers. Use "check now" on a parked pack to try for it again. Off by default.

Hard ceiling on how many items a single series may warm: individual episodes and season bundles combined, across every season. No series can expand past this on any scope, so a very long title stays bounded instead of fanning out. A season bundle counts as one item. 0 = unlimited. Default 50.

Which end of the series to keep when it hits the cap. Newest stays current with the latest episodes and season packs. Oldest starts from season one, useful when you plan to watch a series from the beginning.

Ignore releases smaller than this. Default 0.5 GB.

Ignore releases larger than this. Empty / 0 = no ceiling.

Only consider releases with at least this many grabs (recorded downloads) on the indexer. Higher = more proven releases but fewer candidates. 0 = no minimum. Default 0.

How many items the engine keeps actively ready. Beyond this, items are listed but parked until they bubble up. This is what bounds load no matter how big your lists get. Default 100.

Resolve as fast as your indexers allow instead of pacing with the daily budget below. Every search and grab still obeys each indexer's requests-per-minute and daily caps from Indexer settings, and the engine pauses automatically when an indexer is tapped out. Best for clearing a large backlog. Default off.

Soft cap on new resolves per day (0 = unlimited; your per-indexer caps always apply). Drips the backlog instead of hammering indexers. Default 60.

One live winner + backups kept per item, for instant failover. Default 2.

Max NZB fetches (the scarce indexer bucket) per item per pass. Keeps resolves grab-thrifty. Default 3.

How many segments are sampled to confirm a release is alive on Usenet, on both the first resolve and every re-check. Higher = more thorough but slower. Default 3.

Max time a single segment check may run before it's treated as a timeout and its Usenet connection is released. Guards against unresponsive providers stalling the engine. Default 10.

Re-check & retry timing
How often the engine re-verifies items over time. Re-checks are Usenet-only — they confirm a release is still downloadable and do not query your indexers or spend the daily resolve budget.

How often a ready item is re-verified on Usenet to confirm it's still downloadable. Items that stay healthy gradually stretch toward the max below. Default 21600 (6 hours).

The longest a repeatedly-healthy item waits between re-checks. Default 604800 (7 days).

How long an unavailable ("dead") item waits before it's searched again. Lower retries more often but spends more of your daily resolve budget. Default 21600 (6 hours).

How often remote lists are re-fetched to catch additions/removals. Default 3600.

Diagnostics
Extra visibility into what the engine is doing, for troubleshooting. Off by default.

Writes Watchtower's per-item activity to the Logs page at the Information level: each resolve, why an item is left unavailable, dead releases it skips or finds, backup promotions, and a short heartbeat every cycle so you can confirm it's still running. Useful when an item gets stuck or stops updating. Only emits while Watchtower is enabled. Leave off for normal use — it's chatty.

Warden
A portable filter list of dead-release fingerprints. Your own list fills in automatically and stays independent. You can also add remote lists from a URL; they refresh on their own schedule, never touch your own list, and you decide how much each one is trusted. Fingerprints are universal: identical on any provider, indexer, or server, and free of credentials.

When on, anything whose fingerprint is filtered by your sources is removed from what your search profiles return. If everything matches, results are shown anyway as a last resort.

A fingerprint from a “corroborate” source only filters when at least this many independent sources agree. Your own list and “full”-trust sources always filter on their own.

A verdict from a remote or imported list only filters when its provider matches one of yours. Your own list always filters.

Sources
Loading…

Each source has a trust level. full filters on its own; corroborate filters only when enough sources agree (the number above); observe keeps the list but never filters.

Drag & drop a warden file here to import.

Backup to GitHub
Loading…

A personal backup of your fingerprint list to a repo you own. Keep the repo private for a pure backup, or public to share. The file holds only fingerprint hashes, no credentials. Restore reuses the same repo and token, so private repos work too.

Advanced Settings
Integrations, server access, and maintenance. Expand a section to view its options.

Use this user to connect to the webdav. Only letters, numbers, dashes, and underscores allowed.

Use this password to connect to the webdav.

The maximum number of connections used for webdav streaming (playback). Set this to the minimum number of connections that fully saturates your streaming bandwidth. Queue imports use their own budget — see Queue Download Connections below.

Connections the queue may use while importing an nzb (fetching names/sizes, parsing par2/rar). Higher = faster imports. This is independent of streaming, so you can push imports hard without touching the streaming budget. It's always capped at your provider's connection limit, so the queue can never open more connections than your plan allows. Leave blank for Auto (use all your provider connections); lower it if you'd rather keep imports gentle or reserve connections for simultaneous streaming.

%
When streaming from the webdav while the queue is also active, how much bandwidth should be dedicated to streaming?

The number of articles to buffer ahead, per stream, when reading from the webdav.

When enabled, decoded segments are stored on disk so repeated reads (re-watches, seeks, multiple viewers) skip the network and don't count against provider limits. Takes effect after a restart.

The WebDAV `/content` folder will be readonly when checked. WebDAV clients will not be able to delete files within this directory.

Hidden files or directories are those whose names are prefixed by a period.

When enabled, par2 files will be rendered as text files on the Dav Explorer page, displaying all File-Descriptor entries.

Use this API key when configuring your download client in Radarr or Sonarr.

tv, movies, audio, software
The complete list of categories for organizing imported nzbs. Only letters, numbers, and dashes are allowed.

The category to use for manual uploads through the Queue page on the UI.

If you need to be able to stream from Plex, you will need to configure rclone and should select the `Symlinks` option here. If you only need to stream through Emby or Jellyfin, then you can skip rclone altogether and select the `STRM Files` option.
The location at which you've mounted (or will mount) the webdav root, through Rclone. This is used to tell Radarr / Sonarr where to look for completed "downloads."

The public URL at which you access nzbdav. Used for all streaming links — both *.strm file contents (Emby/Jellyfin) and profile streaming/sharing URLs (Plex). If left blank, nzbdav infers it from request headers, which often fails behind reverse proxies. Make sure your media servers can reach this URL.

*.nfo*.par2*.sfv*sample.mkv
Files that match these patterns will be ignored and not mounted onto the webdav when processing an nzb. Wildcards (*) are supported.

When an NZB is added, a new folder is created on the webdav. What should be done when the download folder for an NZB already exists?

The user-agent used by the addurl api for fetching nzb files. The user-agent for indexer searches is set separately under Settings → Indexers.

Whether to mark downloads as `failed` when no single video file is found inside the nzb. This will force Radarr / Sonarr to automatically look for a new nzb.

Whether to check for the existence of all articles within an NZB during queue processing. This process may be slow.

When enabled, this will ignore the History limit sent by radarr/sonarr and always reply with all History items. See here.

When enabled, a copy of each incoming NZB will be saved to this directory, organized by category. The directory will be created if it doesn't already exist.

Radarr Instances

No Radarr instances configured. Click on the "Add" button to get started.


Sonarr Instances

No Sonarr instances configured. Click on the "Add" button to get started.


Automatic Queue Management

Configure what to do for items stuck in Radarr / Sonarr queues. Different actions can be configured for different status messages. Only `usenet` queue items will be acted upon.

  • Found matching series via grab history, but release was matched to series by ID. Automatic import is not possible.
  • Found matching movie via grab history, but release was matched to movie by ID. Manual Import required.
  • Episode was not found in the grabbed release
  • Episode(s) was/were unexpected considering the folder name
  • Not an upgrade for existing episode file(s)
  • Not an upgrade for existing movie file
  • Not a Custom Format upgrade
  • No files found are eligible for import
  • Episode file already imported
  • No audio tracks detected
  • Invalid season or episode
  • Single episode file contains all episodes in seasons
  • Unable to determine if file is a sample
  • Sample
  • Found archive file, might need to be extracted

When enabled, usenet items will be continuously monitored for health. Unhealthy items will be removed and replaced. This setting can only be enabled once your Library-Directory and Radarr/Sonarr instances are configured.

The path to your organized media library that contains all your imported symlinks or *.strm files. Make sure this path is visible to your davex container.

When enabled, nzbdav will automatically notify your rclone mount via the RC API whenever files are added or removed on the webdav. This allows setting a high dir-cache-time setting on Rclone.

The host address of the rclone RC API.

The username for authenticating to the rclone RC API. This field is optional.

The password for authenticating to the rclone RC API. This field is optional.

When enabled, nzbdav will run a SQLite VACUUM on the database at every startup. This reclaims unused disk space and can improve query performance over time, but may increase startup time for large databases.

When enabled, the "Remove Orphaned Files" task will run every day at the specified time. You may need to set the TZ env variable to ensure the correct timezone.


This task will scan your organized media library for all symlinked or *.strm linked files. Any file on the webdav that is not pointed to by your library will be deleted. If you would like to see what would be deleted without running the task, you can . The dry-run will not delete anything.

Note: Files still present in the History table will not be removed when running this task. It is assumed that files still present in the History table have not yet been imported by Arrs and they are expected to not yet have a corresponding symlink/strm in the Library folder. These files will remain intact until Arrs have a chance to process them and remove them from the History table.


This task will scan your organized media library for all *.strm files. Every *.strm file that links to nzbdav media will be deleted and be replaced by a symlink. The newly created symlinks will all point to the corresponding file within your rclone mount.


This task runs automatically in the background to optimize the database. No action is required on your part. You can simply track the progress here. For context, the sqlite database used by the backend is slow at reading and writing large data blobs. It is better to store those externally in the filesystem directly, as documented here. However, as of now, all blobs have been stored in the database directly. This task migrates those blobs to the filesystem, for better performance.

The task has not started.