evremap 项目使用教程

项目介绍

evremap 是一个针对 Linux/Wayland 系统的键盘输入重映射工具，由 @wez 开发。该项目允许用户重新定义键盘按键的功能，使其更加符合个人使用习惯。evremap 通过获取输入设备的独占访问权限，并维护按键状态模型，然后根据用户配置进行按键重映射，最终通过虚拟输出设备发出相应的按键变化。

项目快速启动

安装依赖

首先，确保系统上安装了必要的开发库：

# 对于 redhat/centos 系统
sudo dnf install libevdev-devel

# 对于 debian/ubuntu 系统
sudo apt install libevdev-dev pkg-config

克隆项目

克隆 evremap 项目到本地：

git clone https://github.com/wez/evremap.git
cd evremap

构建项目

使用 Cargo 构建项目：

cargo build --release

配置文件

创建一个配置文件 my-config-file.toml，例如：

device_name = "AT Translated Set 2 keyboard"

[remap]
"Caps Lock" = "Left Ctrl"

运行 evremap

以 root 权限运行 evremap：

sudo target/release/evremap remap my-config-file.toml

应用案例和最佳实践

案例一：Caps Lock 键重映射

许多用户希望将 Caps Lock 键重映射为 Ctrl 键，以提高编辑效率。通过以下配置可以实现：

device_name = "AT Translated Set 2 keyboard"

[remap]
"Caps Lock" = "Left Ctrl"

案例二：组合键重映射

用户可能希望将某些组合键重映射为其他功能键，例如将 Alt + Left 重映射为 Home 键：

device_name = "AT Translated Set 2 keyboard"

[remap]
"Alt+Left" = "Home"

典型生态项目

Evremap-GUI

Evremap-GUI 是一个图形界面工具，用于编辑 evremap 的配置文件。它提供了更直观的方式来管理按键映射。

构建 Evremap-GUI

# 安装依赖
sudo dnf install libevdev-devel # redhat/centos
# 或
sudo apt install libevdev-dev pkg-config # debian/ubuntu

# 构建项目
cargo build --release

运行 Evremap-GUI

sudo target/release/evremap-gui

通过以上步骤，您可以快速启动并使用 evremap 项目，同时了解其应用案例和相关生态项目。