KMonad 快速参考指南：键盘映射配置详解

KMonad 快速参考指南：键盘映射配置详解

【免费下载链接】kmonad An advanced keyboard manager 项目地址: https://gitcode.com/gh_mirrors/km/kmonad

概述

KMonad 是一个强大的键盘映射工具，允许用户通过配置文件重新定义键盘行为。本文将作为 KMonad 配置的快速参考指南，详细介绍其核心配置元素和使用方法。

基础配置 (defcfg)

defcfg 块是 KMonad 配置的起点，用于定义全局设置和输入输出设备。

输入输出设备配置

不同操作系统下的设备配置方式：

• Linux:

  input  (device-file "/dev/input/by-id/usb-04d9_daskeyboard-event-kbd")
  output (uinput-sink "自定义输出设备名称")
  

• Windows:

  input  (low-level-hook)
  output (send-event-sink)
  

• macOS:

  input  (iokit-name "键盘产品字符串")
  output (kext)
  

全局配置选项

1. fallthrough (布尔值，默认false)：允许未定义的按键保持原功能
2. allow-cmd (布尔值，默认false)：允许执行shell命令（有安全风险）
3. cmp-seq (按键，默认RightAlt)：Unicode输入的组合键(X11专用)
4. 延迟设置：控制按键序列执行时的延迟时间

完整配置示例

(defcfg
  input  (device-file "/dev/input/by-id/usb-04d9_daskeyboard-event-kbd")
  output (uinput-sink "我的KMonad输出"
          "sleep 1 && setxkbmap -option compose:ralt")
  cmp-seq ralt
  cmp-seq-delay 5
  fallthrough true
  allow-cmd true
)

按键定义

KMonad 提供了丰富的按键定义方式，满足各种高级需求。

基本按键操作

1. press-only/release-only：仅发送按下或释放事件

   (press-only lctrl)  ; 仅发送左Ctrl按下事件
   

2. 修饰键组合：

   • C- = Ctrl
   • A- = Alt
   • M- = Meta/Win
   • S- = Shift
   • 前缀加R表示右侧修饰键

高级按键功能

1. around系列：创建修饰键组合

   (around lalt del)  ; Alt+Delete组合
   

2. sticky-key：临时保持按键状态

   (sticky-key 500 lctrl)  ; 按下后保持Ctrl状态500ms
   

3. cmd-button：执行shell命令

   (cmd-button "date >> /tmp/log.txt")  ; 按键执行日期记录
   

点击类按键 (Tap Buttons)

KMonad 提供了多种点击行为定义方式：

1. tap-macro：执行按键序列

   (tap-macro K M o n a d)  ; 依次按下K-M-o-n-a-d
   

2. tap-hold系列：根据按键时长决定行为

   (tap-hold 200 a sft)  ; 短按输出a，长按变为Shift
   

3. multi-tap：多击序列

   (multi-tap 300 a 300 b c)  ; 快速连按ab输出c
   

键盘层 (Layers)

KMonad 的层系统允许创建复杂的按键布局。

基础层定义

1. defsrc：定义物理键盘布局

   (defsrc
     grv  1    2    3    4    5    ; 定义键盘第一行
     tab  q    w    e    r    t    ; 定义键盘第二行
     ; ... 其他按键定义
   )
   

2. deflayer：定义功能层

   (deflayer qwerty
     @sym 1    2    3    4    5    ; 使用@符号引用别名
     tab  q    w    e    r    t
     ; ... 其他按键映射
   )
   

层操作

1. layer-toggle：临时切换层

   (layer-toggle numbers-layer)  ; 按住时切换到数字层
   

2. layer-switch：永久切换基础层

   (layer-switch new-base-layer)  ; 切换到新基础层
   

3. layer-add/layer-rem：添加/移除叠加层

   (layer-add temp-layer)  ; 添加临时层
   (layer-rem temp-layer)  ; 移除临时层
   

实用技巧

1. 合理使用fallthrough：只重定义需要的按键，保持其他按键原功能
2. 层嵌套：通过多层叠加实现复杂功能
3. 延迟优化：根据实际使用体验调整按键延迟参数
4. 安全考虑：谨慎使用allow-cmd功能，避免安全风险

通过灵活组合这些功能，KMonad 可以满足从简单按键重映射到复杂宏定义的各类需求，大幅提升键盘使用效率和舒适度。

【免费下载链接】kmonad An advanced keyboard manager 项目地址: https://gitcode.com/gh_mirrors/km/kmonad