Self-hosted Stremio addon. Simply query your Jackett and stream torrents instantly via WebTorrent.
1.8K
A Stremio addon that streams torrents from your Jackett. Self-hosted, one container.
Pick a movie or an episode in Stremio and the torrents Jackett finds appear as sources; the addon downloads what you watch and serves it to the player. A static Go binary in a 20 MB image, no debrid, no qBittorrent, no volumes.
5070) and the torrents Jackett returns are listed as streams, sorted by quality,
source, HDR and seeders. Nothing goes through a debrid service or a separate torrent client..torrent is downloaded through Jackett's proxied URL, so
the announce URLs carry your passkeys. DHT, LSD and µTP are off.local-ip.medicmobile.org gives any LAN IP a valid HTTPS name, which Stremio clients on other
devices need. The addon fetches the current certificate itself and swaps it in while running:
no reverse proxy, no rebuild when it rotates. See HTTPS for how it works and what it
costs./<config>/configure can be bookmarked.scratch image: about 20 MB, under 50 ms to start, about
30 MB of memory. One container, no volumes, linux/amd64 and linux/arm64.You need: Docker with Compose on the host, a running Jackett the container can reach, a free TMDB API key, and the Stremio app on the devices you watch on.
Put this in a docker-compose.yml (the one in the repository is the same):
services:
jackstream:
image: ghcr.io/lborruto/jackstream:latest
container_name: jackstream
ports:
- "7000:7000" # HTTP (configure page + localhost Stremio)
- "7001:7001" # HTTPS (for Stremio clients on other LAN devices)
restart: unless-stopped
docker compose up -d
Or without Compose:
docker run -d --name jackstream \
-p 7000:7000 -p 7001:7001 \
--restart unless-stopped \
ghcr.io/lborruto/jackstream:latest
Then:
http://<server-ip>:7000/configure from any device on your
LAN.http://<server-ip>:9117, say) and its API key, the TMDB API
key, and under Addon public URL / LAN IP your server's LAN IP, 192.168.1.10 for
example. The page turns it into the HTTPS URL that Stremio clients on other devices can reach
with a valid certificate: https://192-168-1-10.local-ip.medicmobile.org:7001.No domain, no certificate to manage, no per-device trust setup.
Reloading /configure fills the form again from the browser's localStorage. To carry the full
config to another browser, bookmark http://<server-ip>:7000/<base64>/configure.
git clone https://github.com/lborruto/jackstream.git
cd jackstream
go build -o jackstream ./cmd/jackstream
./jackstream
Needs Go 1.24 or newer. Every dependency is in the standard library except
github.com/anacrolix/torrent, which go build fetches.
Stremio app
│ GET /{config}/manifest.json
│ GET /{config}/stream/{type}/{id}.json
▼
[Go net/http + Stremio addon]
│
├─ Resolve IMDB id → titles via TMDB (24 h cache)
├─ Search Jackett in parallel across title variants
├─ Parse + sort torrents (quality > source > hdr > seeders)
└─ Return streams pointing back to /stream/{config}/{torrentId}/{fileIdx}
│ GET /stream/:config/:torrentId/:fileIdx
▼
[anacrolix/torrent singleton]
│
├─ Download .torrent via Jackett (with passkeys)
├─ Reader-driven piece prioritization (responsive + 16 MB readahead):
│ only the parts you actually watch are downloaded
├─ Wait for torrent metadata, then serve via http.ServeContent (Range-aware)
└─ Clean up idle torrents + their on-disk pieces, respect maxConcurrentTorrents
All optional. With the defaults, results are the same as in earlier versions.
| Setting | Effect |
|---|---|
| Preferred audio language | Sort boost for matching audio (FRENCH, MULTI, VOSTFR, ENG). FRENCH also boosts MULTI releases; so does ENG. Results that do not match are not hidden. |
| Min / Max quality | Hard filter. Drops results above or below the chosen tier. |
| Min size (MB) | Drops "fake" low-size releases. |
| Max size (GB) | Drops oversized releases (useful on a slow connection or a small disk). |
| Blacklist keywords | Comma-separated list, case-insensitive, matched on word boundaries. Drops results whose title contains any keyword, CAM, HDCAM, TELESYNC for example. |
Every filter is part of the base64-encoded addon URL, so two Stremio installs can use different filter profiles against the same server.
jackstream uses the wildcard TLS certificate from https://local-ip.medicmobile.org, a
community service that issues a public Let's Encrypt certificate for
*.local-ip.medicmobile.org and runs a DNS server where <dashed-ip>.local-ip.medicmobile.org
resolves to <ip>. Any LAN IP gets a valid HTTPS name with nothing to configure.
The certificate is refreshed while the addon runs: on startup and every 12 hours it fetches the current certificate and key from the service and swaps them into the running HTTPS listener. No restart and no image rebuild when Let's Encrypt rotates it, about every 60 days. A copy is embedded in the binary as a fallback, so HTTPS still comes up when the service cannot be reached for a while.
The HTTPS listener is on port 7001, next to the HTTP listener on 7000. Stremio clients use the HTTPS URL; the TCP connection still goes straight to your LAN host.
Mount a certificate and key and point the addon at them. This pins your certificate: auto-refresh is off and renewal is yours to handle.
services:
jackstream:
image: ghcr.io/lborruto/jackstream:latest
ports:
- "7000:7000"
- "7001:7001"
environment:
- HTTPS_CERT_PATH=/certs/fullchain.pem
- HTTPS_KEY_PATH=/certs/privkey.pem
volumes:
- /path/to/your/certs:/certs:ro
restart: unless-stopped
Works with certificates from Caddy, mkcert, Let's Encrypt or anything else.
Set HTTPS_DISABLED=1 to skip the HTTPS listener. Useful when Caddy, Nginx or Traefik already
terminates TLS in front of the addon.
Rotation happens at runtime, so running installs do not need this. The embedded copy only matters for the first seconds after a cold start, while the current certificate is being fetched. Refreshing it now and then before a release keeps that window covered:
./scripts/refresh-certs.sh
git commit -am "chore: refresh embedded local-ip fallback cert"
Everything is an environment variable, and every one has a default.
| Variable | Default | What it does |
|---|---|---|
PORT | 7000 | Port of the HTTP listener. |
DATA_DIR | /tmp/jackstream | Where in-flight torrent pieces are stored. Cleaned up automatically. |
CACHE_TTL_MINUTES | 1440 | How long TMDB results are cached. |
REQUEST_TIMEOUT_MS | 8000 | Timeout for Jackett and TMDB requests. |
STREAM_READY_TIMEOUT_S | 60 | Longest wait for the first pieces. |
TORRENT_IDLE_TIMEOUT_MIN | 30 | Idle minutes before a torrent is stopped and its pieces deleted. |
HTTPS_PORT | 7001 | Port of the HTTPS listener. |
HTTPS_CERT_PATH | unset | Path to your own TLS certificate (PEM). Turns off certificate auto-refresh. |
HTTPS_KEY_PATH | unset | Path to your own TLS private key (PEM). Both paths must be set. |
HTTPS_DISABLED | unset | 1 disables the HTTPS listener. |
Does it work with private trackers?
Yes. Jackett proxies the .torrent URL, so the announce URLs carry your passkeys. DHT and LSD
are disabled in the BitTorrent client, so infohashes are not leaked to the public swarm.
I saw "Stream session expired". The in-memory torrent map keeps entries for 2 hours. Go back to the source list and click the stream again; it starts again at once.
Does it seed after I finish watching?
No. V1 stops idle torrents after TORRENT_IDLE_TIMEOUT_MIN (30 minutes by default) and frees
the disk. Seeding is planned for V2.
Why no debrid? Out of scope: the project targets streaming inside a homelab, with no third-party service.
Why an embedded BitTorrent client rather than qBittorrent?
No shared volume, no second container, HTTP Range requests served natively, and the .torrent
proxied by Jackett carries the passkey, so private trackers work with no extra setup.
Stremio desktop or TV?
Both. notWebReady: true tells Stremio to use its native player rather than the web player.
The Install in Stremio button did nothing, or the URL lost the :7001 port.
Some Stremio clients (older Windows builds in particular) mishandle the port in stremio://
deep links. Copy the https://…:7001/<base64>/manifest.json URL shown under the button, then
in Stremio click the puzzle-piece icon and paste it into Add-on Repository URL.
Loading failed when I clicked a stream.
Most often the container restarted (a redeploy, say) and the in-memory torrentStore was wiped
while Stremio still held a cached list of stream URLs. Close and reopen the movie in Stremio to
fetch a fresh list.
docker compose pull && docker compose up -d
What changed in each version is in CHANGELOG.md. No release so far has changed the addon URL format: URLs already installed in Stremio keep working.
Pull requests are welcome. Run go test ./... and go vet ./... before opening one.
MIT, see LICENSE.
Content type
Image
Digest
sha256:2f71038ba…
Size
7.3 MB
Last updated
13 days ago
docker pull lborruto/jackstream