Introduction

StremThru is a self-hosted companion service for Stremio. It provides an HTTP(S) proxy with authorization, debrid store integrations through a unified API, content proxying with byte serving, and a suite of Stremio addons.

Core Concepts

Store

A Store is an external debrid service that provides access to content. StremThru acts as a unified interface for interacting with these stores.

Supported stores:

Store	Identifier
AllDebrid	alldebrid
Debrider	debrider
Debrid-Link	debridlink
EasyDebrid	easydebrid
Offcloud	offcloud
PikPak	pikpak
Premiumize	premiumize
RealDebrid	realdebrid
TorBox	torbox

Store Content Proxy

StremThru can proxy content from the store to your device. For proxy-authorized requests, this is enabled by default.

sequenceDiagram
    participant User as User Device
    participant StremThru as StremThru
    participant Store as Store

    User->>StremThru: Request Content
    StremThru->>Store: Request Content
    loop Byte Serving
      Store-->>StremThru: Content Chunk
      StremThru-->>User: Content Chunk
    end

Store Tunnel

If you can't access a store directly from your IP, you can use an HTTP(S) proxy to tunnel the traffic.

sequenceDiagram
    participant Client as StremThru
    participant Proxy as HTTP(S) Proxy
    participant Server as Store

    Client->>Proxy: HTTP Request
    Proxy->>Server: Forward HTTP Request
    Server->>Proxy: HTTP Response
    Proxy->>Client: Forward HTTP Response

Stremio Addons

StremThru includes five built-in Stremio addons:

• Store — Browse and search your store catalog
• Wrap — Wrap other Stremio addons with StremThru
• Sidekick — Extra features for Stremio (addon management, library backup/restore)
• Torz — Torrent indexer integration
• List — Generate catalogs from external lists (Trakt, TMDB, AniList, etc.)

SDKs

Official SDKs are available for programmatic access:

• JavaScript — npm install stremthru
• Python — pip install stremthru