+0
Daily
19,436
stars
586
forks
70
watchers
597
prs
565
issues
32
releases
README
Spotify TUI
!Continuous Integration
!
!
!
A Spotify client for the terminal written in Rust.
!Demo
The terminal in the demo above is using the Rigel theme.
- Spotify TUI
- Installation
- Homebrew
- Snap
- AUR
- Nix
- Void Linux
- Fedora/CentOS
- Cargo
- Note on Linux
- Windows
- Scoop installer
- Manual
- Connecting to Spotify’s API
- Usage
- Configuration
- Limitations
- Using with spotifyd
- Libraries used
- Development
- Windows Subsystem for Linux
- Contributors
- Roadmap
- High-level requirements yet to be implemented
Installation
The binary executable is spt.
Homebrew
For both macOS and Linux
bash
brew install spotify-tui
To update, run
bash
brew upgrade spotify-tui
Snap
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
AUR
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
Nix
Available as the package spotify-tui. To install run:
bash
nix-env -iA nixpkgs.spotify-tui
Where nixpkgs is the channel name in your configuration. For a more up-to-date installation, use the unstable channel.
It is also possible to add the package to environment.systemPackages (for NixOS), or home.packages when using home-manager.
Void Linux
Available on the official repositories. To install, run
bash
sudo xbps-install -Su spotify-tui
Fedora/CentOS
Available on the Copr repositories. To install, run
bash
sudo dnf copr enable atim/spotify-tui -y && sudo dnf install spotify-tui
Cargo
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 the same command again.
Note on Linux
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.
Windows 10
Scoop installer
First, make sure scoop installer is on your windows box, for instruction please visit scoop.sh
Then open powershell and run following two commands:
bash
scoop bucket add scoop-bucket https://github.com/Rigellute/scoop-bucket
scoop install spotify-tui
After that program is available as: spt or spt.exe
Manual
1. Download the latest binary for your OS.
1. cd to the file you just downloaded and unzip
1. cd to spotify-tui and run with ./spt
Connecting to Spotify’s API
spotify-tui needs to connect to STop issues
#160Windows/Linux/macOS package managers34 comments · 2019-11-22#960Api error when playing liked songs30 comments · 2022-03-12#116Playlist section not complete21 comments · 2019-10-27#912Api error: convert result failed, reason: Error("invalid value: integer `-x`, expected u32")20 comments · 2021-11-08#762Keep receiving API error 404 17 comments · 2021-03-08#147Mapping keyboard forward/back/play buttons?17 comments · 2019-11-12#1000Project Update14 comments · 2022-06-30#927localhost is not opening13 comments · 2021-12-24