Skip to content

Repository files navigation

ViveStream Banner

Tauri SolidJS Rust License Platform

🎬 A lightning-fast, native YouTube downloader & sleek local media library.

Built with Tauri v2, SolidJS, and Rust for maximum performance, hardware-accelerated transcoding, and a tactile claymorphic interface.

Download Latest Release β€’ Features β€’ Keyboard Shortcuts β€’ Developer Guide β€’ Documentation


✨ Project Overview & Tech Stack

ViveStream-Next is an advanced, ultra-lightweight, offline-first media downloader and local streaming platform. Unlike Electron-based alternatives, it avoids shipping a bundled Chromium browser, keeping the install size incredibly small.

The Stack

  • Frontend: SolidJS for extreme performance and a zero-Virtual-DOM experience.
  • Backend: Tauri v2 powered by Rust for native OS integration and performance.
  • Engines: yt-dlp (Media Extraction), FFmpeg (Transcoding/Merging), and Deno (Cryptographic JS evaluation).
  • Database: SQLite (via rusqlite & tauri-plugin-sql) for fast, local metadata indexing.
  • Local Server: A dedicated warp HTTP server routes local media seamlessly to the video player.

✨ Key Features

πŸš€ High-Performance Engine

  • Smart Hardware Transcoding: Automatic hardware-accelerated transcoding via NVIDIA NVENC, Intel QSV, AMD AMF, and Linux VAAPI (with smooth CPU fallback).
  • Multi-Fragment Downloads: Parallel fragment fetching for blazing-fast HLS/DASH downloads.
  • Concurrent Queue Management: Configurable parallel download slots (1–5 simultaneous jobs) with real-time progress logging and status tracking.
  • Advanced Extraction: Utilizes a headless native WebView to seamlessly extract Proof of Origin (PO) tokens, and Deno for decrypting YouTube's JS obfuscation.
  • Browser Cookie Integration: Automatic cookie extraction from 8+ desktop browsers (Chrome, Firefox, Brave, Edge, Opera, Vivaldi, Chromium, Safari) for restricted or premium media.
  • Zero-Config Setup Wizard: Automated initial provisioning and integrity verification for yt-dlp and ffmpeg binaries (downloaded on-the-fly to reduce installer bloat).
  • Smart Hardware Transcoding: Automatic hardware-accelerated transcoding via NVIDIA NVENC, Intel QSV, AMD AMF, and Linux VAAPI (with smooth CPU fallback).
  • Multi-Fragment Downloads: Parallel fragment fetching for blazing-fast HLS/DASH downloads.
  • Concurrent Queue Management: Configurable parallel download slots (1–5 simultaneous jobs) with real-time progress logging and status tracking.
  • Browser Cookie Integration: Automatic cookie extraction from 8+ desktop browsers (Chrome, Firefox, Brave, Edge, Opera, Vivaldi, Chromium, Safari) for restricted or premium media.
  • Zero-Config Setup Wizard: Automated initial provisioning and integrity verification for yt-dlp and ffmpeg binaries.

πŸ“š Media Library, Playlists & Artists

  • Automated Playlist Ingestion: Paste any YouTube playlist URL to automatically create the playlist locally, download the media, deduplicate existing files, and link them.
  • Custom Playlists: Create, reorder, rename, and manage playlists with one-click "Play All" queueing.
  • Artist & Channel Hub: Automatically organizes media by artist/channel with avatar caching, subscriber badges, and dedicated channel catalogs.
  • Interactive Favourites: Instant one-click bookmarking across all library views.
  • Metadata Editor: Edit video titles and channel names directly from the media library.

πŸŽ₯ Cinema Player Experience

  • Local Streaming: Instant playback powered by an embedded local HTTP warp server routing files directly from your disk to the frontend.
  • Display Modes: Toggle between Standard View, Theater Mode, Fullscreen, and Picture-in-Picture (Miniplayer).
  • Custom Subtitles & Playback Speed: Multi-track .vtt caption rendering and variable playback speeds (0.25x – 2.0x).
  • On-Screen Display (OSD): Sleek glassmorphic OSD badges providing instant visual feedback for seeking, volume, and playback modes.
  • Smart Context Queue: Seamlessly plays next items in context of current playlist or artist.
  • Native Media Controls: Integration with system media controls (play/pause, next/prev) via the souvlaki crate.
  • Local Streaming: Instant playback powered by an embedded local HTTP server.
  • Display Modes: Toggle between Standard View, Theater Mode, Fullscreen, and Picture-in-Picture (Miniplayer).
  • Custom Subtitles & Playback Speed: Multi-track .vtt caption rendering and variable playback speeds (0.25x – 2.0x).
  • On-Screen Display (OSD): Sleek glassmorphic OSD badges providing instant visual feedback for seeking, volume, and playback modes.
  • Smart Context Queue: Seamlessly plays next items in context of current playlist or artist.

