A premium, feature-rich web-based music player built with React and Vite. This application offers advanced capabilities like local directory synchronization, smart playlists, and a stunning visual interface.
- Local Folder Sync (Advanced): Sync your entire local music collection directly from your hard drive using the File System Access API. No need to upload files to a server!
- Persistent Permission: Remembers your folder access (requires one-click approval on refresh for security).
- Metadata Extraction: Automatically reads ID3 tags (Artist, Album, Cover Art) from your MP3 files.
- Crossfade & Gapless: Smooth transitions between songs with adjustable crossfade duration.
- Smart Playlists:
- Favorites: Your liked songs in one place.
- Most Played: Automatically tracks your listening habits.
- Recently Added: Your latest additions to the library.
- Scoped Playback: Playby artist, album, or playlist with intelligent "Next/Prev" behavior that stays within context.
- Real-time Visualizer: Watch your music come to life with a frequency-based waveform visualizer.
- Dynamic Lyrics: Integrated lyrics viewer with editing capabilities.
- Equalizer: Fine-tune your sound with a 5-band frequency equalizer.
- Theme Support: Toggle between Dark and Light modes with customizable accent colors.
- Framework: React 19
- Build Tool: Vite
- Styling: Tailwind CSS & Vanilla CSS
- Database: IndexedDB (via Dexie-like implementation) for metadata & file handles.
- Icons: Lucide React
- Metadata: jsmediatags
- Audio API: Web Audio API for visualizer and equalizer.
-
Clone the repository:
git clone https://github.com/NXRts/Music-Player.git
-
Navigate to the project directory:
cd music-player -
Install dependencies:
npm install
-
Start the development server:
npm run dev
The Local Folder Sync feature requires the File System Access API, which is currently supported in Chromium-based browsers (Chrome, Edge, Brave). Support for other browsers may vary.
Built with ❤️ by NXRts