evdevremapkeys 项目使用教程

最新推荐文章于 2025-03-13 15:37:41 发布

薛曦旖Francesca

最新推荐文章于 2025-03-13 15:37:41 发布

阅读量921

点赞数 29

CC 4.0 BY-SA版权

本文链接：https://blog.youkuaiyun.com/gitblog_00264/article/details/142274818

evdevremapkeys 项目使用教程

evdevremapkeys Daemon to remap events on linux input devices 项目地址: https://gitcode.com/gh_mirrors/ev/evdevremapkeys

1. 项目介绍

evdevremapkeys 是一个用于在 Linux 输入设备上重新映射按键事件的守护进程。该项目的主要动机是解决在 Wayland 桌面环境下无法使用传统的 X11 工具（如 xbindkeys）进行按键映射的问题。Wayland 使用 libinput 管理输入事件，但 libinput 本身并不提供按键映射的配置机制。因此，evdevremapkeys 通过在 Linux 输入子系统级别读取物理输入设备的事件，并在虚拟设备上生成新的输入事件来实现按键映射。

技术实现

项目通过读取物理输入设备的事件，并在 uinput 管理的虚拟设备上生成新的输入事件来实现按键映射。用户可以选择是否完全复制原始物理设备的事件，或者仅生成新的映射事件。为了避免原始事件被 libinput 捕获并触发桌面环境中的动作，项目需要对物理设备进行“抓取”操作，以确保其他客户端不会接收到这些事件。

2. 项目快速启动

安装依赖

在开始之前，请确保系统中已安装以下依赖：

Python >= 3.4
python-daemon >= 2.1.2
Python evdev binding >= 0.7.0
pyxdg > 0.25
PyYAML >= 3.12

克隆项目

首先，克隆 evdevremapkeys 项目到本地：

git clone https://github.com/philipl/evdevremapkeys.git
cd evdevremapkeys

配置文件

编辑示例配置文件，并将其放置在以下位置：

mkdir -p ~/.config/evdevremapkeys
cp examples/config.yaml ~/.config/evdevremapkeys/config.yaml

构建静态可执行文件

运行以下脚本以构建静态可执行文件：

./build-binary.sh

启动服务

将示例服务文件复制到用户服务目录，并启动服务：

mkdir -p ~/.config/systemd/user
cp examples/evdevremapkeys.service ~/.config/systemd/user/
systemctl --user daemon-reload
systemctl --user enable evdevremapkeys
systemctl --user start evdevremapkeys

3. 应用案例和最佳实践

应用案例

Wayland 桌面环境：在 Wayland 桌面环境中，传统的 X11 按键映射工具无法使用。evdevremapkeys 提供了一种在输入子系统级别进行按键映射的解决方案。
自定义键盘映射：用户可以通过配置文件自定义键盘按键的映射，例如将某个按键映射为组合键（如 Super+A）。

最佳实践

配置文件管理：建议将配置文件放置在用户目录下（如 ~/.config/evdevremapkeys/config.yaml），以便每个用户可以有独立的配置。
服务管理：使用 Systemd 用户服务来管理 evdevremapkeys，确保服务在用户登录时自动启动，并在用户注销时自动停止。