Skip to content

Self-Hosted Stremio add-on to track debrid days left with smart warnings & quotes.

License

Notifications You must be signed in to change notification settings

elfhosted/Statusio

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

15 Commits
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Statusio Title


Statusio — Debrid Account Status

A Self-Hosted Stremio Add-on

Developed by A1337User

A tiny, self-hosted Stremio add-on that shows your premium status & days remaining for multiple debrid providers as a single info card in the Streams tab.

Note: Statusio will run on a server soon, stay tuned.


Table of Contents


Overview

This add-on renders a single info card in the Streams tab for movies/series/channel/tv indicating your debrid account status:

  • OK — active premium until YYYY-MM-DD
  • 🟡 Warning≤ 14 days remaining
  • 🟠 Critical≤ 3 days remaining
  • 🔴 Expired — 0 days remaining (or not premium)

It runs locally—no remote server required.

Screenshot

Statusio

(Example layout shown; provider list & text update dynamically.)


Supported Providers

  • Real-Debrid (token: rd_token or RD_TOKEN)
  • AllDebrid (key: ad_key or AD_KEY)
  • Premiumize (key: pm_key / PM_KEY; supports apikey or access_token)
  • TorBox (token: tb_token or TB_TOKEN)
  • Debrid-Link (key: dl_key or DL_KEY; Bearer or ?apikey=)

You can enable one or many providers. The card shows a tidy line per provider.


Features

  • Local self-hosting with Node.js
  • Multi-provider support in one card
  • Config UI inside Stremio (tokens, provider enable/disable)
  • ENV fallback for quick testing (RD_TOKEN, AD_KEY, PM_KEY, TB_TOKEN, DL_KEY)
  • Demo Mode (all_active / some_off) to preview without tokens
  • Small in-memory cache to avoid API spam
  • Compact 6–8 line display with friendly quotes and renewal nudges

Requirements

  • Windows (commands below use CMD)
  • Node.js (LTS recommended) → https://nodejs.org
  • At least one debrid API token/key

Important

If a token is saved in Configure, it is used first. Otherwise, the server falls back to any ENV variable you set in the CMD session.


Folder Location

Use your real path. Example path used in these instructions:

C:\Users\a1337user\Desktop\Stremio Addons\Development\Statusio


Quick Start (Windows • CMD as Administrator)

  1. Open CMDRun as Administrator

  2. Change directory to your add-on folder:

cd "C:\Users\a1337user\Desktop\Stremio Addons\Development\Statusio"
  1. (Optional) Nuke and old Node process, just in case:
taskkill /IM node.exe /F

(If “not found,” that’s fine—proceed.)

  1. First time only — init & install
npm init -y
npm i stremio-addon-sdk node-fetch
  1. Start the add-on — example with Real-Debrid only:
set RD_TOKEN=PASTE_REALDEBRID_API_TOKEN_HERE && node index.js

Enter your API Token to proceed 6. You should see something like:

Statusio at http://127.0.0.1:7042/manifest.json

Install in Stremio Web/Desktop

Stremio Web (if allowed by browser)

  1. Open
https://web.stremio.com/#/addons?
  1. Click Install via URL (+ Add).

  2. Paste your local URL (from CMD), e.g.:

http://127.0.0.1:7042/manifest.json
  1. Open the add-on card → Configuration.

  2. Paste your token(s) → SaveInstall.

  3. Browser may prompt to open the Desktop app; accept and finish install there.

Stremio Desktop (recommended for lcoalhost)

  1. Open the Stremio Desktop app.

  2. Add-ons → Community → Install via URL.

  3. Paste:

http://127.0.0.1:7042/manifest.json
  1. Open the add-on → Configure → paste token(s) → SaveInstall

[!NOTE] If Stremio Web blocks http:// localhost (mixed content), use the Desktop app for local testing.

Configuration (Tokens, Demo Mode, Options)

Inside the add-on Configure panel:

  • providers_enabled: select one or more (Real-Debrid, AllDebrid, Premiumize, TorBox, Debrid-Link)

  • cache_minutes: default 10

  • rd_token / ad_key / pm_key / tb_token / dl_key: paste your credentials

  • pm_auth: apikey (default) or oauth (uses access_token)

  • dl_auth: Bearer (default) or query to append ?apikey=...

  • dl_endpoint: override if Debrid-Link changes endpoint

  • demo_mode: off / all_active / some_off

ENV fallbacks (optional):

  • RD_TOKEN, AD_KEY, PM_KEY, TB_TOKEN, DL_KEY, PORT

Examples:

set RD_TOKEN=xyz && set PORT=7050 && node index.js
set AD_KEY=abc && set PM_KEY=pm123 && node index.js

Test the Card

  1. Open any movie (or series/channel/tv).

  2. Go to Streams.

  3. Look for Statusio (info card).

Expected titles / states

  • OK — plenty of time left (≥ 15 days)

  • 🟡 Warning≤ 14 days

  • 🟠 Critical≤ 3 days

  • 🔴 Expired0 days or not premium

Nuke & Fix (Wrong Token / Stuck State)

  1. Kill Node (clean restart)
taskkill /IM node.exe /F
  1. Clear env token(s) if you set them in this CMD session:
set RD_TOKEN=
set AD_KEY=
set PM_KEY=
set TB_TOKEN=
set DL_KEY=
  1. Relaunch with the correct token(s)
cd "C:\Users\a1337user\Desktop\Stremio Addons\Development\Statusio"
set RD_TOKEN=PASTE_CORRECT_TOKEN_HERE && node index.js
  1. If Stremio looks stale
  • Uninstall the add-on and reinstall via URL, or
  • Bump manifest.version in index.js (e.g., 1.0.2 → 1.0.3) and restart Node.

Troubleshooting

[!WARNING] “Configure your tokencard No token detected. Paste a token in Configure, or launch with an ENV token (e.g., RD_TOKEN).

Config feels ignored

  • Verify you installed from the same URL/port you’re running.

  • Uninstall duplicate add-on installs (old ports/IDs).

  • Keep manifest.id stable between runs.

  • Clear env vars so you only test what’s saved in Configure.

Port already in use

set PORT=7010 && set RD_TOKEN=YOUR_TOKEN && node index.js

Then install from:

http://127.0.0.1:7010/manifest.json

Stremio Web can’t reach localhost

  • Use Stremio Desktop for local testing, or run your add-on over HTTPS.

Notes & Tips

  • Appears as an info card in Streams (no playback links).

  • Default manifest includes ["movie","series","channel","tv"]. Trim if you want fewer surfaces.

  • Treat tokens like passwords; never commit them to Git.

  • Demo Mode is perfect for UI checks without real tokens.

  • Quotes rotate to keep the card friendly, fun, and safe.


Credits

  • Developed by A1337User

  • Built with stremio-addon-sdk and node-fetch


License

This project is provided “as-is,” without warranty of any kind. Review and adapt to your use-case and jurisdiction. See LICENSE if provided.

About

Self-Hosted Stremio add-on to track debrid days left with smart warnings & quotes.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • JavaScript 100.0%