Riven is a self-hosted media automation system that turns a Plex, Jellyfin or Emby library into a streaming front end for torrents held on a debrid service. Instead of downloading and storing gigabytes of media locally, Riven asks Real-Debrid or AllDebrid to cache a torrent, then exposes the cached file through a FUSE virtual file system so the media server sees it as an ordinary local file.

Content discovery comes from plugins (Seerr/Overseerr, MDBList, Listrr, Plex Watchlist, Trakt), metadata is pulled from TMDB and TVDB, and scraping is handled by Torrentio, Comet, Prowlarr, Jackett, Zilean, Mediafusion or Rionoid. The whole stack is a Docker container plus Postgres, with a Next.js web interface and a TUI for headless installs.

Key Features

• Debrid-backed streaming – torrents are cached on Real-Debrid or AllDebrid and mounted over FUSE instead of being downloaded to disk
• Request integrations – Seerr/Overseerr, MDBList, Listrr, Trakt and Plex Watchlist feed new items in automatically
• Scraper plugins – Torrentio, Comet, Prowlarr, Jackett, Zilean, Mediafusion and Rionoid
• Media server support – Plex, Jellyfin and Emby through a shared, mount-propagated library path
• Library profiles – virtual sub-libraries filtered by genre, year, rating, network, country or language
• RivenVFS cache with configurable size cap, chunk prefetching and LRU or TTL eviction
• Web UI with Home, Browse, Summary and Settings views, plus a TUI for servers without a browser

Why Use Riven

Storage is the expensive part of a media library. Riven moves the bytes to a debrid store and keeps only a cache and a mount on your own hardware, so a small VPS can serve a large catalogue. Discovery is automated end to end: a request in Seerr or a new Trakt list entry becomes a cached file in the library without anyone touching a torrent client.

Use Cases

• Running a Plex or Jellyfin server on limited disk where the library lives on debrid storage
• Automating a watchlist – Trakt, Plex Watchlist or MDBList lists turn into library content
• Splitting one library into curated virtual shelves (kids, anime, high-rated) with library profiles
• Replacing a manual torrent-client plus symlink workflow with a single managed service

Deployment and Requirements

Riven ships as a Docker image (spoked/riven) and needs Postgres, the /dev/fuse device and a shared bind mount for the library path. A debrid subscription (Real-Debrid, AllDebrid and similar) and the matching media server are required for it to do anything useful.

Licence

Open source – GNU General Public License v3.0. The software is free to self-host; the debrid account it relies on is a separate paid third-party service.