UsenetStreamer Control Panel

Streaming Mode

To switch mode, set "STREAMING_MODE": "native" in runtime-env.json and restart.

Indexer Manager

Manager Type Manager URL In Docker, use the service/container name instead of localhost — e.g. http://prowlarr:9696 (Prowlarr) or http://nzbhydra:5076 (NZBHydra). localhost only works if the manager runs in the same container as the addon. API Key Indexer IDs / Names Comma-separated list of indexers this addon may query. Prowlarr: numeric IDs, with -1 meaning “all Usenet indexers”. NZBHydra: type the indexer names exactly as shown in Hydra. I have paid subscriptions with (comma separated) Comma-separated IDs/names of indexers where you have an active paid plan. Health checks only run against these. Grab limits per indexer (comma separated, same order) Max NZBs to grab per request from each paid indexer above. Same order as the indexer list. Default: 6 per indexer. Strict ID Matching Only Applies to both manager and direct Newznab searches. ID-only mode skips text queries. Manager Proxy (Optional) Optional — usually not needed. Only set this if an indexer has blocked your server's IP (common on cloud/VPS hosts). This proxies your NZB grabs only: Prowlarr/NZBHydra redirect each download to the real indexer, and this routes that fetch through the proxy. Searches are run by the manager itself — so to hide search traffic too, you must also add a proxy inside Prowlarr/NZBHydra (their own proxy settings). Leave blank for a direct connection. Local/LAN targets are bypassed automatically; use socks5h:// to resolve DNS at the proxy. Need one? Webshare (webshare.io) offers free proxies.

Direct Newznab Indexers

Add one or more direct Newznab endpoints. Enable them to search alongside your manager (or run manager-free), test each row, and reorder to control priority.

Preset

No indexers added yet. Pick a preset or add one manually.

Filter to NZB URLs Only Drops results whose download link is not an NZB. Applies to direct Newznab indexers only (not managers like Hydra/Prowlarr). Not required for most indexers — enable only if you see non-NZB results.

Built-in Easynews Indexer

Provide your Easynews credentials to let the addon search Easynews directly (no external bridge required). Only the username and password are needed.

Enable Easynews Integration Adds Easynews as a first-class indexer with specialized search capabilities. Easynews Username Easynews Password Enable Health Checks

Result Sorting & Filters

Preferences (used by Sorting Priority) These lists feed the matching sort key — first item = top priority. Leave blank to ignore that dimension.

Preferred Quality Source Source/release type (e.g. REMUX, BluRay, WEB-DL), not resolution. Preferred Encodes Preferred Visual Tags Preferred Audio Tags Preferred Audio Channels Preferred Release Groups Preferred Keywords Earlier keyword = higher priority. Tick Keyword in your sort priority above to use this.

Show common examples

Click a chip to add it to the matching field above. You can still type any custom value directly into the fields.

Exclusions (drop results that match) Results are filtered out before sorting. Comma-separated. All exclusions are case-insensitive.

Excluded Qualities Excluded Encodes Excluded Visual Tags Excluded Audio Tags Excluded Audio Channels Excluded Release Groups Excluded Languages

Show common examples

Click a chip to add it to the matching field above. You can still type any custom value directly into the fields.

Numeric Limits Hard cutoffs by file size and bitrate. Blank = no limit.

Min Size (GB) Max Size (GB) Defaults to 30 GB. Set 0 for no cap. Max Bitrate (Mbps) Bitrate is calculated from file size ÷ TMDb runtime, so it only works when TMDb is configured. Streams with unknown bitrate (no TMDb match) are never dropped by this filter.

Advanced: Import Sort Config & Regex Patterns

Import Sort Config Paste an exported sort/filter config JSON and click Import & Apply. We fill in the sorting priority, preferred lists, exclusions, ranges, and Regex tiers above and below with the imported values. Then click Save Changes. Learn more

Sort Config JSON We only read sortCriteria, preferred* lists, excluded*/required*/included* filters, and size/bitrate ranges. Everything else is ignored. After import, this textarea may still hold per-type sort data that can't be shown in the basic UI — leave it alone.

Regex Patterns Filter and sort streams by regular expressions. Each line is one pattern, matched (case-insensitive) against the filename, release group, and indexer name. Prefix with ! to negate a single pattern.

Required Regex Patterns A stream is kept only if at least one of these patterns matches. Streams with no match are dropped before sort. Excluded Regex Patterns A stream is dropped if any of these patterns matches.

Stream Naming

Customize how streams appear in Stremio. Leave blank to use the default. Easiest way: enter a comma-separated list of fields.

Stream Label Fields (Short Name) Comma-separated fields. Example: addon, health, instant, resolution. quality and resolution both show resolution. Use stream_quality for actual parsed quality only. Advanced templates are still supported if you use {...}. Description Fields (Long Title) Comma-separated fields. Example: title, stream_quality, health, source, codec, visual, audio, group, size, files, date, languages, indexer. Use stream_quality for actual parsed quality (e.g., BluRay/WEB-DL). Use files for file count and date for publish date. Advanced templates are still supported if you use {...}.

Live Preview EXAMPLE

UsenetStreamer ✅ ⚡ 4K

🎬 Dune Part Two ✨ WEB-DL 🎥 WEB-DL 🎞️ x265 📺 HDR | DV 🎧 Atmos DDP5.1 👥 FLUX 📦 15.4 GB 🌎 English 🔎 NZBGeek 🧪 ✅

NZBDav Connection

