A native macOS menubar app for the XP-Pen ACK05 Wireless Shortcut Remote. Map any of the 11 buttons and scroll wheel to keyboard shortcuts, media controls, volume, or shell commands — over USB or Bluetooth.

This project is not associated with XP-Pen in any way.

• USB + Bluetooth — works with the 2.4GHz USB dongle or Bluetooth Low Energy, auto-detects both
• 11 buttons + scroll wheel — every input is mappable
• Press, double-press, and long-press — each button supports three gesture types
• Keyboard shortcuts — record any key combo (⌘⇧K, ⌃Space, etc.)
• Media controls — play/pause, next/previous track
• Volume & mute — scroll wheel as a volume knob
• Shell commands — run anything
• Visual topology — interactive diagram of the remote that highlights on press and navigates to button settings
• Lives in the menubar — no dock icon, launches at login

Download XP-Pen-Remote-<version>.zip from Releases, unzip, and drag to /Applications.

Since the app isn't notarized, macOS will block it on first launch. To fix this:

xattr -cr /Applications/XP-Pen\ Remote.app

Or right-click the app and select Open.

Requires Swift 5.9+ and macOS 14+.

git clone https://github.com/Jayphen/xp-pen.git
cd xp-pen/menubar_app
swift build -c release
./scripts/build-app.sh
open build/XP-Pen\ Remote.app

Grant these in System Settings > Privacy & Security:

Copy the built .app to /Applications, then add it to System Settings > General > Login Items.

Button mappings are stored in ~/.config/xp-pen/mappings.json and persist across restarts.

The device communicates via a vendor-specific HID interface (USB) or a custom BLE service (FFE0, characteristic 0003). Both transports produce identical report formats.

Based on smartfastlabs/xp-pen by Todd Sifleet.

See LICENSE.