Introduction

Riven is a self-hosted media automation system. It discovers content you want, finds streams through debrid services, and serves them through a virtual file system (VFS) to your media server (Plex or Jellyfin).

How It Works

1. Content Discovery — Plugins like Seerr, MDBList, or Listrr tell Riven what media you want
2. Indexing — TMDB and TVDB fetch metadata for requested items
3. Scraping — Torrentio or Comet find available torrents
4. Downloading — StremThru caches those torrents on your debrid store (Real-Debrid, AllDebrid, TorBox, and others)
5. VFS — A FUSE virtual file system mounts the debrid content as local files
6. Library Update — Your media server picks up the new files

You request a movie or show, and it appears in your media server.

Key Features

• Plugin Architecture — Modular and extensible. Every integration is a plugin.
• Virtual File System — No symlinks or file copies. Clean FUSE mount.
• GraphQL API — Powerful API for querying and managing your library.
• State Machines — XState-powered workflows for reliable media processing.
• Job Queue — BullMQ with Redis for async, resilient processing.

Quick Links