Repolode
anomalyco

anomalyco/hokum

面向 Wayland 合成器的桌面通知守护进程,使用 Rune 框架绘制可主题化的通知卡片。

Star
247
Fork
11
未关闭 Issue
1
最近提交
6天前

这是什么?

Hokum 是一款通知守护进程,实现了 org.freedesktop.Notifications D-Bus 接口,适用于支持 zwlr_layer_shell_v1 的 Wayland 合成器,例如 niri、sway、Hyprland 和 river。通知卡片由同一项目的 Rust UI 框架 Rune 绘制,支持滑入动画和基于弹簧的重新排列。

设置窗口可以选择主题并调整行为。内置八款主题,也支持按文档格式编写自定义主题。所有配置集中在一个 config.kdl 文件中,设置窗口编辑时会保留注释,手动修改保存后即时生效。按应用设置的规则可控制静音、显示时长以及是否允许突破勿扰模式。

卡片支持操作按钮、带 XDG 激活令牌的点击激活、进度条、音量和亮度浮层的原位替换,以及保持到手动关闭的紧急通知。dismiss、invoke、dnd 等子命令可供快捷键和状态栏调用。服务还能检查新版本,并在点击确认后完成更新。

核心功能

  • 01在支持 layer-shell 的 Wayland 合成器上实现 freedesktop 通知 D-Bus 接口
  • 02基于 Rune Rust UI 框架绘制卡片,带滑入与弹簧动画
  • 03内置八款主题,并支持按文档格式编写自定义主题
  • 04单个 config.kdl 配置文件,可在设置窗口或手动编辑
  • 05可按应用设置静音、显示时长和勿扰模式例外
  • 06提供命令行子命令,便于快捷键和状态栏调用

适用场景

  • 在 sway、Hyprland 等平铺式 Wayland 桌面上接收系统通知
  • 用可主题化的守护进程替代 mako、dunst 或 swaync
  • 通过快捷键或状态栏关闭通知、切换勿扰模式

快速上手

  1. 1

    从 AUR 安装

    paru -S hokum-bin
  2. 2

    随会话启动 Hokum,并停止占用通知名称的其他守护进程

    systemctl --user enable --now hokum.service
  3. 3

    打开设置窗口

    hokum

使用前须知

  • 仅适用于支持 zwlr_layer_shell_v1 的 Wayland 合成器,例如 niri、sway、Hyprland 和 river。
  • 部分桌面外壳本身就是通知服务器,需要先关闭它们自带的通知。
  • 默认每小时检查一次更新服务器,更新需要你点击确认;可以在设置中关闭检查。

收录于专题

标签

常见问题

hokum 是什么?
面向 Wayland 合成器的桌面通知守护进程,使用 Rune 框架绘制可主题化的通知卡片。 Hokum 是一款通知守护进程,实现了 org.freedesktop.Notifications D-Bus 接口,适用于支持 zwlr_layer_shell_v1 的 Wayland 合成器,例如 niri、sway、Hyprland 和 river。通知卡片由同一项目的 Rust UI 框架 Rune 绘制,支持滑入动画和基于弹簧的重新排列。
hokum 可以免费使用吗?用的什么许可证?
hokum 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
hokum 还在维护吗?
活跃维护中。hokum 最近一次提交是在 2026年11月1日。
hokum 适合用来做什么?
在 sway、Hyprland 等平铺式 Wayland 桌面上接收系统通知 用可主题化的守护进程替代 mako、dunst 或 swaync 通过快捷键或状态栏关闭通知、切换勿扰模式
hokum 怎么安装和运行?
从 AUR 安装: paru -S hokum-bin 随会话启动 Hokum,并停止占用通知名称的其他守护进程: systemctl --user enable --now hokum.service 打开设置窗口: hokum
在哪里获取 hokum?
源代码和安装说明在 GitHub 上:https://github.com/anomalyco/hokum

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目