SteelSeries Spotify Linker is a project designed to display the current music playing on Spotify on a SteelSeries keyboard with an OLED display. Presently, it supports only 128x40 displays (e.g. Apex Pro).
- Retrieves the currently playing music on Spotify via the API.
- Automatically updates the OLED display with the current track information.
- Features automatic scrolling titles, a progress bar, and displays elapsed time and duration.
- Displays a clock if no music is playing or if the music has been paused for too long (configurable)
- Different clock display modes (12-hour or 24-hour)
- Easily configurable via the system tray menu
You'll need Python version 3.8 or higher, which can be installed from here.
You'll also need the SteelSeries GG software.
- Download the latest version of the program and extract the files.
- Run
install.batto start the installation prompt and set up your Spotify credentials.
For detailed instructions, refer to "Spotify API configuration". - You can now launch the application from the Windows Startup menu.
📄 Note : When you launch the program for the first time, a web page will open to authorize the Spotify API to connect to your account.
⚠️ If you want to uninstall the application, don't forget to exit it first using the button in the system tray.
If you haven't configured your Spotify credentials, an error message will appear when launching the application. Do not close it immediately!
- Open the system tray menu (located in the bottom-right corner of the taskbar).
- Click on "Open configuration" to access the settings file and enter your Spotify credentials.
- Close the error message.
- Restart the application.
A debug mode is available in the software folder launcher_debug (by default, the installation path is C:\Program Files\SpotifyLinker). This will allow you to view the output for troubleshooting purposes.
The configuration file is stored in %APPDATA%/SpotifyLinker.
To configure the Spotify API, refer to Spotify API configuration.
{
...
"date_format": 12, // Choose between 12-hour or 24-hour format
"display_seconds": true, // Set to 'true' to display seconds, 'false' to hide
"timer_threshold": 2, // Set the number of seconds after which the clock will appear after pausing the song
"spotify_fetch_delay": 2, // Represents the delay in seconds between each spotify API request
"extended_font": true, // Support for special characters (Japanese) [Requires a reboot]
"display_timer": true,
"display_player": true
}
⚠️ You can reduce the time between requests to the Spotify API. But be careful, if you reduce it too much, the application may not work properly. The Spotify API may block it due to rate limits. By default, this interval is set to 2 seconds to ensure that you never exceed this limit, but feel free to adjust it to suit your needs. For more information, please visit the Spotify Rate Limits.
Music display may take some time due to API limitations. Data is retrieved by default every 2 seconds via Spotify's API, so there may be a slight desynchronization.
