使用cargo install

cargo install kanata

# On Linux and macOS, this may not work without `sudo`, see below
kanata --cfg <your_configuration_file>

在Linux上自行构建和运行

git clone https://github.com/jtroo/kanata && cd kanata
cargo build   # --release optional, not really perf sensitive

# sudo is used because kanata opens /dev/ files
#
# See below if you want to avoid needing sudo:
# https://github.com/jtroo/kanata/wiki/Avoid-using-sudo-on-Linux
sudo target/debug/kanata --cfg <your_configuration_file>

在Windows上自行构建和运行。

git clone https://github.com/jtroo/kanata; cd kanata
cargo build   # --release optional, not really perf sensitive
target\debug\kanata --cfg <your_configuration_file>

在macOS上自行构建和运行

对于macOS 11及更高版本：安装Karabiner VirtualHiDDevice驱动程序。

要激活它

/应用程序/.Karabiner-VirtualHIDDevice-管理器.应用/内容/MacOS/Karabiner-VirtualHIDDevice-管理器激活

对于macOS 10及更早版本：安装Karabiner内核扩展。

git clone https://github.com/jtroo/kanata && cd kanata
cargo build   # --release optional, not really perf sensitive

# sudo is needed to gain permission to intercept the keyboard

sudo target/debug/kanata --cfg <your_configuration_file>

完整的配置指南可以在此处找到。

示例配置文件位于cfg_samples。文件simple.kbd包含一个基本的配置文件，它可能容易理解但并不包含所有功能。文件kanata.kbd包含所有功能的示例和文档。发布资产还包含一个经过测试与该版本一起工作的kanata.kbd文件。所有键名都可以在keys模块中找到，您还可以定义自己的键名。

如果您想启用cmd动作，请添加标志--features cmd。例如

cargo build --release --features cmd
cargo install --features cmd

在Windows上，如果您想编译使用拦截驱动程序的二进制文件，应添加标志--features interception_driver。例如

cargo build --release --features interception_driver
cargo install --features interception_driver

要组合多个标志，请使用单个--features标志，并用逗号分隔功能。例如

cargo build --release --features cmd,interception_driver
cargo install --features cmd,interception_driver

我有一些运行QMK的键盘。QMK允许用户根据他们的意愿自定义键盘的功能。

QMK的一个很好的用例是其能够将键映射到与主键盘行键重叠的位置，但在另一层可访问。我不会评论生产力，但我发现这极大地帮助了我的键盘舒适度。

例如，这些键位于键盘的右侧

7 8 9
u i o
j k l
m , .

在一层中，我在相同的位置有箭头键，在另一层中有数字键盘。

arrows:       numpad:
- - -         7 8 9
- ↑ -         4 5 6
← ↓ →         1 2 3
- - -         0 * .

人们可以添加任何喜欢的自定义来提高舒适度、速度等。就我个人而言，我的主要动机是由于过去的重复性劳损。

然而，QMK并不在所有地方运行。实际上，它不运行在大多数你能够获得的硬件上。你不能在笔记本电脑键盘或任何主流办公室键盘上运行它。我相信QMK提供的舒适度和赋权应该对任何在现有硬件上有电脑的人可用，而不是必须购买一个爱好者的机械键盘（诚然，它们非常好——我自己有几台——但可能很贵）。

我为不支持QMK的键盘找到的最佳替代方案是kmonad。这是一个非常优秀的项目，如果你想要尝试类似的东西，我推荐它。

这个项目的存在原因在于，kmonad是用Haskell编写的，我对如何开始贡献一个Haskell项目一无所知。从局外人的角度来看，我认为Haskell是一种伟大的语言，但我真的无法理解它。在撰写本文时，还有一些突出的问题，使得kmonad对我的个人工作流程不够理想。

这个项目是用Rust编写的，因为Rust是我最喜欢的编程语言，而且存在前人优秀的keyberon crate。