keyd 项目使用教程

1. 项目介绍

keyd 是一个用于 Linux 系统的按键重映射守护进程。它通过使用内核级别的输入原语（如 evdev 和 uinput）来实现按键的重映射，旨在提供一个灵活的系统级解决方案。keyd 支持多种高级功能，如分层、一次性修饰符和宏，使其成为定制键盘布局和按键行为的理想工具。

主要特点

• 分层支持：允许用户定义不同的按键层，以实现复杂的按键映射。
• 一次性修饰符：修饰符键（如 Shift、Ctrl）可以在按下后立即释放，而不会影响后续按键。
• 宏支持：可以定义复杂的按键序列，以实现特定的功能。
• 系统级配置：无需依赖特定的显示服务器（如 X11），可以在虚拟终端（VT）中使用。

2. 项目快速启动

安装 keyd

首先，确保你的系统已经安装了必要的依赖（如 C 编译器和 Linux 内核头文件）。然后，按照以下步骤从源代码安装 keyd：

git clone https://github.com/rvaiya/keyd.git
cd keyd
make && sudo make install
sudo systemctl enable keyd && sudo systemctl start keyd

配置 keyd

在 /etc/keyd/default.conf 文件中添加以下配置：

[ids]
*

[main]
# 将 CapsLock 映射为 Escape（按下时）和 Control（按住时）
capslock = overload(control, esc)

# 将 Escape 键映射为 CapsLock
esc = capslock

重新加载配置

运行以下命令以重新加载 keyd 配置：

sudo keyd reload

3. 应用案例和最佳实践

案例1：自定义键盘布局

假设你希望将 CapsLock 键用作 Escape 键，同时将其作为 Control 键使用。你可以使用以下配置：

[ids]
*

[main]
capslock = overload(control, esc)

案例2：一次性修饰符

如果你想让 Shift 键在按下后立即释放，而不影响后续按键，可以使用以下配置：

[ids]
*

[main]
leftshift = oneshot(shift)

最佳实践

• 保持配置简洁：避免过度复杂的配置，以确保系统的稳定性和易维护性。
• 备份配置文件：在修改配置文件之前，建议备份原始文件，以便在出现问题时可以恢复。

4. 典型生态项目

1. QMK Firmware

QMK Firmware 是一个开源的键盘固件，支持多种自定义功能，如按键重映射、宏和分层。虽然 QMK 主要用于硬件级别的按键重映射，但它与 keyd 在功能上有许多相似之处，可以作为 keyd 的补充工具。

2. xmodmap

xmodmap 是一个用于 X11 显示服务器的工具，用于修改键盘映射。虽然 xmodmap 的功能较为有限，但它可以与 keyd 结合使用，以实现更复杂的按键映射需求。

3. kmonad

kmonad 是另一个用于按键重映射的工具，与 keyd 类似，但它使用 Haskell 编写，提供了更高的可配置性。如果你需要更高级的按键映射功能，可以考虑使用 kmonad。

通过结合这些工具，你可以构建一个强大的按键重映射生态系统，满足各种复杂的键盘定制需求。