Setup Guide
Get AIOStreams up and running from scratch using Tamtaro's complete setup.
This guide walks you through a complete AIOStreams setup, from choosing where you'll watch to a configuration ready to use in Stremio and the AIOStreams app. It uses a community template that does most of the configuration for you, so you mostly pick options and fill in your keys.
Template Credits
This guide uses a template built and maintained by Tam-Taro (@tam.taro on Discord), who has spent countless hours perfecting their Stream Expression Language filtering and sorting. It also incorporates Vidhin's Regex Patterns, which bring the Trash Guides release group rankings into AIOStreams.
If you find this useful, consider supporting them:
- Tam-Taro: ko-fi.com/tamtaro
- Vidhin: ko-fi.com/vidhin
Just want a reference for every option? See Configure Options.
Step 1: Choose where you'll watch
One configuration serves all of these at once, so you can start with one and add another later.
Go to stremio.com/downloads and download the version for your platform (Stremio supports most platforms, but I would recommend doing the initial setup on a PC or laptop).
Go to the Addons page (puzzle-piece icon) and uninstall Watchhub. It serves ads and is not useful for most setups.
Stremio is account-based: your addons, watch history, and continue watching all sync automatically. You can do this initial setup on your PC or laptop and then just sign in to the same account on your TV, phone, or any other device and everything will already be there.
Step 2: Get a debrid or Usenet service
A debrid service is a paid service that maintains a large cache of torrents on its own servers. When a torrent is first requested, the debrid service downloads it once and keeps it cached. Later requests for the same torrent are served instantly from the cache at high speeds over HTTPS, with no P2P involved on your end.
Streams from debrid-enabled addons are labelled as either cached (available instantly) or uncached (needs to be downloaded to the debrid service first before you can stream it). For popular content, the vast majority of results will already be cached.
In Stremio, a service is optional but recommended. The AIOStreams app needs one, since it doesn't play P2P torrents. P2P streams work without one, provided there are enough seeders, but in many countries (including Germany and the United States) torrenting without a VPN exposes you to ISP warnings, throttling, or fines. A debrid service avoids this, since you stream over HTTPS from the debrid provider's servers. Using one also gives you:
- Instant streaming of cached content at high speeds (4K, HDR, Dolby Atmos without buffering)
- No reliance on seeders
- No VPN required
Usenet works too, through Easynews, TorBox or your own Usenet provider: see the Usenet guide.
If you choose to use P2P streams without a debrid service and without a VPN, be aware that your ISP can see your torrent traffic. In some countries this can result in warning letters, throttling, or fines. Check the rules in your country before proceeding.
Step 3: Get a TMDB API key
The template uses a TMDB key for title and season/episode matching, which filters out streams for the wrong title or episode. A TVDB key is optional. Some instances provide a TMDB key of their own: the template then says so, and you can leave the field blank.
TMDB (The Movie Database)
Go to themoviedb.org and create a free account (or sign in).
Open Account Settings → API and click Create to request a key. Choose Developer when asked for the application type.
None of the information on the form needs to be accurate. You can use a temporary email address, a fake name, and a made-up phone number. None of it is verified.
Copy your API Key from the API settings page: the 32-character key, not the Read Access Token.
TVDB (The TV Database, optional)
Go to thetvdb.com and create a free account (or sign in).
Navigate to API Information and generate a new API key.
Step 4: Open the template
Select a public instance below and click Open Template. This takes you directly to that instance's configuration page with the template pre-loaded.
Not sure which instance to pick? See Public Instances for a comparison. Yeb's is the recommended starting point for most users. ElfHosted is a reliable and reputable option but the public instance disables P2P, HTTP, and Live stream types. If you need those, consider a private ElfHosted instance (paid, no restrictions, relaxed rate limits, direct ElfHosted support, and 33% of your subscription goes to the developer).
Select an instance to open the setup template on:
Opens https://aiostreams-nightly.fortheweak.cloud/stremio/configure with the template pre-loaded.
Step 5: Import the template
After clicking Open Template, the configure page opens with a short setup that follows the steps on its left.
Confirm Import: because the template comes from a link, AIOStreams asks first. Check it is Tamtaro Complete SEL Setup by Tamtaro, then click Use This Template Now.
Services: tick the services you have, under Debrid and Usenet, then click Continue. Without a service, click I don't use any of these and the template sets itself up for P2P.
Options: every option has a description, and the defaults suit most people. A few worth a look:
- Required Languages: the languages you watch in. Streams in other languages are left out, apart from ones tagged Original, Dual Audio, Multi, Dubbed or Unknown, unless you also turn on Strict Language Filtering.
- Formatter Style: how streams are named. Pick the style made for your app if there is one, such as AppleTV or Chillio.
- TorBox Tier (TorBox only, required): your plan, which sets the size limit for uncached downloads.
- Setup Variants: Include Variants adds extra install links on the Save & Install page, such as Debrid Only and Usenet Only.
Show 10 advanced options has the finer controls. Click Continue.
Credentials: the API key for each service you picked and your TMDB key from step 3. TVDB is optional. Click Continue.
Review: the addons, services and credentials the setup will apply. Click Apply setup. Nothing is saved until the next step.
Want to understand what every option does after import? See Configure Options.
Step 6: Save and install
After the setup is applied you land on the Save & Install page.
Under Create Configuration, enter a password twice and click Create. Your UUID appears under Save Configuration. Save both your UUID and password somewhere safe: there is no way to recover them if lost.
If you see an error like "Failed to fetch manifest for <addon>", go to the Addons menu and disable the addon mentioned in the error, then try clicking Create again. This is usually a temporary issue with that addon: you can re-enable it and save again later once it recovers.
If you see "Failed to validate TMDB API Key", double-check your TMDB API key is correct. You can review it in the Services menu under the Metadata section.
Install to Stremio? opens next. Sign in with your Stremio account (an email and password, or an auth key) and AIOStreams installs itself there and updates itself whenever you save. It's optional: Not now closes it.
Installation Options has everything else:
- Stremio: Install to Stremio opens the Stremio app on this device, Install to Stremio Web installs through Stremio Web (only if you are signed in there, or it installs to a guest account), and Direct Manifest URL is the link for installing by hand, in Stremio or any app that supports Stremio addons.
- AIOStreams app: Open in browser opens the app right away, and the buttons beside it get the app for your computer, Android device or TV. See the AIOStreams app guide.
- Other apps: Seanime, Jellyfin apps, Chillio and Aniyomi, each with its own instructions.
Click Export in the Backups section to download a JSON copy of your configuration. You can use this to restore or transfer your setup later.
Step 7: Add catalogs and metadata
The template brings streams but no catalogs. AIOMetadata adds them, along with each title's details. Configure it first: Tamtaro's AIOMetadata guide has ready-made configurations to start from. Where it goes depends on where you watch.
Install AIOMetadata in Stremio on its own, next to AIOStreams, as Tamtaro's guide describes.
Stremio then asks AIOMetadata directly, so your changes there show up straight away. Inside AIOStreams, its catalogs would pass through AIOStreams' cache, which on a public instance the instance's owner controls, not you.
Making changes
To edit your configuration after installation:
- In Stremio, click Configure next to the AIOStreams addon.
- Or go to
https://your-instance/stremio/configure, click Sign In and enter your UUID and password.
Once you've made your changes, go to Save & Install and click Save.
Most changes apply immediately without reinstalling. Only reinstall if a pop-up appears telling you to.
Getting help
Run into something not covered here? Come join the Discord server.
- #support: general AIOStreams questions and issues.
- #setups: Tam is active on the server and has a dedicated forum for questions specifically about this template. If you're stuck on something with this setup, this is the best place to ask.