Crossroads is a high-fidelity, audiophile-grade music player designed specifically for FLAC enthusiasts. Inspired by the soulful roots of the Delta Blues and the technical precision of modern high-end audio, Crossroads offers an immersive, bit-perfect listening experience.
- Bit-Perfect Playback: Native support for high-resolution FLAC files with technical metadata (sample rate, bitrate, bit depth) always visible.
- Immersive Lyrics: Real-time, synchronized lyrics fetched via LRCLIB, featuring a deep-blurred album art background and smooth transitions.
- Apple Music-Style Mini Player: A compact, vertical window mode with dedicated tabs for 'Now Playing', 'Lyrics', and 'Current Queue'.
- Smart Playlists: Automatically generated collections for your Favorites, Recently Played, and Top Tracks.
- Audiophile Statistics: Track your listening habits with 'Stats for Nerds', including total playback time and high-res badges.
- Premium Aesthetics: A modern, glassmorphic UI with vibrant micro-animations, custom icons (Lucide), and macOS vibrancy effects.
- Global Media Controls: Support for hardware media keys and global keyboard shortcuts (Space, Arrow keys).
-
Clone the repository:
git clone https://github.com/iniyan/Crossroads.git cd Crossroads -
Install dependencies:
npm install
-
Start the development server:
npm run dev
To create a distributable installer for your OS:
npm run distThe installer will be generated in the release/ directory.
| Shortcut | Action |
|---|---|
Space |
Play / Pause |
→ (Right Arrow) |
Next Track |
← (Left Arrow) |
Previous Track (or restart if >3s) |
Cmd/Ctrl + O |
Scan Music Folder |
- Core: React & Vite
- Desktop Wrapper: Electron
- State Management: React Hooks & Electron Store
- Metadata Parsing: Music-Metadata
- Lyrics API: LRCLIB
- Icons: Lucide React
“I went to the crossroad, fell down on my knees...” — Robert Johnson
Created with ❤️ by the Crossroads Team.