🎬 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

---

✨ 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.
• 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 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
Alt + 1	Home
Alt + 2	Favourites
Alt + 3	Playlists
Alt + 4	Artists
Alt + 5	Downloads
Alt + 6	Settings
?	Open Shortcuts Cheat Sheet
Esc	Close Modals / Exit Fullscreen

---

📦 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 Steps

1. Clone the repository:

   git clone https://github.com/rootlocalghost/ViveStream-Next.git
   cd ViveStream-Next

2. Install dependencies:

   bun install

3. Run in Development Mode:

   bun start

4. Run Automated Tests:

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

5. Build for Production:

   bun run tauri build

---

⚖️ 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.