Skip to main content
Master Guide

Steps

1

Pick your template

2

Get the import URL

The Template Directory has Import on ElfHosted and Import on Fortheweak buttons for each template — click to open the template directly in your AIOStreams instance. Or copy the raw URL block to paste into any host manually.
3

Load in AIOStreams

Open your AIOStreams instance → About → Get Started → Load Template → paste the URL → click Load.
4

Enter your API keys

Fill in Services:
5

Save and install

Click Save → copy the manifest URL → install in Stremio or WuPlay.

API Keys

KeyWhere to get itRequired for
TorBox API keytorbox.app → Dashboard → API KeysAll TorBox templates
TMDB Access Tokenthemoviedb.org → Settings → API → Read Access TokenBetter title matching (recommended)
NZBGeek API keynzbgeek.info → My Profile → APIHybrid templates only
AllDebrid API keyalldebrid.com → My Account → APIAllDebrid templates only
EasyNews credentialseasynews.comSpeed EasyNews templates

Updating a Template

Re-import the same URL. AIOStreams will load the latest version and merge it over your existing config. Your API keys are preserved.
Already imported? Check AIOStreams for an in-app update notification — it will prompt you to pull the latest version automatically.

After Importing

MediaFusion and HdHub are enabled by default from v2.9.4. MediaFusion adds regional and international content coverage. HdHub is a TorBox-native P2P scraper that only returns results when TorBox is your active debrid service. Both are stream-only — neither injects catalog rows into Stremio. To disable either, go to Addons and toggle it off.
The NZBGeek (Newznab) preset is included but disabled by default. NZBGeek flags accounts accessed from multiple IP addresses simultaneously — a pattern that occurs on shared hosting (ElfHosted, fortheweak.cloud) where search and download requests can originate from different IPs.To enable on ElfHosted: use the Zyclops proxy — set the proxy URL in the Newznab addon config so both search and grab route through the same IP. Then enter your NZBGeek API key in Add-ons → Newznab.On a private/self-hosted AIOStreams instance: enable the preset, enter your API key, and ensure the built-in NZB grab proxy is active (AIOSTREAMS_AUTH credentials set) so search and grab share the same IP.If you want a Usenet indexer with no IP restrictions on shared hosting, NinjaCentral has publicly confirmed AIOStreams public-instance compatibility.
Go to Add-ons → StremThru AllDebrid and enter your AllDebrid API key.
These exit after 3 cached results or a timeout. Test with a popular title first (e.g. Breaking Bad S01E01).
Cached-only. If a title isn’t in TorBox’s cache you’ll get no results. Use Speed or Essential as a fallback for new releases.

Choosing a Host

elfhosted (paid private)

$9/month — dedicated instance, no rate limits, Torrentio enabled. Best for serious daily use.

fortheweak.cloud

Free — community-run by nhyyeb, stable and nightly builds. Core Builds verified against their allowlist. Best free option.
Not sure? Start with fortheweak (free, no signup) to test your template. Upgrade to elfhosted private if you need Torrentio or want a dedicated instance with no shared load.
elfhosted privatefortheweakelfhosted freeSelf-hosted
Cost$9/monthFreeFreeFree (server cost)
Rate limitsNoneSharedShared + Torrentio disabledNone
TorrentioEnabledEnabledDisabledEnabled
Core Builds verified
Nightly builds
For the full list of public instances, see the AIOStreams public instances page.

Regex and allowlists

Hosted instances validate inline regex patterns against an allowlist. v2.9.0 templates are verified against both elfhosted and fortheweak allowlists — import errors from regex patterns indicate an outdated template.
Hosted (elfhosted, fortheweak.cloud)Self-hosted
Inline regexValidated against host allowlistWorks — all patterns allowed
Synced regex URLsWhitelisted URLs onlyAll URLs allowed
As of v2.9.0, all Core Builds templates are verified against both elfhosted and fortheweak allowlists. If you see a “regex not allowed” error after importing, re-import the latest template version — older templates may contain pattern strings that predate the v2.9.0 allowlist sync.

Stremio vs WuPlay

StremioWuPlay
PlatformDesktop + mobileWeb + Chromecast
InstallationAdd-on URL in StremioDirect stream URL
Best forStandard setupCasting / TV without an app