waybar-updates

一个用于从官方仓库和 AUR 检查 Arch Linux 更新的 Tiny Waybar 模块。

功能

• 发送（可选）关于更新的 通知。
• 支持 GNU gettext 本地化（欢迎贡献新的 po 文件！）
• 支持 自定义格式 以仅显示您想要的数字。
• 使用 Aurweb RPC 检查 AUR 更新，因此可独立工作。
• 可以检查开发包的上游变更（参见 -d 选项)
• 在工具提示中显示更新。
• 支持两种状态：pending-updates 和 updated 以使用不同的图标或隐藏模块。
• 使用无限循环来提供 Waybar JSON 更新。
• 可配置检查之间的间隔。

安装

1. 使用 AUR 包 waybar-updates。
2. 手动使用 make && make install。

依赖项

• pacman-contrib
• gettext
• curl
• jq
• libnotify
• git（如果使用 --devel 选项)

用法

~/.config/waybar/config:

"modules-left": [
  ...
  "custom/pacman",
  ...
],

...

"custom/pacman": {
  "format": "{icon}{0}",
  "return-type": "json",
  "format-icons": {
    "pending-updates": " ",
    "updated": ""
  },
  "exec-if": "which waybar-updates",
  "exec": "waybar-updates"
}

~/.config/waybar/style.css

@keyframes blink-update {
	to {
		background-color: dodgerblue;
	}
}

#custom-pacman {
	animation-timing-function: linear;
	animation-iteration-count: infinite;
	animation-direction: alternate;
}
#custom-pacman.pending-updates {
	animation-name: blink-update;
	animation-duration: 3s;
}

您可以复制已编译的 mo 文件，并在希望使用本地化但不想将它们存储在 /usr/share/locale 中时使用 TEXTDOMAINDIR="$HOME/.config/waybar/scripts"。

命令行选项

以下选项可用：

选项	值	默认值	描述
-f, --format	string	{total}	用于主输出文本的自定义格式（参见 Formatting)
-t, --tooltip	string		自定义工具提示格式（参见 Formatting)
-i, --interval	int	6	检查之间的间隔（以秒为单位）
-c, --cycles	int	600	在线检查之间的循环次数（例如 6s interval * 600 cycles = 3600s = 1h）
-l, --packages-limit	int	10	在通知和工具提示中显示的最大软件包数量
-d, --devel	none	off	同时检查开发软件包的上游更改
-n, --notify	none	off	开启更新通知

格式化

工具提示和主文本格式化程序都可以使用“标签”来格式化其输出。

在 --tooltip 中，{} 标签将被替换为软件包列表。在 --format 中，它是 {total} 的别名。

支持的自定义计数标签为 {aur}、{dev}、{pacman} 和 {total}。这些标签支持自定义前缀和/或后缀，可用于定义图标，例如 {A :aur:\n}，但请记住：

• 值必须用冒号分隔（:）
• 值可以包含换行符和制表符（\n、\r 和 \t）
• 值不能包含花括号（{ 或 }），

本地化

支持的语言：

• 英语
• 俄语
• 法语
• 土耳其语

1. 在 poedit 或任何替代工具中打开 po/waybar-updates.pot。
2. 为您的语言生成 po 文件。
3. 进行翻译！
4. 通过创建 Pull Request 提交 po 文件！

---

受 waybar-module-pacman-updates 启发。