(已停止维护) Spot

适用于 GNOME 桌面的 Gtk/Rust 原生 Spotify 客户端。仅支持高级账户使用！

基于 librespot 开发。

欢迎通过 Matrix 参与讨论。

安装

使用说明

凭据

建议安装一个兼容 libsecret 的密钥环应用，例如 GNOME Keyring（又名 seahorse）。这将允许在多次启动之间安全地保存您的密码。

在 GNOME 环境中，相关功能应该可以直接使用。在其他桌面环境中可能需要一些额外设置：请参阅 ArchWiki 条目，了解如何随会话自动启动守护进程的详细说明。

特别注意，要启用自动登录，您可能需要为用户账户和密钥环使用相同的密码，并且密钥环可能需要设置为默认。

更多详细信息请参见此评论！

功能

仅支持高级账户使用！

• 播放控制（播放/暂停、上一曲/下一曲、进度调整、随机播放、重复模式（无、全部、单曲））
• 选择模式：轻松浏览并选择多个曲目加入播放队列
• 浏览已保存的专辑和播放列表
• 搜索专辑和艺术家
• 查看艺术家的作品发布
• 查看用户的播放列表
• 查看专辑信息
• 通过 Secret Service 进行凭据管理
• MPRIS 集成
• 播放列表管理（创建和编辑）
• 喜欢的曲目

贡献指南

欢迎参与贡献！如果您愿意，在提交贡献时可以将自己添加到 AUTHORS 文件中。

对于任何大型功能或变更，请务必先创建一个 issue 来讨论实现方案和设计决策。

翻译

翻译工作通过 gettext 进行管理，相关文件位于 po/ 子目录中。

请使用 POEditor 提交翻译。

如果您愿意，欢迎提交 PR 将自己添加到 TRANSLATORS 文件中！

构建

使用 GNOME Builder 和 flatpak

前提条件：通过 flatpak 安装 org.freedesktop.Sdk.Extension.rust-stable SDK 扩展。Builder 可能会自动为您安装，但可能会安装较旧的版本；请确保安装的版本与 GNOME 所使用的 Freedesktop SDK 版本相匹配。

在 GNOME Builder 中打开项目，并将 dev.alextren.Spot.development.json 配置设为活动状态。然后进行构建即可 😃

手动构建

需要 Rust（稳定版）、GTK4 以及其他一些依赖项。同时还需要 libadwaita 和 blueprint-compiler：目前并非所有发行版都提供这些包，您可能需要自行构建它们！

使用 meson：

meson target -Dbuildtype=debug -Doffline=false --prefix="$HOME/.local"
ninja install -C target
# to run test/linter/etc
meson test -C target  --verbose

这将安装一个 .desktop 文件以及其他文件，并且 spot 可执行文件将被放置在 .local/bin 目录中（你可能需要将此目录添加到你的路径中）。

若要构建优化的发布版本，请改用 -Dbuildtype=release。

重新生成 pot 文件

添加新的 msgids 时，不要忘记重新生成/更新 pot 文件。

ninja spot-pot -C target
ninja spot-update-po -C target

从 POEditor 拉取更新的字符串

我们现在使用 POEditor 以及出色的 poeditor-sync 工具。

poeditor pull

为 flatpak 重新生成源代码

使用 flatpak-cargo-generator.py：

ninja cargo-sources.json -C target

调试

将 RUST_LOG 环境变量设置为适当的级别。

调试版本（flatpak）可从 Github 上的 master 分支获取（参见 spot-snaphots 操作）。

Spot 会将图片和 HTTP 响应缓存在 ~/.cache/spot 中。

Spot 使用 isahc，而 isahc 又使用 libcurl，因此你可以设置 https_proxy 环境变量来辅助调试。在调试模式下，Spot 会跳过 SSL 证书验证。