qsk (又名量子软键盘)

你从未意识到的键盘重映射软件。

受开源键盘固件项目 QMK 启发，qsk 的目标是为主机系统上连接的任意键盘启用类似的功能。例如，笔记本电脑上的内置键盘或 1990 年代部门商店桌面计算机中附带的那个糟糕的通用键盘。

功能

• 标准键盘重映射，例如将 F 映射为 U
• 由具有特殊功能的键激活的可组合层键映射
• "轻触切换"，在给定时间内轻触键将发送其常规按键，并在保持时激活指定的层

与 QMK 的丰富功能集相比，此功能集仍然相当小。按需实现功能 -- 欢迎贡献！

使用（目前仅限 Linux）

尝试示例重映射器

安装

cargo install qsk

获取可用设备列表

qsk list-devices

在确定要使用的设备后，运行重映射器

sudo qsk remap /path/to/device-file

注意：上面需要 sudo，因为默认情况下您的 Linux 登录用户没有必要的权限来抓取您选择的键盘输入设备，也不能创建新的虚拟键盘设备，通过该设备发出重映射的按键。

自定义和构建您自己的重映射器

上一节描述了如何使用通过 crates.io 提供的二进制文件，目前无法自定义其键映射。将来，将能够传递一个包含键映射 DSL/脚本的文件路径。目前，键盘重映射定义必须编译在内。为了使这更容易，qsk 提供了一个 cargo-generate 模板，它可以帮助您快速开始创建自己的 qsk 项目

cargo generate --git https://github.com/waynr/qsk.git qsk-template

cargo-generate 将提示您输入值以填充 qsk 模板项目，其中之一将是 "项目名称"。传递给此处的值将是您新 qsk 项目的目录名称。要构建它

cd $PROJECT_NAME
cargo build

获取可用设备列表

./target/debug/$PROJECT_NAME list-devices

在确定要使用的设备后，运行重映射器

sudo ./target/debug/$PROJECT_NAME remap /path/to/device-file

QSK 程序宏重映射 DSL

上述模板生成一个类似以下的 main.rs

use std::error;

use qsk_macros;

use qsk::entrypoint;

fn main() -> Result<(), Box<dyn error::Error>> {
    let layer_composer = qsk_macros::remap!(
        ModLayer[Active]: {
            Y -> HOME,
            F -> TapToggle(Navigation, F),
        },
        Navigation: {
            END -> Exit(),
            Y -> HOME,
            U -> PAGEDOWN,
            I -> PAGEUP,
            O -> END,
            H -> LEFT,
            J -> DOWN,
            K -> UP,
            SEMICOLON -> RIGHT,
        },
    )?;

    entrypoint(layer_composer)?;
    Ok(())
}

这演示了 qsk_macros::remap! 宏，它接受一个简化层键盘重映射定义的微型 DSL 作为输入。目前，这的唯一替代方案是在 Rust 中直接定义 qsk_types::LayerComposer。在您的生成项目中，您只需要更新键映射，保存并构建。

在定义键盘重映射层时，需要注意几个标识符类别

• 层名称 是如上所示的 Navigation 和 ModLayer 这样的标识符。这些名称前面有一个冒号和一个可选的方括号组，由键函数使用。例如，在 TapToggle 中，Navigation 表示当按下 -> 左侧的键时，应该激活 Navigation 层。
• 层 选项 是如上所示的方括号中的 Active 这样的标识符。这些用于配置单个层。
• 键码 是如上所示的 K、END 和 UP 这样的标识符。在 -> 的左侧，键码表示要重映射的 "输入" 键。在 -> 的右侧，这表示根据左侧的键码将输出哪个键码。
• 键函数 是如上所示的 Exit 和 TapToggle 这样的标识符。这些只能出现在 -> 的右侧，并用于赋予左侧对应的键特殊属性。

键函数

• TapToggle(<layer_ref>, <tap_key>) 当按下并保持左侧的键时，将激活名为 <layer_ref> 的层。当它在默认的轻触切换超时（180 毫秒）内轻触时。
• Exit() 当按下左侧的键时，程序将优雅地退出。

brain -> fingers -> keyboard -> CPU interrupts -> interrupt handlers (kernel) ->
evdev subsystem (kernel/userspace) -> qsk -> X11 input drivers OR libinput for
Wayland -> your program