a-funk/open-appleremote

选用指南

AI 根据 README 整理 · 2026/10/17 09:31:09

使用方式

通过命令行使用，提供list、monitor、gestures、lab、keys、voice等子命令。

查看 README 依据

[bluetooth]# scan on [bluetooth]# pair AA:BB:CC:DD:EE:FF [bluetooth]# trust AA:BB:CC:DD:EE:FF [bluetooth]# connect AA:BB:CC:DD:EE:FF [bluetooth]# scan off ``` **2. Let your user read it** (once), instead of running everything as root: ```sh sudo cp udev/71-appleremote.rules /etc/udev/rules.d/ sudo udevadm control --reload && sudo udevadm trigger ``` Then press a button on the remote. The rules file explains the options for `/dev/uinput` and for headless machines. **3. Watch it:** ```sh python3 -m appleremote list # finds the remote's hidraw node

python3 -m appleremote monitor # decoded events, one JSON object per line python3 -m appleremote gestures # tvOS-style moves, tilts and buttons python3 -m appleremote lab # live web lab: open http://127.0.0.1:8791 sudo python3 -B -m appleremote voice --out voice/ # each Siri press as a WAV file: see Voice ``` The lab listens on 127.0.0.1 only. On a headless machine, forward it with `ssh -L 8791:127.0.0.1:8791 <host>` and open the same address on your computer. **4. Use it as a keyboard:** ```sh python3 -m appleremote keys ```

部署要求

需要Linux系统，BlueZ（默认启用hog插件），Python 3.8或更高版本。语音功能需要libopus解码器。

查看 README 依据

project's recorded gen-1 frames. Reports are welcome (see [CHANGELOG.md](CHANGELOG.md)). ## Quick start You need Linux with BlueZ (its `hog` plugin is on by default) and Python 3.8 or newer. There is nothing to install: clone the repository and run the commands below from its top directory. **1. Pair the remote** (once). Hold **Menu + Volume Up** for about 5 seconds next to the computer, then pair it in `bluetoothctl`. After `scan on`, the remote shows up named after its serial number; use its address: ```text $ bluetoothctl [bluetooth]# agent NoInputNoOutput [bluetooth]# default-agent

recognizer, and prints a line per press. A quick try, on Linux, with the udev rule of Quick start in place: ```sh sudo apt install libopus0 # the decoder (Debian, Ubuntu); nothing else needs it sudo python3 -B -m appleremote voice --out voice/ # Ctrl-C to stop; -B: no root-owned __pycache__ in your clone ``` ```json {"kind": "press", "wav": "voice/siri-20261011-201500-01.wav", "frames": 213, "lost": 0, "held": 163, "seconds": 4.26, "level": 21034, "ended": true} ```

已知限制

仅支持初代Siri Remote（A1513/A1962），不支持第二代和第三代。语音功能尚未正式发布，虚拟键盘未经过硬件测试。

查看 README 依据

0.1.0 code passed there: `list`, `monitor` and `lab` as a normal user through the udev rule, and the reconnect after sleep once LE privacy is off. The virtual keyboard (`keys`) isn't hardware-tested yet. - **Should work, untested**: the A1513 (the original gen-1 remote, which the A1962 is a variant of) and other Linux machines with a recent BlueZ. Reports welcome. - **Not supported yet**: Siri Remote gen 2 and gen 3. Per the prior art they use other report IDs and another unlock ([sources](docs/PROTOCOL.md#other-remotes)). `list` shows them as another Apple device.

- **Voice** (`voice`, not released yet): tested on synthetic frames, and its decoding on the recorded gen-1 frames of [Jack-R1/SiriRemoteVoiceDecoder](https://github.com/Jack-R1/SiriRemoteVoiceDecoder), replayed. It hasn't run live in this package yet. It ports code from the private project this package came from, which picked exactly the remote's whole voice frames out of a btmon capture of an A1962. - Live use is Linux-only (hidraw, uinput, the HCI monitor); `--replay` and the tests run anywhere. ## Limitations