Sootio isn’t just another Debrid addon — it’s an intelligent search and prioritization engine for Stremio, built to deliver the highest quality, instantly streamable cached torrents from your Debrid service.
-
⚡ Instant Debrid Streaming
Searches only for torrents already cached on your Debrid provider’s servers — no waiting, no buffering. -
🧠 Smart Tiered Prioritization
Always see the best links first. Streams are sorted in tiers:
Remux > BluRay > WEB-DL > Lower-quality rips. -
🔍 Multi-Source Scraping
Queries multiple torrent sources in parallel, including Jackett, Torrentio, Zilean, Bitmagnet, and more. -
⚙️ Advanced Filtering & Control
Configure granular rules in.env, such as:- Skip low-quality groups (e.g., YTS/YIFY).
- Filter out AAC/Opus audio codecs.
- Balance H.264 vs H.265 results.
- Set per-quality limits for results.
-
🚀 Early Exit Optimization
Stops searching as soon as enough high-quality results are found — faster responses, fewer wasted API calls. -
☁️ Personal Cloud Search
Seamlessly integrates torrents from your Debrid cloud. -
🎬 Accurate Year Filtering
Prevents mismatched torrents (wrong sequels/remakes) by cross-checking release years.
When you search for a movie or episode:
- Scrape All Sources → Sends parallel requests to all enabled scrapers.
- Group & Rank → Categorizes results by quality & resolution.
- Process in Tiers → Starts cache checks with the highest-quality tier first.
- Filter & Limit → Applies your filtering rules (e.g., codecs, result caps).
- Early Exit → Immediately returns top-quality results once thresholds are met.
The result: streams are always ordered from best → worst, with reliability and quality prioritized.
# Clone the repository
git clone https://github.com/your-username/sootio-stremio-addon.git
cd sootio-stremio-addon
# Install dependencies
npm install
# Configure environment
cp .env.example .env
# Edit .env with your settingsnpm startOpen the URL shown in terminal (e.g. http://127.0.0.1:PORT), enter your API key, and click Install Addon.
All options are set via .env.
| Variable | Description | Default |
|---|---|---|
DEBRID_PROVIDER |
Debrid service (RealDebrid, OffCloud, AllDebrid, etc.) |
RealDebrid |
DEBRID_API_KEY |
API key for your Debrid provider | — |
MAX_RESULTS_REMUX |
Max Remux results per resolution | 4 |
MAX_RESULTS_BLURAY |
Max BluRay results per resolution | 4 |
MAX_RESULTS_WEBDL |
Max WEB-DL results per resolution | 2 |
PRIORITY_SKIP_WEBRIP_ENABLED |
Skip WEBRip/BRRip releases | true |
PRIORITY_SKIP_AAC_OPUS_ENABLED |
Skip AAC/Opus audio codecs | true |
DIVERSIFY_CODECS_ENABLED |
Enforce codec balancing | true |
MAX_H265_RESULTS_PER_QUALITY |
Max H.265 results per tier | 2 |
MAX_H264_RESULTS_PER_QUALITY |
Max H.264 results per tier | 2 |
RD_DEBUG_LOGS |
Enable verbose debugging logs | false |
You can enable an optional MongoDB-backed cache that stores information about cached magnets discovered on Debrid providers (Real-Debrid, OffCloud, TorBox). This reduces repeated API calls and speeds up queries. Entries expire automatically after a configurable TTL.
MONGO_CACHE_ENABLED– set totrueto enableMONGO_URI– connection string (e.g.mongodb://localhost:27017)MONGO_DB_NAME– database name (defaultsootio)MONGO_CACHE_COLLECTION– collection name (defaultmagnet_cache)MONGO_CACHE_TTL_DAYS– TTL in days for entries (default30)
If disabled or not configured, the addon behaves as before (including optional Real-Debrid file cache).
-
Only Real-Debrid and OffCloud currently support cache checking via torrent hashes.
Other providers fall back to personal cloud search. -
Torrent hashes are cached locally to reduce API calls and improve speed.
Initial searches on rare releases may take up to 30 seconds.
Contributions, issues, and feature requests are welcome!
Feel free to check the issues page.
Credit to @MrMonkey42 for the original Stremio Debrid Search addon, which Sootio builds upon.
This project is licensed under the MIT License.