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 stremio-server-go 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

Rivulet's custom Home menu with Movies, Series, Anime, Search, Continue, Add-ons and Settings rows
Home — Movies, Series, Anime, Search and Continue, one row away.
Catalog picker listing the movie catalogs published by installed Stremio add-ons
Pick a type, then a catalog — filtered to Movies, Series or Anime.
A catalog opened into a coverflow with a featured title's synopsis
Open a catalog into a full coverflow, poster and synopsis included.
Title detail merged with a list of resolved stream sources
Title details and resolved stream sources, merged into one view.
Preparing stream dialog live-resolving a torrent with peer and speed stats
Live stream resolution — real peers, real speed, no guesswork.
Search screen's empty new-search entry state
Search, ready when you are.
Search results for star wars rendered as a coverflow
Results land as a coverflow, not a bare list.
Continue screen's coverflow mixing part-way-through titles, next-up episodes and saved library items
Continue — what you're watching, what's next, and what you've saved, one coverflow.
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

Install once, pick your update path

Manual

Quick install

  1. Download plugin.video.rivulet.zip (always the current 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.js — stremio-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 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 — 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

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?

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.

Where do subtitles come from?

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