KMonad 项目安装指南：从入门到精通-优快云博客

本文链接：https://blog.youkuaiyun.com/gitblog_01173/article/details/148524676

KMonad 项目安装指南：从入门到精通

kmonad An advanced keyboard manager 项目地址: https://gitcode.com/gh_mirrors/km/kmonad

前言

KMonad 是一个强大的键盘映射工具，它允许用户重新定义键盘行为，创建复杂的按键组合和层切换功能。本文将详细介绍 KMonad 在各种操作系统上的安装方法，帮助用户选择最适合自己的安装方式。

二进制安装（快速开始）

对于希望快速体验 KMonad 的用户，可以直接下载预编译的二进制文件：

Linux 64位系统
Windows 系统（目前最新版本为0.4.1）

预编译二进制文件省去了编译过程，适合大多数普通用户使用。下载后只需赋予执行权限即可运行。

包管理器安装

对于使用特定 Linux 发行版的用户，可以通过系统包管理器安装 KMonad，这是最方便的安装方式。

Arch Linux 用户

Arch Linux 官方仓库的 extra 仓库中已包含 KMonad 包，安装命令：

sudo pacman -S kmonad

GNU Guix 用户

Guix 用户可以通过以下命令安装：

guix install kmonad

安装后需要手动复制 udev 规则文件：

sudo cp <kmonad-path>/lib/udev/rules.d/70-kmonad.rules /lib/udev/rules.d/

Void Linux 用户

Void Linux 用户可通过 xbps 安装：

sudo xbps-install -S kmonad

NixOS 用户

NixOS 提供了多种安装方式：

通过 nixpkgs 直接安装
使用 flake.nix 配置
在 configuration.nix 中添加服务配置

完整配置示例：

services.kmonad = {
  enable = true;
  keyboards = {
    myKeyboard = {
      device = "/dev/input/by-id/my-keyboard-kbd";
      config = builtins.readFile /path/to/config.kbd;
    };
  };
};

从源码编译

对于需要自定义功能或使用最新开发版的用户，可以从源码编译 KMonad。

使用 Stack 编译

Stack 是推荐的跨平台编译工具：

stack build    # 仅编译二进制
stack install  # 编译并安装到PATH目录

使用 Nix 编译

Nix 用户可以使用以下命令编译：

nix build nix

或进入开发环境：

nix-shell nix/shell.nix

静态编译

要生成静态链接的二进制文件：

$(nix build --no-link -A fullBuildScript)

使用 Docker 编译

无需安装开发环境，直接使用 Docker 容器编译：

docker build -t kmonad-builder -f ci/Dockerfile.linux .
mkdir output
docker run --rm -v ${PWD}/output:/host/ kmonad-builder bash -c 'cp -vp /output/* /host/'
docker rmi kmonad-builder

Windows 环境安装

Windows 用户需要：

安装 Haskell 平台
安装 MinGW 提供 GCC 支持
使用 Stack 编译：

stack build

或者使用 Scoop 安装工具链：

scoop install stack
cd kmonad
stack build
stack install

macOS 安装指南

macOS 安装较为特殊，需要安装系统扩展才能正常工作。

内核扩展 (kext) 安装

推荐安装已签名的二进制版本：

git clone --recursive https://github.com/kmonad/kmonad.git
cd c_src/mac/Karabiner-VirtualHIDDevice
make install

驱动扩展 (dext) 安装

对于 macOS Catalina 及更新系统：

git clone --recursive https://github.com/kmonad/kmonad.git
open c_src/mac/Karabiner-DriverKit-VirtualHIDDevice/dist/Karabiner-DriverKit-VirtualHIDDevice-5.0.0.pkg
/Applications/.Karabiner-VirtualHIDDevice-Manager.app/Contents/MacOS/Karabiner-VirtualHIDDevice-Manager activate

编译 KMonad

安装 Stack 后：

git clone --recursive https://github.com/kmonad/kmonad.git
brew install haskell-stack
cd kmonad/
stack install --flag kmonad:kext  # 或 --flag kmonad:dext