Vibe Music offers an open-source, cloud-based music player designed to counter platform lock-in and proprietary streaming models. It targets users who prefer to manage their own music libraries and seek a privacy-focused, high-performance listening experience. The project provides local control, optional synchronization, and a premium, glassmorphic interface, allowing users to leverage vast music libraries from sources like Archive.org without algorithmic manipulation or trackers.

How It Works

The core of Vibe Music is its "Vibe AI" assistant, which integrates deeply with the user's listening history and library to generate personalized recommendations. This AI can be powered by user-provided OpenAI or Google Gemini API keys, offering real-time, context-aware suggestions. The interface is built with hand-coded, vanilla CSS for optimized performance and a distinct glassmorphic aesthetic, avoiding generic UI frameworks. It functions as a Progressive Web App (PWA) with advanced offline storage management using IndexedDB and Workbox, and supports native lock-screen controls via the Media Session API.

Quick Start & Requirements

1. Clone the repository: git clone https://github.com/vibe-music/vibe-music.git
2. Navigate to the directory: cd vibe-music
3. Install dependencies: npm install
4. Run the development server: npm run dev The application will be accessible at http://localhost:5173. Prerequisites include Node.js and Git. A live demo is available at web.vibemusic.fm.

Highlighted Details

• PWA-Native: Installable on iOS, Android, and Desktop with zero friction.
• Vibe AI: Context-aware assistant powered by OpenAI or Google Gemini (user keys required) for personalized recommendations.
• Glassmorphism: Custom, hand-coded vanilla CSS for a high-performance, aesthetic interface.
• Offline Engine: Utilizes IndexedDB via LocalForage and Workbox for robust offline storage and caching.
• Media Session API: Enables native lock-screen controls for seamless playback.

Maintenance & Community

The project encourages community contributions through forks and pull requests, emphasizing code quality and performance. A roadmap indicates upcoming native applications for Android, iOS/iPadOS, and desktop platforms, along with advanced features like real-time visualizers and spatial audio. Further details are available at vibemusic.fm.

Licensing & Compatibility

Vibe Music is licensed under the PolyForm Noncommercial 1.0.0 license. This license restricts the use of the software for commercial purposes, limiting its compatibility with closed-source or commercial applications.

Limitations & Caveats

Native mobile and desktop applications are currently listed as "Coming Soon." The Vibe AI functionality requires users to supply their own API keys for OpenAI or Google Gemini. The non-commercial license is a significant consideration for potential adopters looking to integrate or build upon this project in a commercial context.