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/Discover/Search UI

Home, Discover, Search, Detail and Streams screens built for the couch — no dropping to Kodi's classic directory for the parts that matter most.

Add-on manager

Install Stremio add-ons straight from a manifest URL, and remove them again, without ever 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.

Subtitles out of the box

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

One-click streaming server

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

Get started

Install once, pick your update path

Manual

Quick install

  1. Grab plugin.video.rivulet-<version>.zip from the latest release.
  2. In Kodi: Settings → Add-ons → Install from zip file and pick the zip.
  3. Open Rivulet from the Videos section of the home screen.

You'll need to repeat this for every future release.

Playback

Streaming server

All playback resolves through a server speaking the same enginefs HTTP API as Stremio's own server.jsstremio-server-go 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 stremio-server-go (or official Stremio server) instance.
Run embedded serverThe background service spawns and supervises a local stremio-server-go 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 — use Download stremio-server binary under Settings → Streaming server to fetch and integrity-check the right build straight from the stremio-server-go releases.

Good to know

FAQ & disclaimer

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?

Tested across Python 3.8 through 3.13 — Kodi 19 "Matrix" through current releases.

How do updates work?

Install the Rivulet Repository once and Kodi handles future updates itself, checking a repo published from every tagged release.

Where do subtitles come from?

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