Repository navigation
Releases
0.2.3
The remote no longer hangs when the Apple TV takes the session away.
- The TV serves one Companion session at a time. Running another
clickercommand, a secondclicker tui, or the iPhone Remote evicts the open remote; that was showing up astimed out after 5s. - The client now fails the moment the socket drops instead of waiting out the 5s timeout, and the TUI reconnects in well under a second.
- An action that never left the machine is retried after the reconnect, so the first button press still lands.
- Polling drops to every 15s while the TV is off, and reconnects update the header without filling the activity log.
Prebuilt: clicker-0.2.3-x86_64-unknown-linux-gnu.tar.gz and clicker-0.2.3-aarch64-apple-darwin.tar.gz, checksums in SHA256SUMS.
clicker 0.2.2
Long press is here.
Lholds select, the long-press gesture that opens context menus on tvOS. Counts work (2L).J/Kstill hold the pad, and the activity log now distinguishes a hold from a tap ("held select").- The key screen folds refresh into the power line to keep the new row inside 80×24.
Prebuilt: clicker-0.2.2-x86_64-unknown-linux-gnu.tar.gz and clicker-0.2.2-aarch64-apple-darwin.tar.gz, checksums in SHA256SUMS.
0.2.1
Volume keys that leave your terminal alone, and a remote that survives sleep.
- Volume moves to
>/<andctrl-a/ctrl-x(vim's increment and decrement).+and-are terminal font-zoom keys in many setups, so they are no longer bound. clicker tuinow reconnects when the Apple TV drops the Companion session after sleeping or waking, and rediscovers it when DHCP moves the address. Presses after the reconnect work instead of failing with "cannot queue frame: channel closed".- The help page grew a line and now fits whole at 80×24.
Prebuilt: clicker-0.2.1-x86_64-unknown-linux-gnu.tar.gz and clicker-0.2.1-aarch64-apple-darwin.tar.gz, checksums in SHA256SUMS.
0.2.0
The remote, in Vim.
- Full Vim grammar in
clicker tui:hjklwith counts (5j),gg/G,p,s,c,w/b,ctrl-d/ctrl-u,[/]. - Moves repeat:
.replays the last change, including a whole macro. Record withqa … q, replay with@a,@@and@:. :is a real command line with tab completion, history and Vim error codes (:vol 40,:app net,:seek -15,:swipe up,:text hello).?lists every key on one screen;i/atype or append into the focused text field with cursor editing.- A fuzzy app palette (
oor/) with recents, matched-character highlighting and one-key launch. - New screen: framed remote, live power and volume, activity log that collapses repeats, adaptive layout from 100 to 50 columns, and a clear message when the window is too small.
- Fixed the device model on tvOS 18 (it lives under
_siriInfo.peerData; the top-level key only says "peerData").
Prebuilt: clicker-0.2.0-x86_64-unknown-linux-gnu.tar.gz and clicker-0.2.0-aarch64-apple-darwin.tar.gz, checksums in SHA256SUMS.
clicker 0.1.1
macOS 27 support, and half the binary.
- Verified end to end on macOS 27 over SSH: discovery, pairing, status and button presses. The Mac's own Continuity record (which claims an Apple TV model) is no longer offered as a pairing target, and setup keeps looking for ~24 seconds instead of failing on the first missed mDNS answer.
- Config follows platform convention:
~/.config/clickeron Linux,~/Library/Application Support/clickeron macOS. - 172 to 151 crates, and a 7.0 MB binary down to 3.1 MB (Linux) and 2.8 MB (macOS), via a 30-line logger in place of tracing, dropped anyhow/dirs/unused hmac, and strip + LTO + opt-level=s.
- CI runs on Linux and macOS.
Prebuilt: clicker-0.1.1-x86_64-unknown-linux-gnu.tar.gz and clicker-0.1.1-aarch64-apple-darwin.tar.gz, checksums in SHA256SUMS.
0.1.0
First public release.
- Guided
clicker setup: find the Apple TV, pair with the PIN it shows, verify the connection. - The whole remote: buttons, touchpad gestures, typing, apps, accounts, power and volume.
--jsonon every command with stable error and exit codes, NDJSON event streaming, andbatchover a single session.clicker guidecheat sheet,clicker doctordiagnostics,clicker tuion-screen remote.- Native Companion Link: OPACK, TLV8, SRP-6a, HAP pair-setup and pair-verify, ChaCha20-Poly1305.
Install with scripts/install.sh (Rust 1.87 or newer). Tested against an Apple TV 4K on tvOS 18.6.