Wand 0.3.0

Wand 0.3.0

English · 中文

English

New

• A new remote panel. A sidebar, a picture of your remote that scales to the window, and an inspector that edits one key at a time. Switch to a list view any time. The action picker has categories, search (by name or purpose, e.g. "voice") and full keyboard control.
• Per-app profiles. Give an app its own mappings, for example Play/Pause → Enter in Terminal and → Right Arrow in Keynote. A profile overrides only the keys you change and inherits the rest from Global. It switches automatically when the app comes to the front, from the very next press.
• Tap or Hold. Any mapping can be held instead of tapped: the key stays down while you hold the remote's button — push-to-talk dictation with Right ⌘ or Fn, for example. Arrow and page actions repeat instead, at your keyboard's repeat rate.
• Remote volume buttons. General → Remote Volume Buttons: run their mappings (as before), or let them change the Mac's volume.
• Launch at Login in the menu (macOS 11 and later).
• Setup checklist. On first launch, and any time from Pairing & Setup… in the menu: permissions, remote checks (buttons, touch surface, battery where the remote reports it) and a pairing guide.
• Several remotes at once. Each remote is recognised on its own, and the menu and the panel list them.
• Custom text can type its line breaks as Return or Shift+Return (for chat apps where Return sends).
• Learned shortcuts record modifier combinations and a lone modifier (such as Right ⌘) correctly.

Changes

• The first press after a remote connects is no longer ignored.
• Your keyboard's media keys keep working normally while a remote is connected, and a Magic Trackpad or mouse is never affected by Wand.
• "Mouse Sensitivity" is now General → Distance per Click.
• Only one Wand runs at a time.
• If a permission is revoked while Wand runs, the menu bar icon shows an orange dot and you get one notification.
• Wand pauses the system's Remote Control daemon (which otherwise opens Music on Play) while it runs, and restores it when it quits — also on the next launch if Wand was killed.
• The diagnostic log moved from /tmp/wand.log to ~/Library/Logs/Wand/wand.log (readable only by you). Detailed per-event lines are written only while Debug Logging is on in the menu.

Known limitations

• If you press the same media key on your keyboard and on the remote within about 50 ms of each other, the keyboard's press can occasionally be taken for the remote's.
• With two or more remotes connected, only one remote's touch surface moves the pointer; the panel marks which one. Buttons work on all of them.
• On one key, Hold and Double-Click cannot be combined: a held click acts on press and cannot wait for a second press.
• Wand relies on private, reverse-engineered macOS interfaces that Apple can change at any time.
• The new Tap/Hold and repeat, per-app profiles and volume-button option pass automated tests, but have not yet been fully tested by hand with a physical remote. If something misbehaves, please open an issue on GitHub.

Upgrading from 0.2.0

• Quit Wand 0.2.0 from its menu before installing 0.3.0. If 0.2.0 was force-quit instead, the system's Remote Control daemon may stay off until you log out (Play on your keyboard won't open Music until then).
• Your mappings, learned shortcuts, text and app actions are carried over automatically. Per-app profiles are new; going back to 0.2.0 keeps your global mappings.
• Accessibility and Input Monitoring permissions are expected to carry over, because both versions are signed with the same Developer ID. If the remote stops responding after the upgrade, check them in System Settings → Privacy & Security, or open Pairing & Setup….
• Launch at Login is off until you turn it on; it is available once Wand is in the Applications folder.

System requirements

• macOS 11 Big Sur or later, on Apple silicon or Intel (one universal app).
• Siri Remote 1st generation (A1513 / A1962), 2nd generation (A2540) or 3rd generation (A2854), paired over Bluetooth.

中文

新功能

• **全新的遥控器面板。**左侧是侧边栏，中间是随窗口缩放的遥控器示意图，右侧检查器一次编辑一个按键，也可以随时切换成列表视图。动作选择器带分类和搜索（可以搜名称或用途，比如「语音」），全程可以用键盘操作。
• **按应用配置。**可以给某个应用单独设一套映射，比如在终端里把播放/暂停设成 Enter，在 Keynote 里设成右方向键。应用配置只覆盖你改过的键，其余的继承「全局」。应用切到前台后自动生效，下一次按键就会用上。
• **点按或按住。**任何映射都可以改成「按住」：按住遥控器按键期间，目标键也一直按着，比如用右 ⌘ 或 Fn 按住说话。方向和翻页类动作则改为「连发」，速度跟随系统键盘设置。
• **遥控器音量键。**在「通用 → 遥控器音量键」里选择：执行映射（和以前一样），或者直接调节 Mac 音量。
• 菜单里新增登录时启动（macOS 11 及以上）。
• **首次引导。**第一次启动时，以及之后随时从菜单的「配对与检查…」进入，可以检查权限，检查遥控器的按键、触控板和电量（遥控器提供时），并查看配对指南。
• **同时连接多台遥控器。**每台都能单独识别，菜单和面板会列出每一台。
• 自定义文本里的换行可以选择用 Return 还是 Shift+Return 输入（适用于按 Return 就会直接发送的聊天软件）。
• 学习快捷键能正确录下修饰键组合，也能只录一个修饰键（比如右 ⌘）。

