Introduction
What is Stremio?
MediaFusion: The Powerhouse Addon
How MediaFusion Connects to Real-Debrid (OAuth Device Code Flow)
- In Stremio, go to the MediaFusion addon settings (gear icon -> Configure).
- For Real-Debrid, click the "Authorize with Real-Debrid" button.
- MediaFusion's backend requests a device code from Real-Debrid's device authorization endpoint.
- Real-Debrid responds with a user code and a verification URL (e.g., https://real-debrid.com/device).
- MediaFusion displays this user code and URL in Stremio.
- You open the verification URL on a separate device (phone or computer), log in to Real-Debrid, and enter the user code.
- Real-Debrid validates the code, generates an access token (and refresh token), and sends it securely to MediaFusion's backend.
- MediaFusion stores the token securely and generates a manifest URL that you copy into Stremio to complete the addon setup.
- The user code is short-lived and expires quickly.
- You enter your Real-Debrid credentials only on the official Real-Debrid website, not in the addon.
- The token granted to MediaFusion is scoped to your Real-Debrid account and can be refreshed or revoked without exposing your password.
Real-Debrid: How It Works and Why It's Better Than P2P
- It downloads the torrent to its own high-bandwidth seedboxes (servers in data centers).
- It caches the downloaded files on its CDN edge storage.
- When you request playback, it serves the file via a direct HTTP(S) download from its CDN.
Security Advantages Over Pure P2P
- No IP exposure to peers: Since the download comes from Real-Debrid's servers, other peers in the torrent swarm never see your IP address.
- No seeding required: You don't upload (seed) any pieces, eliminating the risk of inadvertently sharing copyrighted content.
- HTTPS encryption: All traffic between you and Real-Debrid's CDN is encrypted, preventing ISP throttling or snooping on the content.
Performance Advantages Over Pure P2P
- Cached on high-speed servers: Files are already downloaded and stored on fast infrastructure, removing dependence on seeder availability.
- Single-source HTTP download: You get the file from one reliable source, avoiding swarm bottlenecks and seeder churn.
- No swarm congestion: Popular content is served instantly from cache; less common items still benefit from dedicated seedboxes.
The Alternative: COMET Addon (API Key Method)
- You obtain an API token from Real-Debrid's website.
- You paste that token into MediaFusion's configuration.
- MediaFusion uses the token to sign requests and generate its manifest URL.
- The API token is a static secret; if leaked (via logs, screenshots, or accidental sharing), anyone can use it to access your Real-Debrid account until you revoke it.
- The token typically grants full access to your debrid account with no scoped permissions.
- There's no automatic token renewal; you must manually renew it.
Comparison: Stremio Stack vs. Traditional Streaming
| Aspect | Stremio + MediaFusion + Real-Debrid | Traditional SVOD (Netflix, Disney+, etc.) |
|---|---|---|
| Content Source | Aggregates torrents, Usenet, public indexers, debrid caches; user-controlled sources. | Licensed catalogs owned/licensed by the provider. |
| Delivery Mechanism | Direct HTTP(S) download from debrid CDN (or P2P if debrid not used). | Adaptive bitrate streaming via proprietary CDNs (HTTPS/DASH/HLS). |
| User Control | Choose which indexers/debrids to enable; self-host options; add/remove sources freely. | Fixed library; no user-added sources. |
| Privacy/IP Exposure | With debrid: IP hidden from peers; no seeding. Without debrid: IP exposed to swarm (optional). | User IP visible only to the service (standard for any web service). |
| Cost | Debrid subscription (e.g., Real-Debrid ~3 EUR/month) + optional hosting; Stremio/MediaFusion free. | Subscription fee (~$10-$20/mo per service). |
| Legality | Depends on source material; user responsible for ensuring content is legally obtained. | Fully licensed, legal by design. |
Security & Privacy Checklist
- Enable two-factor authentication (2FA) on your Real-Debrid account.
- Regularly rotate any API tokens if you use the API-key method (and prefer the device-code flow).
- Consider using a VPN if you want to hide your traffic from your ISP, though HTTPS already encrypts the content.
- Keep your Stremio, MediaFusion, and any other addons updated to benefit from security patches.
- Review addon permissions periodically and revoke any you don't recognize.
Getting Started
- Stremio: https://www.stremio.com/
- MediaFusion GitHub: https://github.com/mhdzumair/MediaFusion
- Real-Debrid device authorization: https://real-debrid.com/device