Miru

Miru 是一款专为 Wayland 桌面环境打造的屏幕放大镜与光标聚光灯工具，主要面向游戏主播和内容创作者。不同于传统的 X11 放大工具，Miru 直接基于 Wayland 协议工作，不经过 XWayland 兼容层，从而获得更低的延迟和更少的画面伪影。项目采用纯 C 语言编写，依赖精简，无需图形界面，所有操作通过键盘快捷键触发，通过配置文件进行定制。

项目简介

Miru 由独立开发者 Vaishnav Sabari Girish 创建，当前版本为 0.6.0，使用 MIT 许可证开源。项目受到 macOS 平台上的 boomer 工具启发，目标是在 Wayland 生态中提供同等体验。Miru 的核心设计理念是按键驱动、无需鼠标、无需 GUI，所有操作围绕键盘展开，配置通过 TOML 文本文件管理，控制通过 Unix 域套接字暴露的 miructl 命令行工具完成。这种设计使其非常适合已经习惯在窗口管理器中绑定快捷键的高级用户和流媒体工作者。

核心功能

• 屏幕放大模式：支持对光标周围区域进行实时放大，支持缩放比例调节和平滑移动
• 光标聚光灯：为光标添加高亮光圈，帮助观众在直播中快速定位操作位置
• 按键驱动控制：所有功能通过 compositor 级键盘快捷键触发，无需鼠标点击
• 无 GUI 架构：没有图形设置界面，配置全部通过 TOML 文本文件管理
• Wayland 原生实现：直接使用 wlroots 协议，不经过 XWayland 兼容层
• 多 compositor 支持：适用于所有实现了 wlr-layer-shell-unstable-v1 和 wlr-screencopy-unstable-v1 协议的 wlroots compositor

技术实现

Miru 依赖两个关键的 wlroots 协议：wlr-layer-shell-unstable-v1 用于在桌面层创建覆盖窗口，wlr-screencopy-unstable-v1 用于实时截取屏幕内容进行放大处理。项目主要在 Niri（基于 wlroots 的平铺式 compositor）上进行开发和测试。由于采用了 compositor 级触发机制，Miru 的快捷键绑定需要在窗口管理器配置中完成，而非应用内部设置。这种架构保证了低延迟和最小的画面干扰，但也意味着目前不支持 GNOME(Mutter)和 KDE Plasma(KWin)等非 wlroots compositor。

快速上手

第一步：确认你的 Wayland compositor 支持 wlr-layer-shell-unstable-v1 和 wlr-screencopy-unstable-v1 协议 第二步：从代码托管平台克隆项目代码并完成编译 第三步：在 compositor 配置中绑定放大功能快捷键 第四步：编辑 TOML 配置文件，设置缩放比例、光标高亮样式等参数 第五步：运行 miructl 命令行工具测试快捷键响应和效果

适用人群

Wayland 桌面环境下的游戏主播和流媒体工作者、需要在屏幕上向观众放大展示操作细节的内容创作者、使用 wlroots 系 compositor（特别是 Niri）的高级用户和窗口管理器爱好者，以及需要临时屏幕放大功能但偏好键盘操作的 Wayland 用户。

出品方：Vaishnav Sabari Girish（独立开发者） 当前版本：0.6.0，项目持续活跃开发中。独立聚光灯模式已在路线图规划中，但尚未实现。