Repository navigation
WellspringPTP 1.2026.0824.1806
This release is considered stable.
✨ What's New
🔄 Driver Lifecycle Rework
A significant part of the driver's lifecycle handling has been reworked.
This includes improvements to:
- Driver initialization
- Device initialization and reinitialization
- Runtime state management
- Driver shutdown
- Power-state transitions
- Sleep / Resume handling
- Device recovery and reinitialization paths
🖥️ Wellspring Control Center
Added a dedicated Wellspring Control Center for configuring and monitoring the driver.
The GUI provides:
- Device connection and status information
- Pointer settings
- Scroll settings
- Gesture-related settings
- Palm rejection configuration
- Force Touch controls
- Emu Force Touch controls
- User profiles
- Live contact monitoring
- Driver debug logging controls
- Tray controls for commonly used settings
- Advanced configuration through Pro Mode
⚡ Live Mode
Added Live Mode for real-time visualization of touchpad contacts.
Live Mode displays:
- The actual number of active contacts
- Current contact positions
- Contact information directly in the Preview
This makes it possible to monitor how the driver detects and tracks contacts in real time.
⚙️ Detailed Runtime Configuration
The new configuration system exposes a much broader set of runtime parameters.
This makes it easier to:
- Tune driver behavior
- Configure input processing
- Adjust gesture behavior
- Configure palm rejection
- Configure Force Touch behavior
- Configure Emu Force Touch
- Create and switch between profiles
👆 Force Touch
Added configurable Force Touch support for compatible Apple trackpads with a hardware pressure channel.
Available controls include:
- Force Touch enable / disable
- Pressure threshold
- Optional pressure gate
- Optional continuous-pressure requirement
- Force Touch action
Supported actions include:
- Context menu
- Middle mouse button
- Double click
👆 Emu Force Touch
Added Emu Force Touch for trackpads without a hardware pressure channel.
Emu Force Touch allows a mechanical hard tap to emulate Force Touch behavior.
Available controls include:
- Emu Force Touch enable / disable
- Configurable Force Touch action
- Drag-cancel distance
🖐️ Palm Rejection
Palm rejection is runtime configurable through the GUI.
Available parameters include:
- Edge rejection zones
- Major/minor contact thresholds
- Palm shape ratio
- Palm score threshold
- Minimum contact dimensions
The configuration is shared between the driver and GUI through a stable configuration interface.
📦 GUI Versions
Two versions of the GUI are provided.
WellspringPTP GUI — Min
The Min version does not include the .NET runtime.
Requires .NET 8 Desktop Runtime (x64) to be installed separately.
Download .NET 8 Desktop Runtime
WellspringPTP GUI — Full
The Full version includes the required .NET runtime.
No separate .NET installation is required.
💡 Use the Full version for the simplest installation.
The Min version is smaller and is intended for systems where .NET 8 Desktop Runtime is already installed.
🧪 Stability and Validation
The release has been tested with:
- Driver Verifier
- PREfast
- CodeQL
- Static Analysis
⚠️ Known Limitations
- Very fast Force Touch → Hard Tap transitions may occasionally be missed before reaching the input queue.
📥 Installation
Please follow the installation instructions included with the project README.
Note: The current driver package requires Windows Test Mode for installation.
☕ Support
If you find this project useful, consider buying me a coffee!
🙏 Credits
This project is based on the excellent work of the original mac-precision-touchpad project by imbushuo.
bat files for cert and test mode broken. Fixed in next release