cupidbity/cupid-music-player

Cupid Music Player is a desktop music player built with a pixel art aesthetic, featuring an animated record player with a spinning vinyl disc and a moveable needle. It runs as a native desktop application on macOS, Windows, and Linux, built with Electron, React, and Vite. It supports three sources of music. For local files, you drop MP3 files into a folder and the player automatically reads the embedded track metadata, including title, artist, and album art. For Spotify, you connect your account and browse your playlists, but the actual audio is fetched from YouTube in the background rather than from Spotify's own servers, so a Spotify Premium subscription is not required. For Apple Music, you can browse your library playlists using your Apple Music account, and again a paid subscription is not required just to browse. The interface includes a draggable progress bar with a star shaped indicator, scrolling text for long track titles, and a pink and blue theme toggle that the app remembers between sessions, with the taskbar or dock icon changing to match whichever theme is active. Setting up Spotify integration requires creating a free developer app registration on Spotify's developer portal to obtain an API key. Apple Music integration similarly requires a free Apple Developer account key, generated through Apple's developer site. The project can be run in development mode with a simple install and start command, or packaged into an installable desktop application for macOS, Windows, or Linux. The macOS build is currently unsigned, so on first launch you may need to explicitly allow it through your system's security settings before it will open. Files without embedded metadata will still play but may show up labeled as unknown.