i3blocks-spotify-persist

Spotify桌面应用的持久性i3blocks模块。

点击上面的图片观看屏幕录制。

功能

• 由于事件驱动模型，几乎立即更新：模块是一个持续运行的过程，接收D-Bus信号
• 可配置的输出
• 可配置的鼠标点击操作（需要i3blocks版本1.5或更高版本）

安装

需要Python版本3.5或更高版本。

可以使用pip从PyPI安装模块

python3 -m pip install [--user] i3blocks-spotify-persist

安装完成后，将会有一个名为i3blocks-spotify-persist的模块脚本，位置取决于是否存在--user pip标志（例如，/usr/local/bin/i3blocks-spotify-persist或~/.local/bin/i3blocks-spotify-persist）。

为了避免依赖问题，可以使用pipx

pipx install i3blocks-spotify-persist

在这种情况下，模块脚本将被放置在~/.local/bin目录中。

依赖项

必需（自动安装）

• PyGObject
• dbus-python

可选（手动安装）

• Font Awesome（用于状态图标）

用法

将以下行添加到您的i3blocks配置文件中

[spotify]
command=/path/to/bin/i3blocks-spotify-persist [-c /path/to/config.json]
interval=persist

配置

可以使用JSON配置文件配置模块。配置本身及其所有选项都是可选的。

配置选项

format

类型： 字符串

默认值： {status}: {artist} – {title}

包含占位符的模板字符串。占位符格式为 {field} 和 {field:filter}。

支持的字段

• status，是以下枚举值之一：Playing、Paused、Stopped
• artist
• title

支持的过滤器

• upper — 将字符串转换为大写
• lower — 将字符串转换为小写
• capitalize — 将字符串的第一个字符转换为大写，其余转换为小写
• icon — 仅对 status 字段有效：将文本状态转换为图标（见下文 status_icons 选项）

markup_escape

类型：布尔型

默认值： false

此选项指定是否使用相应的 XML 实体来转义特殊字符（如 <、>、&）。如果使用 Pango 标记（在 i3blocks 配置中 markup=pango），则设置为 true，否则为 false。

status_icons

类型：对象

默认值： {"Playing": "\uf04b", "Paused": "\uf04c", "Stopped": "\uf04d"}

此选项为 icon 过滤器提供映射（见上文）。默认值使用来自 Font Awesome 的图标。

mouse_buttons

类型：对象

默认值： {"1": "PlayPause"}

此选项提供 X11 鼠标按钮编号到 MPRIS 方法 的映射。您可以使用 xev 程序来确定按钮编号。

dedupe

类型：布尔型

默认值： true

由于某些原因，Spotify 应用会为一个动作/事件发出多个相同的信号（例如，播放或暂停曲目时会产生 四个 PropertiesChanged 信号）。如果此选项设置为 true，则块插件将比较更新后的消息与之前的消息，并且只有当它发生变化时才打印它。除非进行调试，否则没有理由关闭去重。

配置示例

{
    "format": "<span font_family='monospace' color='#ffa651' weight='bold'>{status:icon} {status:upper}</span> <span color='#72bf44' weight='bold'>{artist}</span><span color='#ffa651'>᛫</span><span color='#b2d235'>{title}</span>",
    "markup_escape": true,
    "status_icons": {
        "Playing": "|>",
        "Paused": "||",
        "Stopped": "[]"
    },
    "mouse_buttons": {
        "1": "PlayPause",
        "9": "Previous",
        "8": "Next"
    }
}

命令行参数

• -h、--help — 显示所有命令行参数并退出
• -c、--config — 配置文件路径（见上文）

以下参数覆盖相应的配置选项或默认值（即命令行参数具有最高优先级）

• --format
• --markup-escape / --no-markup-escape
• --dedupe / --no-dedupe

许可证

MIT 许可证。