Which Template?
Import a Template
How It Works
Formatters
Device Profiles
Troubleshooting
Stremio vs WuPlay
Both players work with Core Builds templates, but they behave differently in ways that matter.At a Glance
| Feature | Stremio | WuPlay |
|---|---|---|
| Platform | Windows, Mac, Linux, Android, iOS, Smart TV | Android, Fire TV, Android TV |
| Stream type handling | Some YouTube/external streams slip through | Suppresses these more reliably |
| UI maturity | Polished, well-established | Newer, actively developed |
| Metadata | Excellent (Cinemeta) | Good |
| Deep links | Standard | Extended |
| Offline support | Limited | Better |
| Cost | Free (Stremio+/Web is paid) | Free |
Stream Type Differences
The biggest practical difference between the two players is how they handle YouTube and external-type streams. When Stremio’s native catalog (Cinemeta) finds no streams for a title, it sometimes injects YouTube trailer links or external info cards alongside the AIOStreams results. These appear as clickable “streams” in your list but open a web browser instead of playing video. AIOStreams mitigation (v2.4.6+):- The
Hard YouTube KillESE blockstype(streams, 'youtube'),type(streams, 'external'), and keyword matches excludedStreamSourcesblocks YouTube source variantshideErrors: truesuppresses AIOStreams’ own error cards
Real-Debrid Behaviour
Stremio interacts with RD through its standard addon API. RD’s May 2026 server-side filter causes error cards to appear in the stream list when cached files are flagged —hideErrors: true suppresses these, but the underlying RD streams are gone.
WuPlay processes RD stream responses slightly differently, and community testing shows reduced impact from the RD filter. The Advanced dual-core builds are consistently reported as working better on WuPlay than on Stremio.
Which Should I Use?
Use Stremio if:- You are on a platform where WuPlay is not available (Windows, Mac, Linux, iOS, Smart TV)
- You want the most stable, polished experience
- You primarily use TorBox-only templates (no RD dependency)
- You are on Android, Fire TV, or Android TV
- You use the Hybrid (TorBox + RD) templates
- YouTube/external stream leakage has been a problem for you in Stremio
- You want better handling of niche stream types
Using Both
There is no conflict. You can install the same AIOStreams manifest in both players simultaneously. Many users run Stremio on desktop and WuPlay on a Fire TV Stick — the same template works across both.Formatter Compatibility
Both players fully support AIOStreams formatters. Thename and description fields render correctly in both. WuPlay may display slightly different line heights or wrapping on very long description lines, but all Core Builds formatters are tested on both platforms.
Advanced Editing
Core Builds are designed to be plug-and-play, but you can adjust caching rules, tweak filtering, or edit the raw template JSON. This section covers how to do it safely.Step 1 — Access Your AIOStreams Host
Open your preferred AIOStreams instance and navigate to your existing configuration. You can reach it via the Configure button in Stremio next to the AIOStreams addon, or by visiting your host directly and entering your password.| Rank | Host | URL |
|---|---|---|
| 🥇 | ElfHosted | https://aiostreams.elfhosted.com |
| 🥈 | Yeb’s (ForTheWeak) | https://aiostreams.fortheweak.cloud |
| 🥉 | Midnight’s | https://aiostreamsfortheweebsstable.midnightignite.me |
| 4 | Viren’s | https://aiostreams.viren070.me |
| 5 | Kuu’s | https://aiostreams.stremio.ru |
| 6 | ATBP | https://aio.atbphosting.com |
| 7 | Omni’s | https://aiostreams.12312023.xyz |
Step 2 — Enable Advanced Mode
- Look near the top of the configuration page — usually top-right or just below the main header
- Find the toggle labelled “Advanced Mode” or “Show Advanced Settings”
- Toggle it ON
Step 3 — What Advanced Mode Unlocks
- Raw JSON Editor — directly edit
excludedStreamExpressions, resolution limits, scraper timeouts, and any other config field - Granular Scraper Controls — fine-tune how each addon (Comet, Meteor, MediaFusion, etc.) behaves within the build
- Proxy Configuration — direct access to MediaFlow proxy URLs and credentials
- Synced URL Management — view and edit the external regex and expression URLs your template pulls from
Editing Rules
Quality values must match exactly. AIOStreams only accepts specific enum strings for quality fields. Case matters:| Correct | Wrong |
|---|---|
BluRay REMUX | Bluray REMUX |
BluRay | Bluray |
WEB-DL | WEBDL |
WEBRip | Webrip |
HC HD-Rip | HC HD-RIP |
| Correct | Wrong |
|---|---|
type(streams, 'youtube') | streamType(streams, 'youtube') |
keyword(streams, 'WEB-DL') | filename(streams, 'WEB-DL') |
quality(streams, 'BluRay') | quality(streams, 'Bluray') |
sortCriteria field only accepts recognised sort keys. These are not valid and will throw an import error:
seasonepisode
quality, resolution, cached, seeders, size, age, bitrate, releaseGroup, streamExpressionMatched, seadex, and others listed in the AIOStreams schema.
sortCriteria requires "direction", not "order". AIOStreams rejects "order" on import with a schema validation error even though both names seem intuitive. Always use:
|| not |. In the formatter’s name and description fields, condition separators must be double-pipe ||. A single pipe will cause the expression to fail and render raw template text.
stream.age already includes its unit. In current versions of AIOStreams, stream.age returns the age value with a d suffix already appended (e.g. 10d). Do not add another d in your formatter template or it will display 10dd:
stremthruTorz vs stremthruStore. The debrid provider preset differs by service:
stremthruTorz— TorBox-specific (used in all TorBox templates)stremthruStore— all other debrid services: AllDebrid, Real-Debrid, Premiumize, etc.
stremthruTorz with a non-TorBox API key produces zero streams silently.
Regex patterns — whitelist applies on public instances. If you add custom entries to rankedRegexPatterns, preferredRegexPatterns, or excludedRegexPatterns, hosted AIOStreams instances (elfhosted, fortheweak) only allow patterns whose pattern string exactly matches an entry in their whitelist. Adding a new pattern with a custom regex will be rejected on import with “X/N regexes not allowed” — your pattern must already exist verbatim in the host’s allowed list. See Expression Layer for the full regex architecture reference.
Validate Before Saving
Resetting Your Instance
Sometimes a template import goes wrong, credentials get stuck in a broken state, or you simply want to start completely fresh.Before You Reset — Back Up First
If your instance is still accessible, export your current configuration before doing anything else.- Open your AIOStreams dashboard
- Go to the Template section
- Tap the Export icon (box with outward arrow)
- Save the JSON file somewhere safe
Choosing the Right Reset
| Situation | What to do |
|---|---|
| Template imported wrong settings | Soft reset — re-import over existing config |
| Config is broken but you can still log in | Soft reset or hard reset |
| Forgotten password | Hard reset — Delete User |
| Stremio showing errors after config change | Re-install manifest only |
| Want to switch templates entirely | Soft reset — re-import new template |
| Something is fundamentally broken | Hard reset — Delete User |
Option 1 — Soft Reset (Re-Import a Template)
Re-importing a template replaces your entire configuration without deleting your account or credentials. This is the quickest fix for most problems.- Open your AIOStreams dashboard
- Go to the Template section
- Tap the Import icon
- Paste the raw GitHub URL for your chosen template or select a local file
- Enter your credentials when prompted
- Tap Load Template
- Review that services and addons look correct
- Tap Save
- Copy the new manifest URL and reinstall in Stremio or WuPlay
Option 2 — Hard Reset (Delete User)
Deletes your entire account and configuration. Use this when a soft reset is not enough or when you have forgotten your password.Step 1 — Note your manifest URL (if possible)
Step 1 — Note your manifest URL (if possible)
Step 2 — Delete your user account
Step 2 — Delete your user account
- Open your AIOStreams host in a browser
- Scroll to the very bottom of the configuration page
- Tap Delete User
- Confirm the deletion
Step 3 — Create a new account
Step 3 — Create a new account
- Refresh the page — you will be returned to the initial setup screen
- Enter a new password (or the same one)
- Tap Create User or Register
Step 4 — Re-import your template
Step 4 — Re-import your template
Step 5 — Uninstall the old addon from Stremio
Step 5 — Uninstall the old addon from Stremio
- Open Stremio
- Go to Addons
- Find the old AIOStreams entry and tap Uninstall
- Tap Install on the new manifest URL from your fresh setup
Option 3 — Password Reset
If you have forgotten your password and cannot log in, a full Delete User is the only option on most hosted instances — there is no password recovery email flow. Follow Option 2 above.Reinstalling in Stremio After Any Reset
Any time you reset or change your AIOStreams configuration, your manifest URL changes. The old URL in Stremio will stop returning results. You must reinstall.- Stremio
- WuPlay
- Go to Addons
- Find the old AIOStreams entry — tap Uninstall
- Open your AIOStreams dashboard and copy the new manifest URL
- Paste it into Stremio’s addon search bar or tap Install from the dashboard
Common Problems After a Reset
Import fails with HTTP 404
Import fails with HTTP 404
Import fails with "Invalid template"
Import fails with "Invalid template"
Stremio still showing the old stream list
Stremio still showing the old stream list
Credentials modal does not appear after re-import
Credentials modal does not appear after re-import
NZBGeek not working on ElfHosted / fortheweak (Hybrid template)
NZBGeek not working on ElfHosted / fortheweak (Hybrid template)
Search Criteria
What Is Search Criteria?
When you open a movie or show in Stremio, AIOStreams sends a request to your addons with the title, year, and episode information. Search criteria controls how strictly the returned streams must match that request before they are shown to you. Too strict → zero results on valid content Too loose → wrong content appearing (a movie showing episodes from a show with the same name) All three matching settings live in the same section of the config:Title Matching
Controls whether the stream’s filename must contain the title of the content you’re watching.| Setting | Values | Default (Core Builds) |
|---|---|---|
enabled | true / false | true |
mode | "contains" / "exact" | "contains" |
similarityThreshold | 0.0 – 1.0 | 0.75 |
contains (recommended) — the stream filename just needs to include the title somewhere. “Gladiator.II.2024.2160p…” would match a search for “Gladiator 2”.
exact — the stream filename must match the title almost perfectly. exact mode causes zero results on sequels, films with alternate titles, and anything with punctuation differences. Never use exact for public templates.
Similarity Threshold — how closely the title in the stream filename must resemble the requested title. Only applies in contains mode.
| Threshold | Effect |
|---|---|
1.0 | Perfect match required — same as exact mode effectively |
0.75 | Recommended — handles minor variations, punctuation, romanisation |
0.60 | Loose — may allow unrelated streams with partial title matches |
0.50 | Very loose — not recommended |
Year Matching
Filters streams based on the release year. Prevents you from seeing a 1990 film when you open a 2023 remake with the same name.| Setting | Values | Default (Core Builds) |
|---|---|---|
enabled | true / false | true |
strict | true / false | false |
tolerance | Integer (years) | 2 |
strict: false (recommended) — a stream is allowed if its year is within the tolerance range. A ±2 tolerance means a 2023 film will match streams tagged 2021–2025.
strict: true — streams must match the year exactly. This causes zero results because TMDB and release groups sometimes disagree on release year by 1–2 years, films released at year-end get tagged as the following year, and international releases sometimes use the local premiere year.
Tolerance — how many years either side of the TMDB year are accepted. Only applies when strict: false.
| Tolerance | Effect |
|---|---|
0 | Same as strict: true |
1 | One year either side — can still miss some edge cases |
2 | Recommended — covers all common year discrepancy scenarios |
3+ | Too loose for most content — remakes may collide with originals |
Season / Episode Matching
For series content, controls whether streams must have explicit season and episode metadata matching the episode you’re watching.| Setting | Values | Default (Core Builds) |
|---|---|---|
enabled | true / false | true |
strict | true / false | false |
strict: false (recommended) — streams are allowed through even if they don’t have explicit S/E metadata in the filename. BluRay and REMUX releases frequently omit S/E numbering in filenames, older releases used different naming conventions, and season packs often don’t have per-episode tags.
strict: true — every stream must have a season and episode number that exactly matches the requested episode. This will drop all BluRay REMUXes, most older content, and any stream that uses non-standard episode naming.
Language Settings
| Field | Effect |
|---|---|
requiredLanguages | Hard-requires every stream to match. Streams without any of these languages are dropped completely. |
preferredLanguages | Soft preference used for sorting. Streams with these languages rank higher. Nothing is blocked. |
requiredLanguages: [] (empty) on all templates. This is intentional — hard-requiring languages blocks streams that don’t have language metadata embedded (common in older releases, scene content, and some Usenet uploads) even when the content is perfectly valid English content.
Common Scenarios
| Symptom | Fix |
|---|---|
| Zero results on a specific title | Lower similarityThreshold to 0.65, confirm yearMatching.tolerance is 2, confirm strict: false on both year and season/episode matching |
| Wrong show or movie results appearing alongside correct ones | Increase similarityThreshold to 0.80, confirm yearMatching.tolerance is not too high |
| Older content (pre-2000) returning few results | Lower similarityThreshold to 0.65, increase yearMatching.tolerance to 3, confirm seasonEpisodeMatching.strict is false |
| Anime returning wrong dubs or wrong shows | Lower similarityThreshold to 0.65, ensure SeaDex ISE is enabled, ensure preferredLanguages includes "Dubbed" if dubs are wanted |
| Series returning season packs instead of individual episodes | Confirm the ongoingSeasonPack ESE is enabled, check your TMDB API key is correctly set |
Full Reference Config
The safest, most permissive matching configuration for maximum stream coverage:Catalogs
Catalogs are the browse tabs that appear in Stremio’s Discover screen and on the home page — “Your Movies”, “Your Series”, “Your Anime”, and “Continue Watching” lists. They are separate from stream results and are powered by your debrid service’s library, not the scrapers.Why Templates Ship With Empty Catalogs
Templates shipped through Core Builds default to"mergedCatalogs": []. This is intentional:
- Catalog availability depends on which addons you have enabled and which debrid service you’re using
- TorBox catalog IDs differ from AllDebrid catalog IDs — a pre-filled catalog list from a TorBox template would break for AllDebrid users
- Empty is the safe default — users add the catalogs that match their own setup
Standard Catalog Types
| Catalog | What it shows |
|---|---|
| Your Movies | Movies you’ve cached or downloaded via TorBox |
| Your Series | TV series in your TorBox library |
| Your Anime | Anime titles in your TorBox library |
| Continue Watching — Movies | Movies you’ve started but not finished |
| Continue Watching — Series | Episodes you’ve started but not finished |
How to Add Catalogs
- Open your AIOStreams dashboard and log in
- Scroll down until you see the Catalogs section (usually between Addons and Formatter)
- Click Add Catalog (or the
+button). Each entry has these fields:- Addon — which addon provides this catalog. For TorBox library catalogs, select
LibraryorTorBox - Type — the content type:
movie,series, oranime - ID — the catalog ID string. Common TorBox values:
torbox_movies,torbox_series,torbox_anime
- Addon — which addon provides this catalog. For TorBox library catalogs, select
- Click Save
- Uninstall the old AIOStreams addon from Stremio and reinstall with the new manifest URL — catalog tabs only appear after a fresh manifest install
torbox_movies, torbox_series, torbox_anime. AllDebrid catalog IDs differ — check your AIOStreams instance’s Catalog section after enabling the Library addon to see which IDs are available for your service.Catalogs vs Stream Results
| Catalogs | Stream Results | |
|---|---|---|
| Where they appear | Stremio Home / Discover tabs | Inside a movie or show page |
| What they show | Browsable library lists | Ranked streams ready to play |
| What controls them | mergedCatalogs in config | ESEs, PSEs, sort criteria |
| Updated when | Manifest reinstalled | Every stream request |
| Affected by template import | Yes — reset to template defaults | Yes — all settings replaced |
Troubleshooting
Catalog tabs not appearing after adding them
Catalog tabs not appearing after adding them
- AIOStreams dashboard → copy the new manifest URL
- Stremio → Addons → find AIOStreams → Uninstall
- Paste the new manifest URL → Install
- Restart Stremio
Catalogs appear but are empty
Catalogs appear but are empty
- Go to AIOStreams → Addons → confirm the Library addon is present and enabled
- Add a few files to TorBox first, then refresh the catalog in Stremio
"Your Anime" tab is missing even after adding it
"Your Anime" tab is missing even after adding it
Catalogs disappeared after re-importing a template
Catalogs disappeared after re-importing a template
mergedCatalogs to the template’s defaults. Re-add your catalog entries through the Catalogs section and reinstall the manifest after saving.TMDB & TVDB Keys
AIOStreams uses TMDB (The Movie Database) for title matching, season detection, and metadata enrichment. Without a key, some features degrade silently — season pack filtering stops working, “continue watching” recommendations don’t load, and some marketplace addons refuse to start.Why You Need a TMDB Key
| Feature | Requires TMDB |
|---|---|
| Title matching accuracy | Yes |
Season detection (ongoingSeasonPack ESE) | Yes |
| ”Recommended” content in catalogs | Yes |
| Episode air date awareness | Yes |
| Some marketplace addons | Yes |
"tmdbAccessToken": "<template_placeholder>" and "tmdbApiKey": "<template_placeholder>". These placeholders must be replaced with your real key — the template will not prompt you automatically.
Which Key to Use
TMDB offers two credential types. You only need one.| Read Access Token | API Key | |
|---|---|---|
| Format | Long JWT string (~200 chars) | 32-character hex string |
| Recommended | Yes — use this one | Only if an addon specifically asks for it |
| Where to find | TMDB → Settings → API → Read Access Token | TMDB → Settings → API → API Key (v3 auth) |
eyJ....
Step 1 — Get Your TMDB Read Access Token
- Go to themoviedb.org/settings/api
- If you don’t have an account, register at themoviedb.org/signup — it’s free
- Scroll down to API Read Access Token
- Copy the full token (it’s long — make sure you copy all of it)
Step 2 — Enter It in AIOStreams
- Open your AIOStreams dashboard
- Scroll to the Metadata section (usually near the bottom, below Formatter)
- Paste your Read Access Token into the TMDB Read Access Token field
- Leave the TMDB API Key field blank unless a specific addon asks for it
- Click Save
TVDB — Optional
TVDB is a separate TV-focused metadata database. AIOStreams supports it but does not require it for any Core Builds functionality. You only need a TVDB key if a specific addon you’re using explicitly requires it. To get one:- Go to thetvdb.com and register (free)
- Navigate to your profile → API Keys
- Generate a new API key and paste it into the TVDB API Key field in AIOStreams → Metadata
Troubleshooting
Season packs showing when they shouldn't
Season packs showing when they shouldn't
ongoingSeasonPack ESE uses TMDB data to detect whether a show is currently airing. If your TMDB token is missing or invalid, this ESE stops working — season packs may appear alongside individual episode streams.Fix: enter your TMDB Read Access Token in the Metadata section and save."Recommended" catalog is empty
"Recommended" catalog is empty
An addon says "TMDB API key required"
An addon says "TMDB API key required"
Token resets after re-importing a template
Token resets after re-importing a template