stremio-server-go

README

stremio-server-go

A lightweight, IPv6-capable, open-source drop-in replacement for Stremio's closed-source streaming server (server.js), built on anacrolix/torrent. It serves the exact enginefs HTTP API that stremio-web expects, so it drops straight in.

Not affiliated with or endorsed by Stremio.

Features

• Dual-stack torrent engine - IPv4 + IPv6, TCP + uTP, BEP32 DHT, PEX, WebTorrent, webseeds; curated public trackers with RTT ranking + 24h refresh.
• Full enginefs API - create/stats.json/remove, Range/206 streaming with DLNA headers, network-info, device-info, settings, opensubHash, subtitlesTracks, /probe, /tracks, /list, /:ih/peers.
• HLSv2 transcoding - on-demand ffmpeg with multi-platform hardware accel (VAAPI / NVENC / QSV / VideoToolbox / V4L2M2M, verified at startup, libx264 fallback), multi-audio + embedded-subtitle renditions, and seek-aware segments.
• Subtitles - SRT / WebVTT / ASS-SSA to WebVTT, OpenSubtitles hashing.
• Reverse proxy (/proxy), DLNA casting (/casting, SSDP discovery + UPnP AVTransport control), local-files addon (/local-addon, IMDB-resolved), YouTube (/yt, via yt-dlp), and /get-https (Stremio cert provisioning).
• Disk-bounded cache - LRU eviction honouring the cacheSize setting.
• Self-signed HTTPS on :12470 for HTTPS web UIs (e.g. WebKitGTK shells).
• Metrics - GET /metrics exposes Prometheus-format gauges (goroutines, heap, active torrents, HLS sessions, proxy cache).

Install

Prebuilt binaries for Linux, macOS, Windows, and Android (arm64) are attached to each release.

From source (Go 1.24+; CGO is not required):

go install github.com/M0Rf30/stremio-server-go/cmd/stremio-server@latest
# or, in a checkout:
make build          # -> ./stremio-server
make build-all      # cross-compile every target into dist/

Container / HuggingFace

A multi-stage Dockerfile (ffmpeg + yt-dlp bundled, non-root, /data volume) builds an image runnable under Podman/Docker or as a HuggingFace Space. See docs/CONTAINER.md.

Decentralized torrents (Bitmagnet)

The /bitmagnet add-on streams from a self-hosted Bitmagnet DHT index. A compose file and full setup guide are in docs/BITMAGNET.md.

Universal indexers (Torznab)

The /torznab add-on queries any Torznab-compatible indexer (Prowlarr, Jackett, NZBHydra2, or Bitmagnet's built-in /torznab endpoint). Setup guide: docs/TORZNAB.md.

Run

./stremio-server            # http://127.0.0.1:11470  (https on :12470)
./stremio-server version    # print build version

Then point any Stremio client's streaming server URL at http://127.0.0.1:11470.

Environment

Variable	Default	Purpose
HTTP_PORT	11470	enginefs HTTP API port
HTTPS_PORT	12470	self-signed / provisioned HTTPS port (0 disables)
BT_LISTEN_PORT	0	BitTorrent peer port (0 = OS-assigned)
APP_PATH	~/.stremio-server	data/cache root
STREMIO_MEMORY_CACHE_SIZE	0	in-RAM piece-cache budget in bytes; 0 writes pieces to disk (default). When >0, stream through a bounded RAM cache and never write piece data to disk (mobile / low-disk / HuggingFace).
WEB_UI_LOCATION	https://web.stremio.com/	redirect target for GET /
LOCAL_FILES_DIR	(unset)	directory scanned by the local-files addon
STREMIO_HWACCEL	(auto)	0 forces software transcode; or pin vaapi/nvenc/…
STREMIO_HTTP_LOG	(off)	1 logs each request (path only)
STREMIO_PROXY_PASSWORD	(unset)	api_password required on /proxy/* requests
STREMIO_PROXY_SECRET	(auto)	signing key for signed proxy URLs (auto-generated under APP_PATH)
STREMIO_PROXY_IP_ACL	(unset)	comma-separated CIDR allowlist for proxy clients
STREMIO_PROXY_PREBUFFER	3	upcoming segments to prefetch (0 = off)
STREMIO_PROXY_SEG_CACHE_TTL	300	proxy segment cache TTL, seconds (0 = off)
STREMIO_PROXY_PUBLIC_URL	(derive)	external base URL written into rewritten manifests
STREMIO_PROXY_UPSTREAM	(unset)	outbound upstream proxy for stream proxy (socks5/http/https); overridden per-request by &proxy=
STREMIO_BITMAGNET_URL	(unset)	GraphQL endpoint of a self-hosted Bitmagnet instance; enables the /bitmagnet add-on. Unset = add-on serves the manifest but returns no streams.
STREMIO_TORZNAB_URL	(unset)	Torznab indexer API base URL; enables the /torznab add-on. Unset = add-on serves the manifest but returns no streams.
STREMIO_TORZNAB_APIKEY	(unset)	API key for the Torznab indexer. Required by Prowlarr and Jackett; not needed for Bitmagnet.
STREMIO_DISABLE_TRACKERS	(off)	disable all tracker announces (DHT/PEX/webseeds only) — for private/DHT-only operation
STREMIO_DISABLE_WEBTORRENT	(off)	disable WebTorrent/WebRTC (pion) peers — cuts ~60% of goroutines & RAM; TCP/uTP/DHT peers unaffected
STREMIO_PEERS_PER_TORRENT	50	established peer connections per torrent (half-open=n/2, high-water=n*10); lower (e.g. 30) trims peer goroutines/RAM
STREMIO_MEM_LIMIT	(unset)	soft memory ceiling in bytes (runtime/debug.SetMemoryLimit; GOMEMLIMIT env also works). RSS high-water is returned to the OS every 5 min regardless

The stream proxy (HLS/DASH manifest rewriting, on-the-fly decryption, signed URLs) is documented in docs/PROXY.md.

Platforms

CGO_ENABLED=0 everywhere, so all targets are pure-Go cross-compiles: linux/{amd64,arm64,arm}, darwin/{amd64,arm64}, windows/{amd64,arm64}, android/arm64. Android additionally builds with -ldflags=-checklinkname=0 (for github.com/wlynxg/anet on Go 1.23+); it also runs as a plain linux/arm64 binary under Termux.

Layout

Path	Responsibility
cmd/stremio-server	entrypoint, wiring, TLS, version
internal/types	shared contract (structs + interfaces)
internal/engine	anacrolix client, readers, stats, trackers, cache eviction
internal/api	enginefs routes, streaming, proxy, casting, local-addon, youtube
internal/settings	settings store (server-settings.json)
internal/media	ffprobe, HLS transcode, subtitles, opensub hash
docs/swagger.yaml	OpenAPI/Swagger spec, generated from code (make swagger)
scripts/smoke.sh	end-to-end API smoke test

Security

This is a localhost service with no authentication - bind it to loopback and do not expose :11470 to untrusted networks. By design it shells out to ffmpeg/yt-dlp and acts as an open reverse proxy (/proxy) for the local web UI; treat anything that can reach the port as fully trusted.

License

MIT - Copyright (c) 2026 Gianluca Boiano.