A Stremio addon that takes you to the discussion for whatever you're watching in one click. Pick an episode or a movie, and Discussio sends you straight to where people are actually talking about it — the right venue for the kind of content, not a generic web search.
- One-click discussions for anime, TV series, and movies
- Venue-aware routing — each content type points at where its discussion really lives:
- Anime → the exact r/anime episode discussion thread
- TV series → the show's own subreddit episode-discussion thread
- Movies → the film's Letterboxd page, plus the r/movies official discussion
- Precise anime matching — queries quote r/anime's thread title format (
Season 2 - Episode 3 discussion), and long-running shows split into seasons (One Piece) also match by absolute episode number - Every anime id — Kitsu, MyAnimeList, AniList and AniDB ids, plus anime served under IMDB ids (auto-detected)
- TMDB movies deep-link straight to Letterboxd
- Install page with one-click install (
stremio://), Stremio Web install and copy-URL - Public anonymous stats page (
/stats) — views, clicks, click-through per destination, top titles; no PII - No configuration needed
Open https://discussio.elfhosted.com and click Install in Stremio, or add this URL inside Stremio → Addons → "Add addon":
https://discussio.elfhosted.com/manifest.json
Hosted free of charge by ElfHosted.
git clone https://github.com/ReemX/Discussio.git
cd Discussio
deno task dev
# Then in Stremio (desktop app), add: http://127.0.0.1:7000/manifest.jsonUse the Stremio desktop app for local testing — the web app is served over HTTPS and blocks
http://localhostaddons (mixed content).
| Task | What it does |
|---|---|
deno task dev |
Run with file watching |
deno task start |
Run for production |
deno task test |
Unit tests for id parsing and routing |
deno task check |
Type-check, lint and test (what CI runs) |
Open any episode or movie, open the Streams list, and pick a Discussio entry:
| Content | Streams |
|---|---|
| Anime episode | 💬 r/anime · Episode discussion |
| TV episode | 💬 Reddit · Episode discussion |
| Movie | 🎬 Letterboxd · Reviews & discussion, 💬 r/movies · Official discussion |
| Anime film | 💬 r/anime · Movie discussion, 🎬 Letterboxd · Reviews & discussion |
| Content | Destination | Method |
|---|---|---|
| Anime episode / film | r/anime thread | Google, quoted thread-title phrase, scoped to site:reddit.com/r/anime |
| TV series episode | show's subreddit thread | Google with season/episode + episode title, scoped to site:reddit.com |
| Movie | Letterboxd film page | direct deep-link by IMDB or TMDB id |
| Movie | r/movies official discussion | Google scoped to site:reddit.com/r/movies |
Why Google search pages, not a direct jump? Google's "I'm Feeling Lucky"
(btnI) now stops on a Redirect Notice page — the same one click as the
results page, but without a fallback when the top hit is wrong. Reddit's own
search ranks discussion threads far worse, and Reddit blocks keyless server-side
lookups, so a precise Google query is the most reliable path.
Anime detection: ids prefixed kitsu: / mal: / anilist: / anidb: are
anime by definition. IMDB-id content is treated as anime when its Cinemeta
metadata is animation and the country includes Japan.
Anime titles: Kitsu's English alias is preferred over the romaji name, and
per-season Kitsu entries ("Sousou no Frieren 2nd Season") are mapped to
r/anime's Season 2 - Episode N phrasing.
Anonymous usage counters are exposed at:
https://discussio.elfhosted.com/stats— human-readable pagehttps://discussio.elfhosted.com/stats.json— machine-readable JSON
Tracked: views (a Discussio stream list was shown), clicks (a discussion link was opened), click-through, clicks per destination, per-day counts (last 30 days) and the top 25 titles. No IPs, no user agents, no identifiers. Stats are cached for 60 seconds.
Clicks are counted because stream links point at /go/..., which redirects to
the destination. The target is rebuilt server-side (never read from the URL, so
it can't be used as an open redirect), which also means routing improvements
reach stream lists Stremio has already cached.
Stats are always counted in memory and, when Redis is configured, flushed to it
once a minute as a single EVAL:
| Variable | Backend |
|---|---|
REDIS_URL |
Native Redis / Valkey: redis://[[user]:password@]host[:port][/db] (rediss:// for TLS). Preferred. |
UPSTASH_REDIS_REST_URL + UPSTASH_REDIS_REST_TOKEN |
Upstash over REST (~45K commands / ~0.5 GB a month per replica, inside the free tier) |
Every replica flushes only its own increments, which Redis adds atomically, so totals are exact across replicas and restarts. Each batch carries an id that the script records atomically, so a retry after a timeout (when Redis may already have applied the batch) is never counted twice; unconfirmed batches are kept and retried in order. If Redis is unreachable, the addon keeps serving and the stats page shows the serving instance's own counts. Without Redis, stats cover only the instance that served the page, since it was last started.
- Built with Deno and TypeScript, native
Deno.serve(no SDK runtime dependency) src/discussio.ts— pure routing logic (id parsing, title picking, queries, streams), unit-tested insrc/discussio_test.tssrc/addon.ts— HTTP server, metadata cache, HTML pagessrc/stats.ts— counters, with optional Redis persistence;src/redis.tsis a minimal dependency-free native Redis client- Metadata sources, all keyless:
tt→ Cinemeta (https://v3-cinemeta.strem.io)kitsu/mal/anilist/anidb→ Kitsu addon (https://anime-kitsu.strem.fun)tmdbmovies → Letterboxd id deep-link (no meta fetch needed)
- Compact LRU + TTL cache (5000 titles × 24h; only the fields routing needs are kept) + short negative cache + in-flight request de-duplication
- Responses are cached 24h; fallback responses (metadata unavailable) only 5 minutes
- The manifest claims no
idPrefixes, so Stremio offers every series/movie id and unroutable ids get an empty answer. Stremio never refreshes an installed manifest, so this lets new id schemes reach existing installs without a reinstall - The manifest is served
no-cacheso a fresh install always gets the current copy - Default port:
7000(override withPORT), log level viaLOG_LEVEL(0=debug …3=error)
| Path | Description |
|---|---|
/ |
Install page |
/manifest.json |
Stremio addon manifest |
/stream/series/:id.json |
Stream handler for series / anime episodes |
/stream/movie/:id.json |
Stream handler for movies / anime films |
/stats |
Public stats page |
/stats.json |
Public stats JSON |
/go/:type/:id/:venue |
Counts a click and redirects to the destination |
/healthz |
Health check |
- Added: click tracking via
/goredirects; the stats page shows views, clicks, click-through and clicks per destination. - Added: top titles show names instead of raw ids.
- Changed: stats persist to Redis (
REDIS_URL, or Upstash via its REST env vars), summing all replicas exactly; otherwise they are per-instance and in memory. Deno KV is no longer used (production never had a persistent volume, so stats reset on every deploy).
- Added: install page with one-click Stremio install, Stremio Web install and copy-URL.
- Added: MyAnimeList, AniList and AniDB ids (via the Kitsu addon), and TMDB movie ids (→ Letterboxd).
- Changed: the manifest no longer restricts
idPrefixes, so future id support is server-side only. Existing users: install once more to pick this up (Stremio keeps the manifest from install time) — it's the last reinstall needed. - Added: movies get a second link to the r/movies official discussion; anime films also link to Letterboxd.
- Improved: anime queries quote r/anime's exact thread-title phrase, map Kitsu season entries to
Season N, and fall back to absolute numbering for long-runners — e.g. One Piece no longer lands on another show's thread. - Fixed: Kitsu titles picked the romaji name when the canonical name was already English.
- Fixed: whole metadata responses (up to ~1.4 MB each) were cached, risking gigabytes of memory; only routing fields are kept now.
- Fixed: fallback responses were cached for 24h, pinning poor links after a metadata hiccup.
- Fixed: stats links for non-IMDB ids, malformed ids returning 500, and
/statsscanning all of KV on every view. - Stream entries now use Stremio's
descriptionfield with a venue + title line.
Contributions are welcome! Run deno task check before opening a Pull Request.
If you have any questions or suggestions, please open an issue on GitHub.
Made with ❤️ for the Stremio community.