verses

Verses 是一个用于查看同步 Spotify 歌词的 TUI 工具。

安装

AUR（适用于 Arch 用户）

Verses 在 AUR 中可通过 verses-bin 获取

yay -S verses-bin

使用 cargo

cargo install verses

从源码

git clone https://github.com/Maxuss/verses
cd verses
cargo install --path .

先决条件

要跟踪 Spotify 统计数据，您必须创建自己的 Spotify 开发者应用 这里。

首次运行 verses，它会提示您输入您的客户端 ID。您可以在应用的仪表板 设置 部分获取它。不要与客户端密钥混淆！

之后，您就可以运行 verses。

控制

• q - 退出
• a - 切换自动滚动
• j | 下键 - 向下滚动
• k | 上键 - 向上滚动
• r - 重置滚动位置

配置

配置文件位于 $HOME/.config/verses/config.toml

每个 TOML 部分都可以包含在一个单独的文件中，只需使用 include 字段指定它即可。

例如

# config.toml

[theme]
include = "themes/catppuccin.toml"

# themes/catppuccin.toml
[borders]
# configuration there...

[lyrics]
# ...

[progress_bar]
# ...

配置具有某些特殊值类型

general.display.*_format

这些是使用 Handlebars 语法编写的格式化字符串，具体请参考 Rust 实现。示例配置中列出了可用变量。还有一个 join 实用函数，允许用逗号分隔的字符串连接列表。

颜色

颜色可以是 Ratatui 字符串化方式表示，也可以是前缀为 # 的十六进制 RGB 值。

边框样式

这些是枚举变体。您可以在 此处查看所有变体

Windows 支持

尚未对 Windows 进行测试，尽管它应该运行良好，但我无法保证完美无瑕的性能