Home.zh CN

Seekey Wiki

欢迎！Seekey 是一个轻量的 Wayland 按键可视化工具——把最近几次按键以悬浮气泡的形式画在屏幕底部。

[ Ctrl + C ]  [ Ctrl + C x3 ]  [ hello world ]

语言： English · 简体中文

刚上手的话，最快的路径是：

make                       # 编译
./seekey --init-config     # 生成一个 ./seekey.ini 起点（可选）
./seekey --config-gui      # 图形化启动器式配置菜单（可选）
./seekey --config-tui      # 在终端里改设置（可选）
./seekey                   # 运行

第一次运行没有气泡？你需要读权限访问 /dev/input/event*——./install.sh 会帮你配好。见 Troubleshooting.zh-CN。

---

页面索引

入门

• Installation.zh-CN —— install.sh 选项、各发行版依赖、输入权限
• Build-from-Source.zh-CN —— 手动编译、各发行版依赖、Makefile 目标
• Configuration.zh-CN —— 配置文件、查找顺序、常用设置
• Configuration-Reference.zh-CN —— 每个键的类型、范围和默认值
• GUI-Editor.zh-CN —— 可搜索图形编辑器和 desktop 启动行为
• TUI-Editor.zh-CN —— --config-tui 的快捷键

行为与兼容性

• Compositor-Compatibility.zh-CN —— 各桌面的 layer-shell 与降级情况
• Window-Position.zh-CN —— 锚定、多显示器、点击穿透、GNOME/KDE 固定
• Autostart.zh-CN —— 让 seekey 跟你的合成器一起启动

外观

• Themes-and-Icons.zh-CN —— 预设、自定义颜色、自定义按键字形
• Matugen-Integration.zh-CN —— 跟随壁纸的配色

给贡献者

• Architecture.zh-CN —— 代码是怎么组织的（看不懂源码就先看这个）
• Testing.zh-CN —— 跑测试、理解单元测试
• Translations.zh-CN —— 添加新翻译

参考

• Troubleshooting.zh-CN —— 输入权限、降级模式、没有气泡等