A Spotify client for the terminal written in Rust.
The terminal in the demo above is using the Rigel theme.
The binary executable is spt.
For both macOS and Linux
bash
brew install Rigellute/tap/spotify-tui
To update, run
bash
brew upgrade spotify-tui
For a system with Snap installed, run
bash
snap install spt
The stable version will be installed for you automatically.
If you want to install the nightly build, run
bash
snap install spt --edge
For those on Arch Linux you can find the package on AUR here. If however you're using an AUR helper you can install directly from that, for example (in the case of yay), run
bash
yay -S spotify-tui
Available on the official repositories. To install, run
bash
sudo xbps-install -Su spotify-tui
Use this option if your architecture is not supported by the pre-built binaries found on the releases page.
First, install Rust (using the recommended rustup installation method) and then
bash
cargo install spotify-tui
This method will build the binary from source.
To update, run
bash
cargo install spotify-tui --force
For compilation on Linux the development packages for libssl are required.
For basic installation instructions, see install OpenSSL.
In order to locate dependencies, the compilation also requires pkg-config to be installed.
If you are using the Windows Subsystem for Linux, you'll need to install additional dependencies.
cd to the file you just downloaded and unzipcd to spotify-ui and run with ./sptspotify-tui needs to connect to Spotifyโs API in order to find music by
name, play tracks etc.
Instructions on how to set this up will be shown when you first run the app.
But here they are again:
Create a Client ID and create an appEdit Settingshttp://localhost:8888/callback to the Redirect URIssptClient IDClient SecretAnd now you are ready to use the spotify-tui ๐
You can edit the config at anytime at ${HOME}/.config/spotify-tui/client.yml.
The binary is named spt.
When running spotify-tui press ? to bring up a help menu that shows currently implemented key events and their actions.
A configuration file is located at ${HOME}/.config/spotify-tui/config.yml, for snap ${HOME}/snap/spt/current/.config/spotify-tui/config.yml
(not to be confused with client.yml which handles spotify authentication)
The following is a sample config.yml file:
```yaml
theme: active: Cyan banner: LightCyan errorborder: Red errortext: LightRed hint: Yellow hovered: Magenta inactive: Gray playbarbackground: Black playbarprogress: LightCyan playbar_text: White selected: LightCyan text: "255, 255, 255"
behavior: seekmilliseconds: 5000 volumeincrement: 10 # The lower the number the higher the "frames per second". You can decrease this number so that the audio visualisation is smoother but this can be expensive! tickratemilliseconds: 250
keybindings: # Key stroke can be used if it only uses two keys: # ctrl-q works, # ctrl-alt-q doesn't. back: "ctrl-q"
jumptoalbum: "a"
# Shift modifiers use a capital letter (also applies with other modifier keys # like ctrl-A) jumptoartist_album: "A"
managedevices: "d" decreasevolume: "-" increasevolume: "+" toggleplayback: " " seekbackwards: "<" seekforwards: ">" nexttrack: "n" previoustrack: "p" copysongurl: "c" copyalbumurl: "C" help: "?" shuffle: "s" repeat: "r" search: "/" audio_analysis: "v" ```
This app uses the Web API from Spotify, which doesn't handle streaming itself. So you'll need either an official Spotify client open or a lighter weight alternative such as spotifyd.
If you want to play tracks, Spotify requires that you have a Premium account.
Follow the spotifyd documentation to get set up.
After that there is not much to it.
sptd to go to the device selection menu and the spotifyd "device" should be there - if not check these docsxorg-dev (required for clipboard support)cd to itcargo runYou might get a linking error. If so, you'll probably need to install additional dependencies required by the clipboard package
bash
sudo apt-get install -y -qq pkg-config libssl-dev libxcb1-dev libxcb-render0-dev libxcb-shape0-dev libxcb-xfixes0-dev
Thanks goes to these wonderful people (emoji key):
This project follows the all-contributors specification. Contributions of any kind welcome!
The goal is to eventually implement almost every Spotify feature.
This table shows all that is possible with the Spotify API, what is implemented already, and whether that is essential.
| API method | Implemented yet? | Explanation | Essential? |
| ------------------------------------------------- | ---------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------ | ---------- |
| track | No | returns a single track given the track's ID, URI or URL | No |
| tracks | No | returns a list of tracks given a list of track IDs, URIs, or URLs | No |
| artist | No | returns a single artist given the artist's ID, URI or URL | Yes |
| artists | No | returns a list of artists given the artist IDs, URIs, or URLs | No | Get Spotify catalog information about an artist's albums | Yes |
| artistalbums | Yes | Get Spotify catalog information about an artist's top 10 tracks by country. | Yes |
| artisttoptracks | No | Get Spotify catalog information about artists similar to an | Yes |
| artistrelatedartists | No | Get Spotify catalog information about artists similar to an identified artist. Similarity is based on analysis of the Spotify community's listening history. | Yes |
| album | Yes | returns a single album given the album's ID, URIs or URL | Yes |
| albums | No | returns a list of albums given the album IDs, URIs, or URLs | No |
| searchalbum | Yes | Search album based on query | Yes |
| searchartist | Yes | Search artist based on query | Yes |
| searchtrack | Yes | Search track based on query | Yes |
| searchplaylist | Yes | Search playlist based on query | Yes |
| albumtrack | Yes | Get Spotify catalog information about an album's tracks | Yes |
| user | No | Gets basic profile information about a Spotify User | No |
| playlist | Yes | playlist | Yes |
| currentuserplaylists | Yes | Get current user playlists without required getting his profile | Yes |
| userplaylists | No | Gets playlists of a user | No |
| userplaylist | No | Gets playlist of a user | No |
| userplaylisttracks | Yes | Get full details of the tracks of a playlist owned by a user Yes |
| userplaylistcreate | No | Creates a playlist for a user | Yes |
| userplaylistchangedetail | No | Changes a playlist's name and/or public/private state | Yes |
| userplaylistunfollow | No | Unfollows (deletes) a playlist for a user | Yes |
| userplaylistaddtrack | No | Adds tracks to a playlist | Yes |
| userplaylistreplacetrack | No | Replace all tracks in a playlist | No |
| userplaylistrecordertracks | No | Reorder tracks in a playlist | No |
| userplaylistremovealloccurrencesoftrack | No | Removes all occurrences of the given tracks from the given playlist | No |
| userplaylistremovespecificoccurrenesoftrack | No | Removes all occurrences of the given tracks from the given playlist | No |
| userplaylistfollowplaylist | No | Add the current authenticated user as a follower of a playlist. | Yes |
| userplaylistcheckfollow | No | Check to see if the given users are following the given playlist | Yes |
| me | No | Get detailed profile information about the current user. | Yes |
| currentuser | No | Alias for me | Yes |
| currentuserplayingtrack | Yes | Get information about the current users currently playing track. | Yes |
| currentusersavedalbums | No | Gets a list of the albums saved in the current authorized user's "Your Music" library | Yes |
| currentusersavedtracks | Yes | Gets the user's saved tracks or "Liked Songs" | Yes |
| currentuserfollowedartists | No | Gets a list of the artists followed by the current authorized user | Yes |
| currentusersavedtracksdelete | No | Remove one or more tracks from the current user's "Your Music" library. | Yes |
| currentusersavedtrackscontain | No | Check if one or more tracks is already saved in the current Spotify userโs โYour Musicโ library. | Yes |
| currentusersavedtracksadd | Yes | Save one or more tracks to the current user's "Your Music" library. | Yes |
| currentusertopartists | No | Get the current user's top artists | Yes |
| currentusertoptracks | No | Get the current user's top tracks | Yes |
| currentuserrecentlyplayed | No | Get the current user's recently played tracks | Yes |
| currentusersavedalbumsadd | No | Add one or more albums to the current user's "Your Music" library. | Yes |
| currentusersavedalbumsdelete | No | Remove one or more albums from the current user's "Your Music" library. | Yes |
| userfollowartists | No | Follow one or more artists | Yes |
| userunfollowartists | No | Unfollow one or more artists | Yes |
| userfollowusers | No | Follow one or more users | No |
| userunfollowusers | No | Unfollow one or more users | No |
| featuredplaylists | No | Get a list of Spotify featured playlists | Yes |
| newreleases | No | Get a list of new album releases featured in Spotify | Yes |
| categories | No | Get a list of new album releases featured in Spotify | Yes |
| recommendations | No | Get Recommendations Based on Seeds | Yes |
| audiofeatures | No | Get audio features for a track | No |
| audiosfeature | No | Get Audio Features for Several Tracks | No |
| audioanalysis | No | Get Audio Analysis for a Track | No |
| device | Yes | Get a Userโs Available Devices | Yes |
| currentplayback | Yes | Get Information About The Userโs Current Playback | Yes |
| currentplaying | No | Get the Userโs Currently Playing Track | No |
| transferplayback | No | Transfer a Userโs Playback | No |
| startplayback | Yes | Start/Resume a Userโs Playback | Yes |
| pauseplayback | Yes | Pause a Userโs Playback | Yes |
| nexttrack | Yes | Skip Userโs Playback To Next Track | Yes |
| previoustrack | Yes | Skip Userโs Playback To Previous Track | Yes |
| seek_track | No | Seek To Position In Currently Playing Track | Yes |
| repeat | Yes | Set Repeat Mode On Userโs Playback | Yes |
| volume | No | Set Volume For Userโs Playback | No |
| shuffle | Yes | Toggle Shuffle For Userโs Playback | Yes |
