基于X11协议的Linux快捷键管理

---

一、X11协议

• X Window System，简称X或X11，类Unix系统的窗口系统，X11协议是一种C/S的协议。
• X11相对Wayland比较老旧，但至今其使用范围依然庞大。
• X.Org建议使用GTK+或Qt进行开发，本文直接使用Xlib C进行演示。

---

二、实例

1. 程序代码

本例使用宏定义LOG来实现日志记录，运行时捕获释放的Ctrl+Shift+Z来发送一条桌面通知。
主要使用的方法为：
XOpenDisplay：初始化显示
XKeysymToKeycode：获取键值
XGrabKey：绑定按键
XPending：等待事件（阻塞）
XNextEvent：取事件

/********************************************************
 * https://www.x.org/releases/current/doc/libX11/libX11/libX11.html
 *******************************************************/
#include <stdlib.h>
#include <stdio.h>
#include <time.h>

#include <X11/Xlib.h>
#include <X11/Xutil.h>
#include <X11/Xatom.h>

// 日志记录
#define LOG(format, ...)                                \
{                                                       \
    printf(format, ##__VA_ARGS__);                      \
    printf("\n");                                       \
    char buffer[26];                                    \
    time_t timeval = time(NULL);                        \
    struct tm* tm_info = localtime(&timeval);           \
    strftime(buffer, 26, "%Y-%m-%d %H:%M:%S", tm_info); \
    FILE *log = fopen("log.txt","a");                   \
    fprintf(log,"%s : "format"\n",buffer,##__VA_ARGS__);\
    fclose(log);                                        \
}

// 按键处理
void handleShortKey(XKeyEvent xkey)
{
    LOG("%s","Key has been press and release");
    system("notify-send Hello");
}

int main()
{
    // 初始化
    Display * display = XOpenDisplay(NULL);
    if(display == NULL)
    {
        LOG("Unable to open X display\n");
    }

    // 绑定按键
    XSync(display, 0);
    for (int screen = 0; screen < ScreenCount (display); screen++)
    {
        Window grab_window = RootWindow (display, screen);
        LOG("Current screen %d, current window %ld\n", screen, grab_window);

        KeyCode customKeyCode = XKeysymToKeycode(display, XK_Z);
        uint modifiers = ControlMask | ShiftMask;

        XGrabKey(display, customKeyCode, modifiers,
                grab_window, False, GrabModeAsync, GrabModeAsync);
    }
    XSync(display, 0);

	// 事件循环
    while (True)
    {
        XEvent event;
        Bool matched = False;
        while (XPending(display) || (!matched)) 
        {
            XNextEvent(display, &event);
            switch (event.type) 
            {
                case KeyPress:
                    LOG("KeyPress");
                    break;
                case KeyRelease:
                    LOG("KeyRelease");
                    handleShortKey(event.xkey);
                    matched = True;
                    break;
                default:
                    break;
            }
        }
    }
    XCloseDisplay(display);
    return 0;
}

2.Makefile

all:
	gcc -Wall *.c -o xHotKeyMgr  -I. -lX11

clean:
	rm -f xHotKeyMgr

---

三、总结

基于X11协议开发的快捷键管理可以避免热键冲突，使用Xlib开发API相对复杂，难度较大，建议按照官方推荐使用开发套件。