Debian Linux下Curtsies库无法全局检测按键的解决方案咨询

Curtsies的局限性 #

Curtsies是专为终端交互设计的输入处理库，仅能捕获终端窗口激活时的按键输入，无法实现全局按键监听，要达成终端外的按键检测需求，必须更换其他库。

推荐替代方案 #

1. pynput（推荐，易用跨平台） #

pynput支持全局监听键盘、鼠标事件，API简洁直观，适配多数场景。

先安装库：

pip install pynput

适配你需求的代码示例：

from pynput.keyboard import Listener
import pyautogui

# 按键绑定规则：(目标按键字符, 鼠标相对移动x值, 鼠标相对移动y值)
binds = [('b', 100, 100)]

def on_press(key):
    try:
        # 获取按下的可打印字符
        pressed_key = key.char
        for bind in binds:
            if pressed_key == bind[0]:
                pyautogui.moveRel(bind[1], bind[2])
    except AttributeError:
        # 忽略Shift、Ctrl这类无字符的特殊按键
        pass

# 启动监听器并持续运行
with Listener(on_press=on_press) as listener:
    listener.join()

2. python-xlib（X11系统专属，底层控制） #

Debian默认使用X11窗口系统，python-xlib可直接与X11交互，适合需要更底层控制的场景。

先安装库：

sudo apt-get install python3-xlib

代码示例：

from Xlib import display, X
import pyautogui

binds = [('b', 100, 100)]
# 建立字符与X11键码的映射（仅添加需要的按键）
keycode_map = {
    'b': display.Display().keysym_to_keycode(ord('b'))
}

def handle_event(event):
    if event.type == X.KeyPress:
        keycode = event.detail
        # 匹配绑定的按键并执行鼠标移动
        for char, x, y in binds:
            if keycode_map.get(char) == keycode:
                pyautogui.moveRel(x, y)

# 初始化X11显示连接
d = display.Display()
root = d.screen().root

# 设置捕获键盘按键事件
root.change_attributes(event_mask=X.KeyPressMask)

# 持续监听事件循环
while True:
    event = d.next_event()
    handle_event(event)

注意事项 #

• 全局按键监听需要系统权限，若运行时出现权限问题，可尝试用sudo执行脚本。
• 若你的Debian使用Wayland桌面环境，需注意部分全局监听库兼容性，建议切换回X11以获得最佳支持。

内容的提问来源于stack exchange，提问作者PancakeCoder