Skip to content

Repository files navigation

PhoneMouse

图片

电脑触控板控制手机 (Ubuntu 版)

在电脑上运行 PhoneMouse,会显示一个触控板 UI 窗口,同时电脑通过蓝牙广播名为 PhoneMouse 的蓝牙鼠标设备。手机蓝牙连接后,手机会出现系统级鼠标指针(手机原生功能,无需安装任何 App),随后你用电脑触控板滑动/点击,手机上的鼠标指针就会同步移动/点击。

功能

  • 触控板 UI:单指滑动移动鼠标、单指轻点左键、双指轻点右键、双指上下滑动滚动
  • 底部「左键」「右键」物理按钮
  • 灵敏度调节(1-10 级)
  • 连接状态实时显示(灰色=未启动、黄色=广播中、绿色=已连接)
  • 日志窗口

安装

sudo ./install.sh

安装脚本会自动完成:安装系统依赖、创建虚拟环境、安装 Python 依赖、配置 BlueZ 启用 HID 外设模式、添加用户到 input/bluetooth 组、创建桌面快捷方式。

运行

sudo ./phonemouse.py

或双击桌面快捷方式(自动通过 pkexec 提权)。

操作蓝牙和 uinput 需要 root 权限。

使用流程

  1. 启动 PhoneMouse,点击「启动」,电脑开始广播 PhoneMouse
  2. 手机打开蓝牙,搜索到 PhoneMouse,点击连接
  3. 手机屏幕出现鼠标指针
  4. 在电脑触控板 UI 上滑动/点击,控制手机
  5. 用完点击「断开」或关闭窗口

卸载

sudo ./uninstall.sh

手势说明

触控板操作 手机响应
单指滑动 鼠标指针移动
单指轻点 左键单击
单指双击 左键双击
双指轻点 右键单击
双指上下滑动 滚轮滚动
底部「左键」按钮 左键单击
底部「右键」按钮 右键单击

技术原理

电脑伪装成蓝牙鼠标(HID 外设),手机作为 HID 主机连接。用户操作触控板 → 生成 4 字节 HID 鼠标报告 [按键, X位移, Y位移, 滚轮] → 通过蓝牙发送 → 手机执行鼠标操作。

文件结构

PhoneMouse/
├── phonemouse.py              # 主程序入口
├── main_window.py             # PyQt6 主窗口
├── touchpad_widget.py         # 触控板 UI 组件
├── bluetooth_service.py       # 蓝牙 HID 外设服务
├── mouse_report.py            # HID 鼠标报告构造器
├── resources/
│   ├── icon.svg               # 应用图标
│   └── style.qss              # QSS 样式表
├── requirements.txt           # Python 依赖
├── install.sh                 # 一键安装脚本
├── uninstall.sh               # 卸载脚本
├── phonemouse.desktop         # 桌面快捷方式
└── README.md                  # 用户文档

系统要求

  • Ubuntu 22.04 LTS / 24.04 LTS
  • 手机支持蓝牙鼠标(Android 3.0+ / iOS 7+)

About

PhoneMouse lets you control your phone's mouse pointer using your computer's touchpad. The computer broadcasts itself as a Bluetooth HID mouse device. Your phone connects via system Bluetooth (no app installation needed), and the mouse pointer appears instantly on your phone screen.

Topics

Resources

Stars

2 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages