Riven

Riven is an open-source media management and streaming platform that exposes media via a virtual filesystem (RivenVFS). It automates discovery, scraping, downloading, and organization of media and integrates with popular media servers for immediate streaming.

Key Features

• Virtual filesystem (FUSE-based RivenVFS) that presents downloaded media to media servers without moving files
• Automated discovery and scraping pipeline: content services, multiple scrapers, debrid downloader integration and ranking
• Integrations with Plex, Jellyfin, Emby and content/watchlist services for seamless library updates
• Configurable caching, fetch-ahead/prefetching, chunked streaming and eviction policies for smooth playback
• Web-based dashboard (SvelteKit frontend) for configuration, analytics, monitoring and role-based controls
• Service-oriented backend architecture with REST API, scheduling, and database-backed state management
• Docker-ready deployment with docker-compose examples, multi-stage builds, and healthchecks

Use Cases

• Run an automated media acquisition pipeline that finds and prepares media for Plex/Jellyfin/Emby
• Present on-demand streaming of debrid-hosted content through a virtual filesystem to existing media servers
• Centralize and monitor media library state, downloads, and notifications (Discord, Apprise, webhooks)

Limitations and Considerations

• Linux-only runtime: Windows requires WSL and careful Docker/WSL setup; the VFS relies on FUSE and host mount propagation
• Requires privileged container capabilities (e.g., /dev/fuse, SYS_ADMIN) and proper mount propagation flags for correct containerized VFS behavior
• Active-development/beta status: some features and integrations are still evolving and documented as beta; expect breaking changes on dev tags
• Operational dependencies: needs Docker (or Python runtime), a PostgreSQL database, and configured debrid/indexer accounts to function fully

Riven is suited for self-hosting enthusiasts who want automated media acquisition and a FUSE-backed streaming experience. It pairs a Python backend and SvelteKit frontend to provide an end-to-end media management workflow with configurable caching and integrations.