sptui is a Spotify TUI player, written in Go and leveraging the charmbracelet/bubbletea library.
Visit the GitHub Releases page for sptui and download the appropriate binary for your operating system.
If you are on NetBSD, a package is available from the official repositories. To install, simply run:
pkgin install sptui
To use sptui, you need to connect it to Spotify's API. Follow these steps:
Edit Settings
, add http://localhost:21112/callback
to the Redirect URIs
. Don’t forget to save your changes.SPOTIFY_ID
. # Replace your_client_id with the actual Client ID you obtained from Spotify.
SPOTIFY_ID=your_client_id sptui
Once authenticated, you are ready to use sptui!
Once authenticated, your Spotify API token will be stored at ${HOME}/.config/sptui/spotify_token.json
. Ensure this file is kept secure as it contains sensitive information.
Here are the key bindings for sptui:
Key | Action |
---|---|
h j k l |
Navigate (left, down, up, right) |
esc |
Return to the previous screen |
q |
Quit sptui |
:play |
Play current selection |
:pause |
Pause playback |
:next |
Next track |
:prev |
Previous track |
:device |
Select a device |