UsenetStreamer Control Panel

Streaming Mode

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

Indexer Manager

Manager Type Manager URL 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.

Direct Newznab Indexers (Optional)

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). Recommended.

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

Release Exclusions Comma-separated list of items to exclude from results. Click "Show Examples" for available options.

Exclude Releases Containing (comma-separated) Add codecs, sources, audio, flags, or groups to exclude. Case-insensitive.

Show Examples & Available Options

Video Codecs

x264, x265, h264, hevc, xvid, mpeg2, vp8, vp9, av1

Sources (Quality)

cam, telesync, telecine, scr, dvdscr, dvdrip, hdtv, pdtv, web-dl, webrip, webcap, bdrip, brrip, bluray, remux, uhdrip, hdrip, vhsrip, sdtv, tvrip, vodr, workprint

Audio Codecs

aac, ac3, eac3, mp3, flac, truehd, atmos, dts lossy, dts lossless, dd

Visual Tags

hdr, hdr10, hdr10+, dv, sdr, 3d, 10bit, 8bit

Flags

hardcoded, proper, repack, hdr, extended, remastered, unrated, remux, retail

Release Groups

yify, rarbg, evo, eztv

Use actual group names from releases

Release Preferences (Optional) These preferences are used by Sorting Priority when the matching key is present.

Preferred Quality Source (optional) Quality here means source/release type (e.g. REMUX, BluRay, WEB-DL), not resolution. Preferred Encodes (optional) Preferred Release Groups (optional) Preferred Visual Tags (optional) Preferred Audio Tags (optional) Preferred Keywords (optional) Comma-separated title keywords used in custom sorting only.

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 NZBDav API Key WebDAV URL WebDAV User WebDAV Password Base Category Movies Category Series Category Completed Catalog Items Show last completed NZBs in the catalog (0 = off).

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 Keep this ≤ 2 × “Number of NZBs to Inspect”, and ensure the combined total of these connections plus any NZBDav connections stays within your provider’s max.

TMDb Metadata & Localization (Optional)

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 (Optional)

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 (Optional)

Built-in Easynews Indexer

Result Sorting & Filters

Video Codecs

Sources (Quality)

Audio Codecs

Visual Tags

Flags

Release Groups

Stream Naming

NZBDav Connection

Stream Protection

Protection Modes

Pre-cache Option

NNTP Health Check Credentials

Stream Status Legend

TMDb Metadata & Localization (Optional)

TVDB ID Mapping (Optional)

Addon Metadata