NZBDav URL In Docker, use the service/container name instead of localhost — e.g. http://nzbdav:3000. localhost only works if NZBDav runs in the same container as the addon. NZBDav API Key WebDAV URL WebDAV User WebDAV Password Base Category Movies Category Series Category

Stremio Catalog

Adds a "Completed NZBs" catalog inside Stremio so you can browse and replay items already downloaded to NZBDav. Titles and posters are enriched via TMDb when configured.

Completed Catalog Items Number of latest completed NZBs to show in the Stremio catalog (0 = disable the catalog).

Stream Protection

Protection Mode Pre-cache top NZB after search

Protection Modes

Mode	How it works	Speed	Trade-offs
No Protection	Plays the stream you click directly. If the NZB has missing articles, NZBDav shows a failure video.	⚡ Instant	No safety net — broken NZBs show a failure screen. Stream links stay valid as long as the file exists in NZBDav.
Auto-Advance Only	If the stream you click fails in NZBDav, the addon automatically advances to and plays the next available NZB. No health badges are shown.	⚡ Instant start, slow failover	You may not always play what you clicked. Auto-advance can take 5–30s while NZBDav processes the next NZB, depending on file size. Not suitable for large files. Sessions expire after 72 hours or when you save config changes.
Upfront Health Check	Spends 5–10 seconds verifying NZBs before returning results. Streams show ✅ (verified), ⚠️ (unverified), or 🚫 (blocked) badges — you play exactly what you see.	🕐 5–10s before results, depending on your indexer speeds	Slower initial load. You always know what's healthy before clicking. Stream links stay valid as long as the file exists in NZBDav.
Upfront Health Check + Auto-Advance	Same upfront health check with badges. In the rare case a verified NZB still fails in NZBDav, the addon automatically advances to the next healthy stream.	🕐 5–10s before results, depending on your indexer speeds	Best of both — badges for visibility, auto-advance for safety. Slightly slower initial load.
BG Health Check + Smart Play	Health checks run in the background while results load instantly. The "🎯 Smart Play" stream at the top picks the first verified NZB. Normal streams play exactly what you click — no auto-advance, no surprises. If a normal stream fails, you see the failure screen. Badges populate instantly on subsequent requests from cache. Stream links stay valid as long as the file exists in NZBDav.	⚡ Instant results, fastest playback start time	You always play what you click. Use this if you are picky about what you play. Only Smart Play itself has built-in auto-advance to the next verified NZB.
BG Health Check + Smart Play + Auto-Advance	Same as above, plus auto-advance on all streams. If any stream you click fails in NZBDav, the addon automatically advances to the next available NZB. Smart Play also has its own auto-advance. Badges populate instantly on subsequent requests from cache.	⚡ Instant results, fastest playback start time	Maximum protection — you almost never see a failure screen. Trade-off: you may not always play what you clicked when a normal stream fails. Sessions expire after 72 hours or when you save config changes.

Pre-cache Option

Setting	Behavior
ON	With Smart Play, the fastest-verified NZB is queued to NZBDav immediately. Without Smart Play, the top result is pre-downloaded before you click. Speeds up playback for the top result but may delay other results if NZBDav is busy processing the pre-cached file.
OFF	Nothing is queued until you click. Your click gets NZBDav's full attention.

NNTP Health Check Credentials

Health check: Lightweight verification that the required articles are available.

Archive check: Blocks NZBs that look complete but only contain samples, nested archives, or no playable video.

Stream Status Legend

✅ Green: verified — direct video or stored archive (copy-only). Expected to play.
⚠️ Unverified: articles present but archive not inspected (e.g., 7z). Might or might not play.
🚫 Red: blocked — missing articles or unsupported/compressed archive. Will not play.

Usenet Provider Host Usenet Provider Port Use TLS Usenet Provider Username Usenet Provider Password Number of NZBs to Inspect Pick 2 for the fastest responses, 4 or 6 to probe more candidates. Max Usenet Connections Choose between 4 and 12. Ensure the combined total of these connections plus any NZBDav connections stays within your provider's max.

TMDb Metadata & Localization (Recommended)

When enabled, fetches metadata directly from TMDb (skips Cinemeta) and adds localized title searches for non-English content. Example: A Telugu movie will search with its original Telugu title, English title, and any additional languages you select below.

Enable TMDb Metadata

TMDb API Read Access Token Paste your v4 API Read Access Token from themoviedb.org/settings/api. TMDb requests use this token when metadata is enabled. Search Mode "English only" keeps TMDb searches in English unless you explicitly add languages below. "English + regional" also adds the title in its original language.

TVDB ID Mapping (Recommended)

Enable to resolve TVDB ↔ IMDb IDs for series. This improves ID-based searches when only one of the IDs is available.

Enable TVDB ID Mapping

TVDB API Key Paste your TVDB v4 API key.

Addon Metadata

Addon Display Name Appears in Stremio as the addon title. Public Base URL Stream Token (required - auto-generated if blank) Token embedded in manifest and stream URLs. Since v1.7.6 this is always separate from the admin token and auto-generated on first start. Changing it will update your manifest URL - you may need to reinstall the addon in Stremio.

Authentication

Streaming Mode

Indexer Manager

Direct Newznab Indexers

Built-in Easynews Indexer

Result Sorting & Filters

Stream Naming

NZBDav Connection

Stremio Catalog

Stream Protection

Protection Modes

Pre-cache Option

NNTP Health Check Credentials

Stream Status Legend

TMDb Metadata & Localization (Recommended)

TVDB ID Mapping (Recommended)

Addon Metadata