selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

Magnetio logo

Self-host Magnetio

v1.2.0

Self-hosted Stremio addon with torrent scraper and debrid

ReleaseOpen SourceApache-2.0
Updated9 hours ago
LanguageJavaScript
Setup difficultyModerate
Stars
48
Ports
7000 (Stremio addon HTTP server), 8080 (Torrent scraper HTTP server)
Install with Docker Compose

What is Magnetio?

Magnetio is a self-hosted Stremio addon providing a complete streaming pipeline. Its built-in scraper queries more than twenty providers — including YTS, EZTV, 1337x, Nyaa, and Torznab indexers via Jackett or Prowlarr — in parallel with deduplication and content filtering. Results resolve through eight debrid services (Real-Debrid, Premiumize, AllDebrid, DebridLink, EasyDebrid, Offcloud, TorBox, Put.io) for instant streams, with background prewarm of uncached torrents. The addon also provides TMDB-powered recommendations, a subtitle sync pipeline using ffsubsync/alass with OpenSubtitles, Prometheus metrics, and a visual configuration page. It deploys via Docker Compose with three core services (addon on port 7000, scraper on 8080, Redis on 6379) and optional Jackett/Prowlarr profiles. The project is open-source under Apache-2.0 and runs on modest hardware like a Raspberry Pi.

Should you self-host Magnetio?

Magnetio scores 44/100 on selfhost.directory (how scoring works) and ranks #45 of 54 in Media Streaming. It has 48 GitHub stars.

It shipped 7 stable releases in the past year. The latest, v1.2.0, came out on 5 September 2026.

Setup is moderate: expect some configuration beyond a single command. It is Apache-2.0-licensed and written mostly in JavaScript.

Its closest alternative on selfhost.directory is Invidious (81/100, 25 799 stars). It scores higher overall, so compare the two before you pick. See Magnetio vs Invidious side by side.

Features

  • Analytics Dashboard
  • Background prewarm
  • Content Filtering
  • Debrid service integration
  • Docker Compose one-command deploy
  • Multi-provider torrent scraping
  • P2P privacy proxy
  • Prometheus Metrics
  • Redis caching with stale-while-revalidate
  • Request deduplication
  • Stremio and Nuvio compatibility
  • Subtitle sync pipeline
  • TMDB recommendations
  • Visual configuration page

Magnetio README

How to install Magnetio

Install Magnetio with Docker Compose

Docker and Docker Compose
Environment variables
PORT, REDIS_PASSWORD, CACHE_TTL_STREAMS, LOG_LEVEL, PREWARM_ENABLED, PREWARM_SCHEDULE, PREWARM_MOVIE_LIMIT, PREWARM_SERIES_LIMIT, PREWARM_CACHE_TTL, METRICS_USER, METRICS_PASSWORD, ADDON_PUBLIC_URL, OPENSUBTITLES_API_KEY, OPENSUBTITLES_USERNAME, OPENSUBTITLES_PASSWORD, OPENSUBTITLES_USER_AGENT, FFSUBSYNC_PATH, ALASS_PATH, SUBTITLE_SYNC_MAX_OFFSET_SECONDS, ALASS_SPLIT_PENALTY, TZ, JACKETT_PORT, PROWLARR_PORT

git clone https://github.com/peterdsp/Magnetio.git cd Magnetio

Start all three services (scraper + addon + redis)

docker compose up -d

Optional: include Jackett for 500+ additional indexers

docker compose --profile jackett up -d

Optional: include Prowlarr instead (or alongside)

docker compose --profile prowlarr up -d

Open in browser

open http://localhost:7000

Recommended deployment method. Runs addon on port 7000, scraper on 8080, Redis on 6379. Optional Jackett (9117) and Prowlarr (9696) profiles.

How to configure Magnetio

  • ADDON_PUBLIC_URLPublic base URL override for absolute proxy URLs behind reverse proxies

    Public base URL override for absolute proxy URLs behind reverse proxies

  • ALASS_PATHPath to alass binary for subtitle sync

    Path to alass binary for subtitle sync

  • ALASS_SPLIT_PENALTY10Split penalty for alass

    Split penalty for alass

  • CACHE_TTL_STREAMS3600Stream cache TTL in seconds

    Stream cache TTL in seconds

  • FFSUBSYNC_PATHPath to ffsubsync binary for subtitle sync

    Path to ffsubsync binary for subtitle sync

  • LOG_LEVELinfoWinston log level

    Winston log level

  • METRICS_PASSWORDchangemePassword for metrics and stats endpoints

    Password for metrics and stats endpoints

  • METRICS_USERadminUsername for metrics and stats endpoints

    Username for metrics and stats endpoints

  • OPENSUBTITLES_API_KEYOpenSubtitles API key for subtitle resource

    OpenSubtitles API key for subtitle resource

  • OPENSUBTITLES_PASSWORDOpenSubtitles account password

    OpenSubtitles account password

  • OPENSUBTITLES_USER_AGENTMagnetio v1.0.0Custom user-agent for OpenSubtitles API

    Custom user-agent for OpenSubtitles API

  • OPENSUBTITLES_USERNAMEOpenSubtitles account username

    OpenSubtitles account username

  • PORT7000HTTP port for the addon

    HTTP port for the addon

  • PROXY_MAX_ENGINES3Max concurrent torrent engines

    Max concurrent torrent engines

  • REDIS_URIredis://localhost:6379Redis connection URI

    Redis connection URI

  • SCRAPER_DISABLED_PROVIDERSComma-separated provider IDs to skip

    Comma-separated provider IDs to skip

  • SCRAPER_URLhttp://localhost:8080URL of the torrent scraper service

    URL of the torrent scraper service

  • SUBTITLE_SYNC_MAX_OFFSET_SECONDS300Max offset for ffsubsync

    Max offset for ffsubsync

  • TORRENT_PROXYSOCKS5 proxy for P2P privacy

    SOCKS5 proxy for P2P privacy

Magnetio releases & version history

More in Media Streaming

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…