Kodi × Stremio protocol

Rivulet

A Kodi video add-on that reimplements the Stremio client experience — discover and search catalogs, manage add-ons, resolve streams, and play, all from a custom, couch-first UI.

Test workflow status Latest release MIT license

Rivulet does not host, index or provide any media content — it's a client for third-party Stremio add-ons you install yourself.

Why Rivulet

Everything Stremio, at home in Kodi

Custom Home/Browse/Search UI

Home, catalog browsing, Search, Detail and Streams screens built for the couch — no dropping to Kodi's classic directory.

Add-on manager

Install Stremio add-ons straight from a manifest URL, and remove them again, without leaving Kodi.

∥∥

Parallel catalog & stream lookups

A slow or unavailable add-on no longer stalls the rest — catalogs and sources are queried in parallel.

Stremio account sync

Log in to keep your add-on collection in sync both ways between Kodi and Stremio.

SRT

Subtitles out of the box

Pulled from your installed Stremio subtitle add-ons at playback time, OpenSubtitles v3 preinstalled.

One-click streaming server

Download the right rivulet-engine build for your platform and run it embedded, or point at a server you already run.

See it in action

The couch-first UI, screen by screen

The Home, series and search screens are based on RevRivulet by TheGildedGoo, who also took these screenshots (#67).

Rivulet's Home with Home, Movies and Series tabs, a full-screen backdrop hero for The Matrix with its logo, rating, runtime and synopsis, and a Continue row of landscape cards
Home — a backdrop hero for the focused title, with Continue right below.
Breaking Bad's series page with season tabs, Season 2's episode list with thumbnails, air dates and synopses, and the focused episode's still on the right
Series — season tabs and an episode list, progress bar included.
Search screen with an on-screen A to Z keyboard, the query Alien typed in, a backdrop for the top result and a row of result posters
Search — type with the remote or your phone, results on one page.
A catalog opened into a coverflow with a featured title's synopsis
Open a catalog into a full coverflow, poster and synopsis included.
Stream source list for a title, each row showing resolution, quality tags, size and source add-on
Every source from every add-on, ranked, with quality and size up front.
Rivulet's in-app Stremio add-on manager listing installed add-ons
Install Stremio add-ons from a URL, manage them without leaving Kodi.
Get started

Installed in three steps

i

First non-official add-on? Turn on Settings → System → Add-ons → Unknown sources once. Kodi asks you the same thing the first time you install a zip. Works on Kodi 19 and later; Android, Windows, Linux, macOS and CoreELEC.

Fewest clicks

Install the add-on directly

  1. Download plugin.video.rivulet.zip.
  2. Settings → Add-ons → Install from zip file → pick the zip.
  3. Open Rivulet from Add-ons → Video add-ons.

No automatic updates: repeat for each release.

Kodi can't browse to the zip? Install from a URL instead

Typical on set-top boxes and TVs where you can't download files. Add this address as a source and Kodi fetches the zips itself, with no PC or browser needed.

https://rivulet-kodi.github.io/plugin.video.rivulet/
  1. Settings → File manager → Add source → paste the address, name it Rivulet.
  2. Settings → Add-ons → Install from zip file → Rivulet, then pick repository.rivulet.zip (or plugin.video.rivulet.zip).

First launch

Nothing to configure to start watching, but these take a minute and help.

Automatic

Streaming server

The embedded server is on by default. The background service downloads and checks the right rivulet-engine build for your device the first time Kodi starts; watch for the notification.

Optional, recommended

Bring your add-ons

Settings → Account → Log in, then Sync add-ons to pull your Stremio collection (Torrentio and others). No account? Add them from a manifest URL in the in-app add-on manager.

Optional

Subtitle language

Settings → Subtitles: change en to your language code (es, it, pt…). OpenSubtitles v3 is preinstalled.

Playback

Streaming server

All playback resolves through a server speaking the same enginefs HTTP API as Stremio's own server.js — rivulet-engine is a pure-Go, drop-in implementation. Configure it under Settings → Streaming server.

SettingPurpose
Server URLWhere the streaming server listens. Defaults to http://127.0.0.1:11470 — point it at any local or remote instance.
Run embedded serverThe background service spawns and supervises a local process for the Kodi session, and stops it on shutdown.
Server binary pathThe executable to run when embedded. Leave empty to auto-detect from the add-on's bin/ folder, then PATH.

No manual binary install needed: the service fetches and integrity-checks the right build from the rivulet-engine releases on its own. Download rivulet-engine binary under Settings → Streaming server re-runs it on demand.

Android: if Android refuses to run the downloaded executable, Rivulet falls back to loading the server as a library inside Kodi, with no root or second app. If a server error still appears, enable Force library mode (Android) (expert settings level). If neither works, point Server URL at a rivulet-engine on a PC, NAS or Termux and turn Run embedded server off.

Good to know

FAQ & disclaimer

i

Rivulet does not host, index or provide any media content. It's a client for third-party Stremio add-ons that you install yourself, including catalogs, streams and subtitles.

Do I need a Stremio account?

No — Rivulet works fully anonymously. Logging in is optional and only syncs your installed add-ons with your Stremio account.

Which Kodi versions are supported?

Kodi 19 "Matrix" through current releases (tested on Python 3.8 to 3.13).

How do updates work?

Install the Rivulet Repository once and Kodi handles future updates itself.

Where do subtitles come from?

From your installed Stremio subtitle add-ons at playback time — OpenSubtitles v3 comes preinstalled.

"Server not available" or nothing plays

Check the add-on's Streaming server settings: Run embedded server should be on, with the default URL. Wait for the first-run binary download to finish (needs internet). On Android try Force library mode.

The catalogs are empty

Rivulet ships no content: it shows what your Stremio add-ons provide. Log in and sync, or install an add-on from its manifest URL in the add-on manager.

A source says the speed is too low

Quality and speed depend on the source (torrent health, debrid, your link). Try another stream or a smaller file.

Do I need Real-Debrid?

Not by default. It depends on the Stremio add-on you use and how you configured it.