[Skip to content](https://github.com/peronecode/moisa-addon/blob/main/README.md#start-of-content) You signed in with another tab or window. [Reload](https://github.com/peronecode/moisa-addon/blob/main/README.md) to refresh your session.You signed out in another tab or window. [Reload](https://github.com/peronecode/moisa-addon/blob/main/README.md) to refresh your session.You switched accounts on another tab or window. [Reload](https://github.com/peronecode/moisa-addon/blob/main/README.md) to refresh your session.Dismiss alert {{ message }} [peronecode](https://github.com/peronecode)/ **[moisa-addon](https://github.com/peronecode/moisa-addon)** Public - [Notifications](https://github.com/login?return_to=%2Fperonecode%2Fmoisa-addon) You must be signed in to change notification settings - [Fork\\ 5](https://github.com/login?return_to=%2Fperonecode%2Fmoisa-addon) - [Star\\ 2](https://github.com/login?return_to=%2Fperonecode%2Fmoisa-addon) ## Collapse file tree ## Files main Search this repository(forward slash)` forward slash/` / # README.md Copy path Blame More file actions Blame More file actions ## Latest commit [![peronecode](https://avatars.githubusercontent.com/u/5048812?v=4&size=40)](https://github.com/peronecode)[peronecode](https://github.com/peronecode/moisa-addon/commits?author=peronecode) [Improving Readme, adding new host link moisa.fun and bump version](https://github.com/peronecode/moisa-addon/commit/ea6d0fc4a9717de106b98d88328a50c0bd70e487) success 6 months agoJan 10, 2026 [ea6d0fc](https://github.com/peronecode/moisa-addon/commit/ea6d0fc4a9717de106b98d88328a50c0bd70e487) · 6 months agoJan 10, 2026 ## History [History](https://github.com/peronecode/moisa-addon/commits/main/README.md) Open commit details [View commit history for this file.](https://github.com/peronecode/moisa-addon/commits/main/README.md) History 123 lines (90 loc) · 3.76 KB / # README.md Copy path Top ## File metadata and controls - Preview - Code - Blame 123 lines (90 loc) · 3.76 KB [Raw](https://github.com/peronecode/moisa-addon/raw/refs/heads/main/README.md) Copy raw file Download raw file You must be signed in to make or propose changes More edit options Outline Edit and raw actions [![Moisa addon logo](https://github.com/peronecode/moisa-addon/raw/main/assets/moisa-addon-icon-180.png)](https://github.com/peronecode/moisa-addon/blob/main/assets/moisa-addon-icon-180.png) ## Moisa – Stremio addon [Permalink: Moisa – Stremio addon](https://github.com/peronecode/moisa-addon/blob/main/README.md#moisa--stremio-addon) Moisa is a Stremio addon that proxies torrent streams from Torrentio to a TorrServer instance you control (on your LAN or anywhere else), so playback runs through your own infrastructure instead of Stremio’s built‑in engine. The only requirement is a reachable TorrServer, which in return provides a more reliable torrent client, smoother 4K playback, and greater control over buffering, storage, and other settings. ### Local usage (npm) [Permalink: Local usage (npm)](https://github.com/peronecode/moisa-addon/blob/main/README.md#local-usage-npm) - **Install dependencies**: ``` npm install ``` - **Run locally**: ``` npm start ``` - **Stremio manifest URL** (from the same machine): ``` http://127.0.0.1:8080/manifest.json ``` Make sure you have a reachable TorrServer when using the addon locally. ### Docker + docker-compose [Permalink: Docker + docker-compose](https://github.com/peronecode/moisa-addon/blob/main/README.md#docker--docker-compose) - **Start Moisa and TorrServer together**: ``` docker-compose up -d ``` - **Local manifest URL from the host**: ``` http://127.0.0.1:8080/manifest.json ``` TorrServer will be available on port `8090` on the host at the same time. ### Hosted addon [Permalink: Hosted addon](https://github.com/peronecode/moisa-addon/blob/main/README.md#hosted-addon) - **Public addon host**: [https://moisa.fun](https://moisa.fun/) - **Configure URL**: [https://moisa.fun/configure](https://moisa.fun/configure) - **Manifest URL for Stremio**: [https://moisa.fun/manifest.json](https://moisa.fun/manifest.json) ### Configure page [Permalink: Configure page](https://github.com/peronecode/moisa-addon/blob/main/README.md#configure-page) - **TorrServer URL**: enter your TorrServer base URL (for example `http://192.168.x.x:8090`). - **Torrentio quality filter**: optionally set a custom Torrentio `qualityfilter=threed,480p,scr,cam,unknown` string. - Click **Generate addon URL** and use the output as the **Install addon** URL in Stremio, or click **Install in Stremio** to open it directly. ### Flows [Permalink: Flows](https://github.com/peronecode/moisa-addon/blob/main/README.md#flows) #### Direct Torrentio usage in Stremio flow [Permalink: Direct Torrentio usage in Stremio flow](https://github.com/peronecode/moisa-addon/blob/main/README.md#direct-torrentio-usage-in-stremio-flow) Render Stremio Stream EngineTorrentio Addon (API)StremioUserStremio Stream EngineTorrentio Addon (API)StremioUserBrowses catalog and selects a titleOpens streams/addon sources for selected titleShows available addon sources (e.g., Torrentio)Selects Torrentio as stream sourceGET /stream/{type}/{id}.jsonReturns stream list (magnet URLs, infoHash, fileIdx, etc.)Show list of magnetsStarts playback for a chosen streamGET /play/{params} Sends chosen magnet to internal torrent engineStarts video streamPlays video using internal stream engine Loading ``` sequenceDiagram participant U as User participant S as Stremio participant T as Torrentio Addon (API) participant P as Stremio Stream Engine %% Catalog phase U->>S: Browses catalog and selects a title %% Addon/source selection U->>S: Opens streams/addon sources for selected title S-->>U: Shows available addon sources (e.g., Torrentio) U->>S: Selects Torrentio as stream source %% Stream resolution S->>T: GET /stream/{type}/{id}.json T-->>S: Returns stream list (magnet URLs, infoHash, fileIdx, etc.) S-->>U: Show list of magnets %% Playback U->>S: Starts playback for a chosen stream S->>P: GET /play/{params} Sends chosen magnet to internal torrent engine P-->>S: Starts video stream S-->>U: Plays video using internal stream engine ``` #### Stremio using Moisa Addon as proxy to TorrServer [Permalink: Stremio using Moisa Addon as proxy to TorrServer](https://github.com/peronecode/moisa-addon/blob/main/README.md#stremio-using-moisa-addon-as-proxy-to-torrserver) Render Local TorrServerTorrentio Addon (API)Moisa Addon (proxy)StremioUserLocal TorrServerTorrentio Addon (API)Moisa Addon (proxy)StremioUserBrowses catalog and selects a titleOpens streams/addon sources for selected titleShows available addon sources (e.g., Moisa Addon)Selects Moisa Addon as stream sourceGET /stream/{type}/{id}.jsonGET /stream/{type}/{id}.jsonReturns stream candidates (infoHash, fileIdx, etc.)Returns stream list with /play?infoHash=... URLsShow list of magnetsStarts playback for a chosen streamGET /play?infoHash=...&fileIndex=...Builds TorrServer URL /stream?link=infoHash&index=...HTTP 302 redirect to TorrServer stream URLGET /play/{params} Requests video stream from TorrServerStarts video streamPlays video from Local TorrServer Loading ``` sequenceDiagram participant U as User participant S as Stremio participant M as Moisa Addon (proxy) participant T as Torrentio Addon (API) participant R as Local TorrServer %% Catalog phase U->>S: Browses catalog and selects a title %% Addon/source selection U->>S: Opens streams/addon sources for selected title S-->>U: Shows available addon sources (e.g., Moisa Addon) U->>S: Selects Moisa Addon as stream source %% Stream resolution through Moisa Addon S->>M: GET /stream/{type}/{id}.json M->>T: GET /stream/{type}/{id}.json T-->>M: Returns stream candidates (infoHash, fileIdx, etc.) M-->>S: Returns stream list with /play?infoHash=... URLs S-->>U: Show list of magnets %% Playback via Local TorrServer U->>S: Starts playback for a chosen stream S->>M: GET /play?infoHash=...&fileIndex=... M->>M: Builds TorrServer URL /stream?link=infoHash&index=... M-->>S: HTTP 302 redirect to TorrServer stream URL S->>R: GET /play/{params} Requests video stream from TorrServer R-->>S: Starts video stream S-->>U: Plays video from Local TorrServer ``` You can’t perform that action at this time.