⚠️ ViveStream-Revived is Deprecated

🚀 ViveStream-Next is here!

This repository is no longer actively maintained. Development has moved to ViveStream-Next, the next-generation rewrite featuring improved performance, a refreshed UI, and better stability.

---

---

---

🚨 Notice: ViveStream-Revived is now in Maintenance Mode

ViveStream-Revived has been superseded by the next-generation release: ViveStream-Next.

ViveStream-Next features a fully overhauled engine, faster performance, reduced memory usage, improved media scraping, and a redesigned modern interface. Active development and new features have moved entirely to the new repository.

👉 Switch to ViveStream-Next Now

---

👋 ViveStream-Revived is the legacy edition of our offline-first media player. It downloads content via yt-dlp, organizes it into a local SQLite database, and provides an offline interface for media playback without ads or buffering.

---

🚀 Core Features

• 📥 Versatile Downloader:
  • YouTube & More: Download videos and playlists from supported sites with automatic local playlist creation.
  • Smart Downloads: Skips redundant downloads while bumping the "date added" index.
  • Import Local Files: Index existing media files from your system directly into the local database with automated thumbnail generation.
• ✂️ Advanced Download Controls:
  • Clip specific sections using start/end timestamps.
  • Split videos by chapters into standalone tracks.
  • SponsorBlock integration for removing sponsored segments, intros, and outros.
  • Subtitle scraper (supports official and auto-generated captions).
  • Browser cookie injection for age-restricted/member-only content.
• 📚 Library Management:
  • Fuzzy Search: Query across videos, artists, and playlists instantly.
  • Filtering: Slice library views by media type (video/audio), duration, and source.
  • Metadata Editor: Direct inline tag editing for titles, artists, and descriptions.
  • Custom Playlists & Artists: Drag-and-drop playlist builder with custom artwork support.
• 🎬 Integrated Player:
  • Context-aware queues, gapless playback preloading, and configurable sleep timers.
  • Global system media key bindings.
  • Theater mode, fullscreen, miniplayer, playback speed controls, and subtitle rendering.
• 📦 Self-Contained: Packaged with an internal portable Python environment, preconfigured yt-dlp, and FFmpeg binaries.

---

📥 Installation (Legacy)

Recommended Method (Installer)

⚠️ Note: If upgrading from ViveStream v7.6.0 or lower, perform a clean uninstall first to avoid duplicate installations.

1. Go to the Releases page.
2. Download the installer for your OS:
   • 🪟 Windows: ViveStream-Revived-Setup-x.x.x.exe or .msi.
   • 🐧 Linux: .AppImage, .deb, .rpm, .snap, or .tar.gz.
3. Run the installer.

🗑️ Uninstallation & Data

• 🪟 Windows: The uninstaller prompts to retain or purge the database and media folder.
• 🐧 Linux: Package managers do not auto-delete ~/ViveStream. Purge via Settings > Danger Zone > Clear All Media & Delete Database before uninstalling.

---

💻 For Developers

See docs/DEVELOPMENT.md and docs/ARCHITECTURE.md for technical documentation.

1. Clone the repository:

   git clone [https://github.com/rootLocalGhost/ViveStream-Revived.git](https://github.com/rootLocalGhost/ViveStream-Revived.git)
   cd ViveStream-Revived
   

2. **Install dependencies:**
```bash
npm install

3. Hydrate Binaries:

npm run env:update

4. Run the application:

npm start

---

🎮 How to Use

1. Download or Import Content: Navigate to Downloads to grab online media, or go to Settings > Maintenance > Import Files for local directories.
2. Manage Library: Browse via Home, Favorites, Playlists, or Artists with top-bar search and filtering.
3. Play Media: Click any thumbnail to trigger the playback queue.

---

⌨️ Keyboard Shortcuts (Player)

Key	Action
Space or K	Play / Pause
M	Mute / Unmute
F	Toggle Fullscreen
T	Toggle Theater Mode
I	Toggle Miniplayer
← / →	Seek Back / Forward 5s
↑ / ↓	Volume Up / Down
N	Play Next Media
P	Play Previous Media

---

🛠️ Build From Source

# Windows (.exe, .msi, .zip source)
npm run build:win

# Linux (.AppImage, .deb, .snap, .tar.gz)
npm run build:linux

# Linux via Docker (.rpm and others)
npm run build:docker

# Build All
npm run build:all

---

⚠️ Issues and Fixes

• Check out BUILD_PREPARATION for build debugging.

---

🤝 Contributing

New features are prioritized on the ViveStream-Next codebase. For legacy fixes here:

1. Fork the repo.
2. Create your feature branch (git checkout -b fix/legacy-issue).
3. Commit your changes (git commit -m 'fix: resolve issue').
4. Push to the branch (git push origin fix/legacy-issue).
5. Open a Pull Request.

---

📄 License

This project is licensed under the MIT License. See the LICENSE file for details.