Skip to content

sooti/stremio-addon-debrid-search

 
 

Repository files navigation

Sootio Logo

Sootio - A Smart Stremio Debrid Addon

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.

Build Status License


✨ Features

  • 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.


🛠️ How It Works

When you search for a movie or episode:

  1. Scrape All Sources → Sends parallel requests to all enabled scrapers.
  2. Group & Rank → Categorizes results by quality & resolution.
  3. Process in Tiers → Starts cache checks with the highest-quality tier first.
  4. Filter & Limit → Applies your filtering rules (e.g., codecs, result caps).
  5. 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.


🚀 Installation

Prerequisites

Steps

# 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 settings

Run the Addon

npm start

Add to Stremio

Open the URL shown in terminal (e.g. http://127.0.0.1:PORT), enter your API key, and click Install Addon.


⚙️ Configuration

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

MongoDB Cache (Optional)

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 to true to enable
  • MONGO_URI – connection string (e.g. mongodb://localhost:27017)
  • MONGO_DB_NAME – database name (default sootio)
  • MONGO_CACHE_COLLECTION – collection name (default magnet_cache)
  • MONGO_CACHE_TTL_DAYS – TTL in days for entries (default 30)

If disabled or not configured, the addon behaves as before (including optional Real-Debrid file cache).


⚠️ Notes & Current Issues

  1. Only Real-Debrid and OffCloud currently support cache checking via torrent hashes.
    Other providers fall back to personal cloud search.

  2. Torrent hashes are cached locally to reduce API calls and improve speed.
    Initial searches on rare releases may take up to 30 seconds.


🤝 Contributing

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.


📝 License

This project is licensed under the MIT License.

About

Stremio Addon to search downloads and torrents in your Debrid cloud

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 99.9%
  • Dockerfile 0.1%