Verses is a TUI tool to view synchronized Spotify lyrics.
Verses is available on AUR under verses-bin
yay -S verses-bin
cargo install verses
git clone https://github.com/Maxuss/verses
cd verses
cargo install --path .
To track spotify stats you will have to create your own Spotify developer app here.
Run verses
for the first time and it will prompt you for your
Client ID. You can get it in the Settings section of your app dashboard. Do not confuse it with client secret!
After that, you can run verses.
q
- quita
- toggle auto-scrollingj
|down key
- scroll downk
|up key
- scroll upr
- reset scroll position
Config file is located at $HOME/.config/verses/config.toml
Each TOML section can be included in a separate file, just specify it using the include
field.
For example:
# config.toml
[theme]
include = "themes/catppuccin.toml"
# themes/catppuccin.toml
[borders]
# configuration there...
[lyrics]
# ...
[progress_bar]
# ...
Config has certain special value types:
These are formatting strings using the Handlebars syntax, specifically the Rust implementation.
Available variables are listend in the example config. There is also an utility function join
that allows to join a list of strings separated by a comma.
Colors can either be represented the Ratatui stringified way or as a hex RGB value, prefixed with #
These are enum variants. You can see all variants here
Windows was not tested at all, and while it should run well, I do not guarantee flawless performance