Riven

Overview

Available plugins for Riven TS and how to configure them.

Every integration in Riven is a plugin. A plugin runs once you add it to RIVEN_SETTING__enabledPlugins and provide its required settings.

RIVEN_SETTING__enabledPlugins=["seerr","stremthru","torrentio","plex"]

tmdb and tvdb are always enabled - Riven can't index media without them, so you don't need to list them.

Available Plugins

Configuring a Plugin

Plugin settings are environment variables built from the package name:

RIVEN_PLUGIN_SETTING__REPO_PLUGIN_<NAME>__<settingName>="value"

<NAME> is the plugin name upper-cased, so plugin-mdblist becomes REPO_PLUGIN_MDBLIST. Setting names are camelCase and are listed on each plugin's settings page.

RIVEN_PLUGIN_SETTING__REPO_PLUGIN_TMDB__apiKey="your-tmdb-key"
RIVEN_PLUGIN_SETTING__REPO_PLUGIN_STREMTHRU__realdebridApiKey="your-rd-key"
RIVEN_PLUGIN_SETTING__REPO_PLUGIN_SEERR__url="http://seerr:5055"
RIVEN_PLUGIN_SETTING__REPO_PLUGIN_SEERR__apiKey="your-seerr-key"

Settings typed as a list or object take JSON:

RIVEN_PLUGIN_SETTING__REPO_PLUGIN_MDBLIST__lists=["username/list-name"]

Minimum Setup

  1. A content source — Seerr, MDBList, or Listrr, to tell Riven what you want
  2. A scraper — Torrentio or Comet, to find torrents
  3. StremThru — to cache those torrents on your debrid store
  4. A media server — Plex or Jellyfin, to pick up the results

On this page