🎨 Claymorphism Design & Themes

  • Vibrant Themes: Switch between Sunset and Crimson accent palettes with Dark and Light mode support.
  • Dynamic Sidebar: Collapsible navigation with optional auto-expand on hover.
  • Toast & Modal Dialogs: Responsive notifications and tactile confirmations.
  • 100% Private & Local: No telemetry, no tracking, no external server lock-in.

⌨️ Keyboard Shortcuts

Press ? or Shift + / anywhere in the application to view the interactive cheat sheet:

🎬 Player Controls

Shortcut Action
Space or K Play / Pause
M Mute / Unmute
F Toggle Fullscreen
T Toggle Theater Mode
I Toggle Miniplayer (PiP)
← / β†’ Seek Backward / Forward 5s
J / L Seek Backward / Forward 10s
↑ / ↓ Volume Up / Down (5%)
N / P Next / Previous Media in Queue
C Toggle Captions / Subtitles
R Toggle Repeat / Loop
0 – 9 Seek to Percentage (0% – 90%)
< / > Decrease / Increase Playback Speed

🧭 Global Navigation

Shortcut Destination
Shift + 1 or H Home
Shift + 2 or F Favourites
Shift + 3 or P Playlists
Shift + 4 or A Artists
Shift + 5 or D Downloads
Shift + 6 or S Settings
Esc Go Back / Close Modals
? Open Shortcuts Cheat Sheet

πŸ“¦ Installation

🐧 Arch Linux / Manjaro (Recommended)

wget https://raw.githubusercontent.com/rootlocalghost/ViveStream-Next/main/PKGBUILD
makepkg -si

πŸͺŸ Windows & 🐧 Debian/Ubuntu

Download the latest pre-compiled installer (.exe for Windows, .deb for Debian/Ubuntu, or .pkg.tar.zst for Arch) directly from the Releases page.

Tip

Security Notice (Unknown Publisher): ViveStream is a free, non-commercial open-source project. Because we do not purchase corporate code-signing certificates:

  • Windows Defender SmartScreen: Click "More Info" βž” "Run Anyway".
  • Linux: Right-click the binary βž” Properties βž” Check "Allow executing file as program" (or chmod +x).

πŸ—‘οΈ Complete App Data Wipe (Optional)

Because core engines (yt-dlp/ffmpeg) and downloaded media are stored locally at runtime:

  • Before uninstalling, you can navigate to Settings βž” Danger Zone and select Nuclear Wipe to safely delete all media files and database storage.

πŸ’» Developer Setup

Prerequisites

  • Bun (v1.0+)
  • Rust & Cargo (v1.80+)
  • C Build Tools & WebKitGTK (Linux only):
    # Debian/Ubuntu
    sudo apt-get install -y libwebkit2gtk-4.1-dev build-essential curl wget file libxdo-dev libssl-dev libayatana-appindicator3-dev librsvg2-dev
    
    # Arch Linux
    sudo pacman -S base-devel webkit2gtk-4.1 curl wget unzip

Build & Run Steps

  1. Clone the repository:

    git clone https://github.com/rootlocalghost/ViveStream-Next.git
    cd ViveStream-Next
  2. Initialize & Install dependencies:

bun run init

This command runs cargo build, installs JS dependencies via Bun, and builds Vite.

  1. Run in Development Mode:

    bun start
    # or
    bun run tauri dev

    Note: This will spin up the SolidJS dev server and the Rust backend. Any changes to Rust code will trigger a recompile.

  2. Run Automated Tests:

    # Frontend tests (Vitest)
    bun run test
    
    # Backend tests (Cargo)
    cargo test --manifest-path src-tauri/Cargo.toml
  3. Build for Production:

    bun run tauri build
    # or use the provided scripts for specific platforms:
    bun run build:linux
    bun run build:win

Documentation

For deep-dives into the codebase structure, architectural decisions, and Tauri APIs, see the docs/vivestream-next folder.


βš–οΈ License

PolyForm Noncommercial License 1.0.0

This project is free to use, modify, and build upon for personal, educational, and non-commercial purposes. You may not use this software for any commercial purpose.

See the LICENSE file for details.

Disclaimer: This tool is intended for personal media archival and offline viewing of content you have the right to access. The developers are not responsible for how users utilize this software.

About

The Next Generation of ViveStream-Revived. A lightning-fast, native YouTube downloader & sleek local media library.

Resources

Stars

1 star

Watchers

0 watching

Forks

Releases

Used by

Contributors

Languages