sptlrx - Synchronized lyrics in your terminal
Contents
Browser
FORMAT
# config.yaml
player: browser
browser:
port: 8974
NOTES
You need to install a browser extension https://wnp.keifufu.dev/extension/getting-started. If you don't
change the default port, no further configuration is required. Otherwise, create a custom adapter in the
extension settings. Youcanonlyrunoneinstanceononeport.
Local
FORMAT
# config.yaml
local:
folder: ""
NOTES
If you want to use your local collection of .lrc files to display lyrics, specify the folder to scan. The
application will use files with the most similar name. All other lyrics sources will be disabled.
April 2025 SPTLRX(5)
Location
The config file will be created at the first launch. It is located in ~/.config/sptlrx/config.yaml. Run
sptlrx -h to see the full path.
Mopidy
FORMAT
# config.yaml
player: mopidy
mopidy:
address: 127.0.0.1:6680
Mpd
FORMAT
# config.yaml
player: mpd
mpd:
address: 127.0.0.1:6600
password: ""
Mpris
FORMAT
# config.yaml
player: mpris
mpris:
players: []
NOTES
System player that supports MPRIS protocol will be used. You can also specify a whitelist of players to
use, example: players:[rhythmbox,spotifyd,ncspot]. Run playerctl-l to get the names.
Name
sptlrx - Synchronized lyrics in your terminal
Spotify
FORMAT
# config.yaml
cookie: [<your cookie>]
player: spotify
NOTES
If you want to use Spotify as your player or lyrics source, you need to specify your cookie.
1. Open your browser.
2. Press F12, open the Network tab and go to open.spotify.com.
3. Click on the first request to open.spotify.com.
4. Scroll down to the RequestHeaders, right click the cookie field and select Copy value.
5. Paste it to your config.
You can also set the SPOTIFY_COOKIE environment variable or pass the --cookie flag.
TREATYOURCOOKIELIKEAPASSWORDANDNEVERSHAREIT!
