Skip to main content
StreamVault Hero Light

​
What is StreamVault?

StreamVault is a cloud-first desktop application for managing your media library with Google Drive integration, rich metadata from TMDB, and seamless playback through MPV. Built with modern technologies, it combines the power of Rust backend processing with a sleek React frontend. Index your entire Google Drive video collection with one click, fetch beautiful posters and metadata automatically, and enjoy native playback of any video format without transcoding.

Quick start

Get up and running in minutes with our step-by-step guide

Installation

Install prerequisites and build StreamVault from source

Google Drive integration

Learn how cloud indexing and real-time sync works

Metadata management

Discover how TMDB integration enriches your library

​
Key features

Cloud-first library

Index your entire Google Drive with one click. Real-time change detection monitors for new content using the Changes API with 5-second polling intervals.

Rich metadata

Automatically fetch posters, backdrops, overviews, and ratings from TMDB. TV shows are properly grouped by series and season with episode thumbnails.

Universal playback

Native MPV integration plays any format (MKV, MP4, AVI, HDR) without transcoding. Resume playback exactly where you left off.

Background sync

Incremental updates detect new files even when minimized to system tray. Get Windows notifications when new media is added.

Episode browser

Browse TV series by season with full episode metadata, thumbnails, and air dates. Fix misidentified content with manual matching.

Monochrome UI

Sleek black and white design with smooth animations powered by Framer Motion. Context menus provide quick access to common operations.

​
Architecture

StreamVault is built on a modern technology stack designed for performance and reliability: 
React 18 - UI framework
TypeScript - Type safety
TailwindCSS - Styling
Radix UI - Accessible components
Framer Motion - Animations
Vite - Build tooling

​
How it works

1

Cloud sync

Monitors Google Drive for changes using the Changes API with 5-second polling. Detects new files automatically, even when minimized to system tray.
2

Smart parsing

Extracts title, year, season, and episode information from filenames using regex patterns optimized for common naming conventions.
3

Metadata enrichment

Queries TMDB API for rich metadata including posters, backdrops, overviews, cast information, and ratings. Images are cached locally in %APPDATA%/StreamVault/image_cache/.
4

Database storage

Stores all metadata in a local SQLite database (media_library.db) for instant access. Supports movies, TV shows, and episodes with proper relationships.
5

Duplicate prevention

Automatically skips already-indexed files using incremental updates. Only processes new content to minimize API calls and processing time.
6

Native playback

Launches MPV player with IPC support for progress tracking. Resume positions are saved automatically and restored on next playback.

​
Supported formats

StreamVault supports all video formats that MPV can handle, including:

Container formats

.mkv .mp4 .avi .mov .webm .m4v .wmv .flv .ts .m2ts

Special features

HDR, 4K, multiple audio tracks, subtitles, and advanced codec support through MPV
StreamVault relies on MPV for playback capabilities. Any format supported by your MPV installation will work seamlessly.

​
Platform support

Currently optimized for Windows with plans for Linux and macOS support.

Windows

Full support with system tray, notifications, and native MPV IPC via named pipes

Linux

Compatible with Tauri and MPV - manual build required

macOS

Compatible with Tauri and MPV - manual build required

​
What’s new in v3.0

  • Removed local library support for simplified cloud-first experience
  • Single “Update Library” button for all cloud indexing operations
  • Improved background polling with 5-second change detection
  • Streamlined navigation without local tabs
  • Enhanced incremental indexing performance
  • Complete UI overhaul with black/white/grayscale aesthetic
  • Full Google Drive indexing with one-click setup
  • Simplified cloud settings removing folder-based management
  • Enhanced Google Drive sync using Changes API
  • Improved metadata caching and image management

​
Next steps

Install StreamVault

Set up your development environment and build from source

Follow the quickstart

Connect Google Drive, add TMDB API key, and scan your first library

Configure settings

Customize player paths, cache settings, and scan intervals

Explore features

Learn about cloud sync, metadata fetching, and playback features
StreamVault requires a self-hosted or configured backend server for Google Drive OAuth and TMDB proxy functionality. See the self-hosting guide for details.

Build docs developers (and LLMs) love

Get started for freeTalk to us