Trackpad Wizard / Support

Trackpad Wizard support

The public source repository and its issue tracker are the current support channel for Trackpad Wizard.

Report an issue

Include the app version and build, macOS version, Mac model class, built-in or external trackpad, active System or Enhanced mode, and the steps that reproduce the behavior. Note whether it followed sleep, wake, lid closure, device reconnection or a permission change.

If an error notice appears, include its stable TW-xxxxcode. Do not post Bluetooth addresses, serial-like values or an unreviewed exported session in a public issue.

Open the Trackpad Wizard issue tracker

Current release requirements

Version: 0.3.0 (Build 4)
Platform: macOS 26 or later
Distribution: Developer ID-signed, notarized and stapled DMG
Source license: MPL-2.0

Start with System mode

System mode is the complete public baseline and the default after launch. Enable Enhanced Mode only when a raw-contact or direct-actuator experiment needs it. Experimental services release their private runtime when no enhanced feature or recovery action remains active.

System mode reads AppKit touch while the pointer is over the capture surface, native gestures, Force Click stages, and device diagnostics. Enhanced Mode adds raw contacts for one selected device and direct actuator experiments. Advanced system changes require confirmation and have an automatic ten-second rollback.

Explore the workspaces

Touch Lab: Contacts, resting touches, trails, heatmaps, physical sizing, sample rate, and Force Click pressure.
Gesture Studio: Magnification, rotation, precision scrolling, swipes, pressure stages, and gesture events.
Haptic Composer: Timed pulses, amplitude, device routing, and an 8–120 Hz press-and-hold signal in Enhanced Mode.
Mappings: Connect a swipe, pinch, rotation, or Force Click to a shortcut or saved haptic pattern. Key injection requires Accessibility access.
Statistics: Local actuator-call counts, daily history, lifetime totals, and a reset control, using pseudonymous device identifiers.
Devices: Transport, reported battery, Force Touch support, report interval, sensor size, and macOS trackpad preferences.

Downloads and updates

The release is Developer ID-signed, notarized, and stapled. GitHub Releases includes a SHA-256 checksum; the in-app updater verifies the downloaded image before opening it. Update checks can be manual or daily. Automatic download is a separate preference.