行为变化

• 遥控器连上后的第一次按键不再被忽略。
• 遥控器连接期间，键盘上的媒体键照常工作；Wand 不会影响妙控板或鼠标。
• 「鼠标灵敏度」改名为「通用 → 每次移动距离」。
• 同一时间只运行一个 Wand。
• Wand 运行中如果某项权限被撤销，菜单栏图标会出现橙点，并发一次通知。
• Wand 运行期间会暂停系统的 Remote Control 服务（否则按播放键会打开「音乐」），退出时恢复；如果 Wand 是被强制结束的，下次启动时也会恢复。
• 诊断日志从 /tmp/wand.log 改到 ~/Library/Logs/Wand/wand.log（只有你自己能读）。逐个事件的详细记录只在菜单里打开「调试日志」时才写。

已知限制

• 在约 50 毫秒内先后按下键盘和遥控器上的同一个媒体键时，键盘那一下偶尔会被当成遥控器的按键。
• 同时连接两台及以上遥控器时，只有一台的触控板能移动光标，面板里会标出是哪一台；按键在每一台上都能用。
• 同一个键不能既设「按住」又设双击：按住需要按下就生效，没法等第二次按下。
• Wand 依赖逆向得来的 macOS 私有接口，Apple 随时可能改动。
• 新增的点按/按住与连发、按应用配置、音量键选项已通过自动化测试，但还没有用实体遥控器完整地手动测试过。遇到问题请在 GitHub 上提 issue。

从 0.2.0 升级

• **安装 0.3.0 前，请先从菜单退出 Wand 0.2.0。**如果 0.2.0 是被强制结束的，系统的 Remote Control 服务可能会一直关闭到你注销为止，在这之前按键盘上的播放键不会打开「音乐」。
• 映射、学习的快捷键、文本和打开应用的设置会自动保留。按应用配置是新功能；退回 0.2.0 时，全局映射仍会保留。
• 辅助功能和输入监控权限预期会保留，因为两个版本使用同一个 Developer ID 签名。如果升级后遥控器没有反应，请到「系统设置 → 隐私与安全性」检查这两项权限，或打开「配对与检查…」。
• 「登录时启动」默认关闭，需要手动打开；Wand 放进「应用程序」文件夹后才能使用。

系统要求

• macOS 11 Big Sur 或更高版本，Apple 芯片和 Intel 都支持（同一个通用应用）。
• Siri Remote 第一代（A1513 / A1962）、第二代（A2540）或第三代（A2854），通过蓝牙配对。

---

SHA-256 (Wand-0.3.0.dmg): d9f1b24eaeb11342b1f609a3720ebd84b6c78aab5ce18227b4fc3f28dbe14fdf

Wand 0.2.0

Wand 0.2.0

New

• Pairing guide — a built-in "How to Pair" window (menu bar → How to Pair…) with step-by-step Siri Remote pairing instructions per model and a one-click Open Bluetooth Settings button.
• New mappable keys — Cmd+F1…F12, Page Up, and Page Down.

Changed

• Trackpad ring direction clicks (up/down/left/right) are now mappable buttons; swipe-gesture mappings were removed — swiping is pure cursor movement.

Fixed

• Swipe gestures no longer misfire during fast cursor strokes (the stray system beep).

---

Download Wand-0.2.0.dmg below. Signed with a Developer ID and notarized by Apple, so it opens without Gatekeeper warnings. Open the DMG, drag Wand.app to Applications, then grant Accessibility in System Settings → Privacy & Security → Accessibility.

Wand 0.1

First public release of Wand — turn your Apple Siri Remote into a controller for your Mac.

Wand 首个公开版本 — 把 Apple Siri Remote 变成 Mac 的控制器。

Download / 下载

Wand-0.1.dmg — signed with Developer ID and notarized by Apple: open the DMG, drag Wand.app to Applications, launch. No Gatekeeper warnings.
已完成 Developer ID 签名与 Apple 公证:打开 DMG,拖入「应用程序」即可运行,无 Gatekeeper 警告。

Highlights / 亮点

• Trackpad → cursor, scroll, tap-to-click (toggleable), swipe gestures, edge-click cursor nudge with sensitivity slider
• Every button mappable (single & double click): function keys, F1–F12, combo presets, learn-any-shortcut, type text/commands, launch apps
• Visual configuration panel — bilingual (English / 简体中文), light & dark mode
• HID seize + AVRCP volume revert: your mapped action is the only effect

Setup / 使用前

Grant Accessibility and Input Monitoring in System Settings → Privacy & Security, then pair your Siri Remote over Bluetooth.
在「系统设置 → 隐私与安全性」中授权辅助功能与输入监控,并通过蓝牙配对 Siri Remote。

Supported remotes / 支持型号: Siri Remote 1st gen (A1513/A1962), 2nd gen (A2540), 3rd gen (A2854)