Spotifly is a cross-platform overlay that provides real-time updates on your Spotify playback. By integrating OAuth authentication with the advanced Spotify Web API, it offers a seamless and dynamic display of current track information, playback progress, and upcoming queue details directly on your desktop.
- Cross-Platform Overlay: Built with Electron and Node.js to work on multiple operating systems.
- Secure Authentication: Utilizes OAuth for secure, reliable connection with Spotify.
- Real-Time Playback Monitoring: High-frequency API updates ensure the overlay stays in sync with your Spotify player.
- Responsive UI: Implements debounced window resizing for a smooth user experience.
- Optimized API Management: Features strategic caching and adaptive rate limiting to handle rapid API calls efficiently.
-
Clone the Repository:
git clone https://github.com/your-username/spotifly.git cd spotifly -
Install Dependencies:
npm install -
Run the Application:
npm start
Spotify Credentials: Update your Spotify client credentials in spotifyClient.js with your own client ID and client secret obtained from your Spotify Developer Dashboard.
Customization: Tweak the overlay styling by modifying index.html and renderer.js to match your preferences.
After launching the application, you will be prompted to authenticate with your Spotify account. Once connected, the overlay displays:
- Current Track Details: Including album art, track title, artist, and playback progress.
- Playback Controls: Manage play/pause, skip tracks, toggle shuffle, and repeat.
- Queue Management: View the upcoming tracks in your Spotify queue.
Contributions are welcome! If you'd like to improve Spotifly or report an issue, please:
- Fork the repository.
- Create a feature branch.
- Commit your changes and open a pull request.
Spotifly is released under the MIT License. See the LICENSE file for more details.