VibeAmp is a retro-styled YouTube music streamer and MP3 player built with Electron. It brings back the classic aesthetic of legendary media players like Winamp, combined with the modern power of YouTube streaming.
- Retro Winamp Look: A nostalgic user interface with a modern touch.
- YouTube Streaming: Search and play any song directly from YouTube.
- Automatic Dependency Management: No need to install
yt-dlpmanually; the app handles it for you on first run. - Modular Windows: Drag and position individual windows (Player, Playlist, Search, EQ, Album Art, Log) anywhere on your screen — they dock to each other, collapse to their title bar, and come back where you left them.
- Integrated Equalizer: Fineset your audio with a built-in EQ.
- Album Art: High-quality album art display for the currently playing track.
- Remembers Your Setup: Window layout, volume, EQ curve and queue are restored on the next launch.
- Tray Mini Player: An icon in the macOS menu bar (or the Windows notification area) opens a compact popover with the current track, elapsed time and working previous / play-pause / next controls. Right-click it for the same controls as a menu.
- Portable & Standalone:
yt-dlpis stored in the application user-data folder; nothing else needs installing.
- Node.js (Version 16 or later recommended)
npm(comes with Node.js)
To provide a seamless experience, VibeAmp downloads its only external dependency on the first run. You do not need to install it manually.
- yt-dlp: Used for searching YouTube and fetching high-quality audio streams. The download is size-verified before being installed, so an interrupted first run does not leave a broken binary behind.
No FFmpeg is needed: audio streams are handed straight to the player, so nothing is ever transcoded or written to disk.
These binaries are downloaded and stored in a persistent directory outside of the application folder to ensure stability:
- Windows:
%LOCALAPPDATA%\vibeamp-streamer(preserved for compatibility with existing installations). - macOS: VibeAmp's directory under
~/Library/Application Support.
Your layout and settings live in state.json inside VibeAmp's user-data folder on both platforms. Delete that file to reset every window back to its default position.
VibeAmp currently supports Windows and macOS. Linux is not configured as a build target.
-
Clone the repository:
git clone https://github.com/jsoriase/vibeamp.git cd vibeamp -
Install dependencies:
npm install
Start the application in development mode:
npm startEverything is already configured! To create a standalone executable for Windows or macOS, simply run the corresponding command:
npm run build:winnpm run build:macArchitecture-specific builds are also available:
npm run build:mac:x64
npm run build:mac:arm64Note
Build each platform on that platform. Building for macOS requires a Mac and may require Xcode Command Line Tools (xcode-select --install). Public macOS distribution also requires Apple code signing and notarization.
Created by chuchi. Licensed under The Unlicense.