mac-tv-remote
v1.0.0
Published
Turn an iPhone into a low-latency LAN keyboard and trackpad remote for a Mac connected to a TV.
Maintainers
Readme
Mac 电视遥控器
把 iPhone 变成连接电视的 Mac 的低延迟局域网键盘与触控板。支持方向键、播放/暂停、全屏、单击、右键、双指滚动、惯性滚动和双击拖拽,并可作为 PWA 添加到 iPhone 主屏幕。
npm 安装(推荐)
npm install -g mac-tv-remote
mac-tv-remote手机与 Mac 连接同一 Wi‑Fi,然后访问终端显示的地址。默认端口为 8765:
mac-tv-remote --port 9000从源码运行
cd ~/mac-tv-remote
python3 server.py默认端口是 8765,也可以用 python3 server.py --port 9000 修改。
支持 IINA、VLC、QuickTime Player、Music、Spotify、Safari、Google Chrome 和夸克。第一次控制时,macOS 可能询问是否允许“终端”控制播放器,请选择允许。Chrome/夸克需要在菜单“显示 → 开发者 → 允许 Apple 事件中的 JavaScript”中开启对应选项;Safari 也需要开启“开发”菜单中的同名选项。
第一次使用触控板时,请到“系统设置 → 隐私与安全性 → 辅助功能”,允许运行服务的终端访问。触控板支持单指移动、轻点单击、双指滚动,下面另有右键按钮。
安全提示
服务允许网页控制 Mac 的鼠标和键盘,默认监听局域网的所有网络接口。请只在可信网络中运行,用完后按 Control+C 停止服务。
需要 macOS、Python 3、Node.js 18+ 与 Xcode Command Line Tools(用于首次编译鼠标控制组件)。
