pywaylandauto

Wayland 键盘鼠标输入注入工具。通过 EIS (Emulated Input Server) 或 wlroots 虚拟输入协议实现全局鼠标键盘控制。

当前适配 Kylin V11 (kylin-wlcom)。UOS、Ubuntu 等发行版规划中。

安装

git clone https://github.com/.../pywaylandauto.git
cd pywaylandauto
python3 -m venv --system-site-packages .venv
.venv/bin/pip install -e .

快速开始

pywaylandauto daemon start          # 启动后台 daemon
pywaylandauto move 960 540          # 移动鼠标
pywaylandauto click 500 300         # 左键点击
pywaylandauto right-click 500 300   # 右键点击
pywaylandauto input "Hello 世界"    # 输入文本（中文通过剪贴板粘贴）
pywaylandauto key ctrl c            # 组合键 Ctrl+C
pywaylandauto daemon stop           # 停止 daemon

CLI 命令

Daemon

鼠标

键盘

Python API

import pywaylandauto

pywaylandauto.move(960, 540)
pywaylandauto.click(500, 300)
pywaylandauto.right_click(500, 300)
pywaylandauto.double_click(500, 300)
pywaylandauto.mouse_down(100, 100)
pywaylandauto.mouse_up(500, 300)
pywaylandauto.drag(100, 100, 500, 300)
pywaylandauto.scroll(300, 200, dy=3)
pywaylandauto.input("Hello")
pywaylandauto.key("ctrl", "c")
pywaylandauto.key_down("shift")
pywaylandauto.key_up("shift")

pos = pywaylandauto.mouse_position()  # {'x': 500.0, 'y': 300.0}

首次调用自动启动 daemon。坐标使用物理像素，daemon 自动按缩放比转换。

架构

CLI / Python API
    └── Client (UNIX socket + JSON 协议)
          └── Daemon (GLib 主循环)
                ├── EIS Backend  ──→ com.kylin.Wlcom.EIS.RemoteDesktop
                └── Wlroots Backend (回退) ──→ Wayland socket

• Socket：$XDG_RUNTIME_DIR/pywaylandauto.sock（0600）
• 无授权弹窗，daemon 启动即连接
• 坐标自动物理像素 → 逻辑坐标转换

路线图

• Kylin V11 (kylin-wlcom) — EIS + wlroots 双后端
• UOS — EIS D-Bus 入口适配
• Ubuntu / GNOME — XDG Desktop Portal RemoteDesktop 入口适配
• Sway / Hyprland — wlroots backend 开箱可用，需验证

许可

MIT