Skip to content

Repository files navigation

xppen-mac-tools

Tools for an XPPen drawing setup on macOS: a driver for the ACK05 shortcut remote, a visual editor for it, and touchscreen gestures for the Artist Ultra 16.

Leia em português

Credit

The driver is ack05d, written by Jordi Wippert and released under the MIT License. This repository imports it as of upstream commit 8d320aba83f1 and builds on it. Its history lives upstream; its original README, with installation, configuration and troubleshooting, is kept as README.ack05d.md.

This is not a fork on GitHub, and updates to ack05d are merged in by hand.

What's here

Part Folder
ack05d — driver for the ACK05 remote Sources/ Jordi Wippert's driver, with the changes below
Controle XP-Pen — visual editor for the remote Configurator/ Edit keys and wheel modes on a drawing of the remote
Gestos XP-Pen — touchscreen gestures TouchGestures/ Experimental. Two- and three-finger taps as undo and redo in Clip Studio Paint

Both apps have Portuguese interfaces and English and Portuguese documentation.

Changes to the driver

  • Space follows the physical key. A key bound to plain Space is held down while the key is held, so it can drive the temporary pan tool in drawing apps. Every other keystroke still sends a tap.
  • No stuck keys. Held keys are released when the link drops, when Bluetooth is not ready, on reconnect, on config reload, and when the driver is stopped.

Install

The driver, from the repository root — see README.ack05d.md for pairing, permissions and configuration:

./install.sh

The apps, which build for Apple Silicon into ~/Applications:

sh Configurator/build.sh
sh TouchGestures/build.sh

Tests

The driver's hold and release behaviour:

swiftc -target arm64-apple-macosx13.0 Tests/HoldTests.swift Sources/ack05d/ActionRunner.swift \
  Sources/ack05d/Config.swift Sources/ack05d/KeyStroke.swift Sources/ack05d/MediaKey.swift \
  Sources/ack05d/FrameDecoder.swift -o /tmp/hold-tests
/tmp/hold-tests

Each app's README lists its own tests. CI builds everything and runs all of them.

License

MIT — see LICENSE and NOTICE. ack05d is copyright Jordi Wippert; the additions are copyright luhw-dev. Not affiliated with XPPen or Celsys.

About

XPPen drawing setup on macOS: ack05d remote driver by Jordi Wippert with hold-to-pan Space, a visual configurator, and touchscreen gestures for the Artist Ultra 16

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages