Setup Guide
Get AIOStreams up and running from scratch using Tamtaro's complete setup.
This guide walks you through a complete AIOStreams setup — from installing your media client to having a fully configured addon ready to use. It uses a curated community template that handles the bulk of the configuration so you only need to fill in your credentials.
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 — Install a Media Client
AIOStreams is primarily designed and maintained for Stremio, but works with other Stremio addon compatible clients as well
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.
The following clients also work with AIOStreams — most via Stremio addon compatibility, and Chillio via its own direct protocol. This guide does not cover their individual setup — refer to each client's own documentation / Discord for help getting started.
| Client | Platforms | Discord |
|---|---|---|
| Fusion | iPhone, iPad, Mac, Apple TV | Join |
| Omni | iPhone, iPad, Apple TV | Join |
| RealStream | Android TV, Desktop (coming soon) | Join |
| Nuvio | Android, Android TV, iOS | Join |
| Chillio | iPhone, iPad, Apple TV | — |
Chillio users: when installing AIOStreams, select Chill Link Protocol (not Stremio) in the install modal.
Step 2 — Get a Debrid Service (Optional)
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 — subsequent requests for the same torrent are served instantly from the cache at high speeds over HTTPS, with no P2P involved on your end.
In Stremio, 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.
A debrid service is optional, but recommended. 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 eliminates this risk entirely, 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
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 — Obtain API Keys
The template uses two free API keys for title and season/episode matching — these filter out incorrectly matched streams.
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.
TVDB (The TV Database)
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 you will be walked through a short import wizard.
Select a template — You will see two options: Tamtaro Complete SEL Setup and Tamtaro Partial SEL Setup. Select Complete. The Partial option is intended for users who already have an existing setup they want to retain parts of. Click Use Selected to continue.
Select services — Choose the debrid service(s) you have (e.g. Real Debrid, TorBox). If you are not using any debrid service, click Skip. Otherwise select your service(s) and click Next.
Template inputs — This step lets you customise the template before it is applied. Every option has a description — read through them and adjust anything you want. Nothing here is required and the defaults are sensible for most users. A few options worth noting:
- Preferred Language — Select your preferred stream language(s). These are placed first in the language ranking. You can fine-tune the full order in Filters → Language after import.
- TorBox Tier (TorBox users only) — Select your TorBox plan: Essential, Standard, or Pro. This applies the correct size limit for uncached downloads. If you are not on TorBox this option will not appear.
- Core Filtering Engine — The default (Standard SEL) is tuned to remove clutter and show a minimal but sufficient set of results across all scenarios. If you prefer more results, switch to Extended SEL.
Once you are happy with the inputs, click Next.
Credential inputs — Enter the API keys for any debrid services you selected, plus the TMDB and TVDB API keys from Step 3. Click Load Template when done.
Want to understand what every option does after import? See Configure Options.
Step 6 — Save and Install
After the template loads you will land on the Save & Install page.
Under Create Configuration, enter a password and click Create. If successful you will see Configuration created successfully and a UUID will be shown. 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" / 401 Unauthorized, double-check your TMDB API key is correct. You can review it in the Services menu under the Metadata section.
An Install card will appear. Click the Install button. A modal will pop up with the following options:
- Stremio — Opens the Stremio app and installs the addon directly. Use this if Stremio is installed on the device you are currently on.
- Stremio Web — Installs via the Stremio web player. Only use this if you are already signed in to Stremio Web — otherwise it will install to a guest account and your progress won't sync.
- Manifest URL — A text box with a copy button. Use this to install manually: open Stremio, go to Addons, click + Add Addon, and paste the URL. (Not available on all platforms.)
Chillio users: use the Protocol selector on the right of the Install card to switch to Chill Link Protocol before clicking Install.
A Stremio pop-up will ask whether to install the addon. Click Install. You are now set up — click on any title in Stremio and results should appear.
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.
Making Changes
To edit your configuration after installation:
- In Stremio, click Configure next to the AIOStreams addon.
- Or navigate to
https://your-instance/stremio/configureand log in with 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 discussion post for questions specifically about this template. If you're stuck on something with this setup, this is the best place to ask.