Repository navigation
Releases
WellspringPTP-1.2026.1110.1100
✨ What's new
Fixed jumps
Improved haptics
📦 Installation
Grab WellspringPTP Setup from Releases, run the installer, and follow the on-screen steps. Restart Windows when requested.
☕ Enjoying WellspringPTP?
If you'd like to support development, toss a coin on Ko-fi ☕. No pressure — ⭐ starring the repo and sharing feedback help just as much. Thank you!
WellspringPTP-1.2026.1109.1233 Pre-release
✨ What's new
Added: Haptics support
Tested on MacBookPro 2019 16'
Drag cancel distance should be on
📦 Installation
Grab WellspringPTP Setup from Releases, run the installer, and follow the on-screen steps. Restart Windows when requested.
☕ Enjoying WellspringPTP?
If you'd like to support development, toss a coin on Ko-fi ☕. No pressure — ⭐ starring the repo and sharing feedback help just as much. Thank you!
WellspringPTP 1.2026.1026.1533
✨ What's new
- 🎛️ Adjustable Hard Tap hold time — choose 300–3000 ms (default: 1300 ms) right in Control Center. The timer starts when you press down.
- 👆 Better Force Touch dragging — improved drag cancellation and click arbitration for hardware and emulated Force Touch.
- 🖱️ No double actions — once Emulated Force Touch triggers, the same press won't also produce a timed Hard Tap.
↔️ Cursor movement recovery — resume moving after releasing Force Touch without having to lift your finger.- ⚡ More consistent input processing — USB touch frames are processed even when a HID read isn't waiting, with buffered reports to help preserve click transitions.
- 🛠️ Cleaner controls — a shared Hard Tap timing slider for both Force Touch modes.
📦 Installation
Grab the latest WellspringPTP Setup from Releases, run the installer, and follow the on-screen steps. Restart Windows when requested.
☕ Enjoying WellspringPTP?
If you'd like to support development, toss a coin on Ko-fi ☕. No pressure — ⭐ starring the repo and sharing feedback help just as much. Thank you!
WellspringPTP 1.2026.1014.2131
Fixes & Improvements 🛠️
- Fixed cursor and scroll speed scaling.
- Improved contact matching and palm-lock handling.
- Fixed live monitor tracking and pad boundary clamping.
- Prevented spurious UP events.
- Added verification harness and regression tests.
WellspringPTP 1.2026.0830.0924
🚀 Installer
This release introduces a dedicated installer, making driver installation much easier.
The installer automatically:
- Enables Windows Test Mode
- Installs the certificate
- Installs the WellspringPTP driver
- Handles the required installation steps automatically
You no longer need to manually enable Test Mode, install the certificate, and install the driver separately.
🖱️ Driver
- Improved touchpad reinitialization
- Bug fixes
🗑️ Uninstaller
The GUI and driver can be uninstalled through Windows Settings → Apps → Installed apps.
Fix additional .bat files for manual installation
☕ Support
If you find this project useful, consider buying me a coffee!
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
WellspringPTP 1.2026.0807.1012
✨ Release Notes
🛠️ Fixes
-
Fixed a stuck right-click issue caused by force-touch click events overflowing the delivery queue.
-
Fixed potentially undefined output coordinates (
OutX/OutY) inAmtRecentLiftFindNearbywhenWindowTicks <= 0by explicitly zero-initializing them before returning. -
Applied additional stability fixes and code improvements across:
Activecontact.cDevice.cHid.cPtpcore.c
✅ Quality
The driver successfully passed all static quality validation checks:
- ✅ CodeQL (WHCP
mustfix.qls) — 0 defects - ✅ CodeQL (WHCP
mustrun.qls) — 0 defects - ✅ PREfast (
/analyze,DriverMinimumRules.ruleset) — 0 warnings, 0 errors - ✅ Compiler (
/W4 /WX) — 0 warnings, 0 errors - ✅ ApiValidator — verified as Universal
- ✅ WHCP Static Tools Logo Test — passed
📦 Installation
- Extract the archive.
- Run TestMode.bat, enter 1, and press Enter to enable Test Mode.
- Restart your computer. (Really)
- Run InstallSert.bat to install the certificate.
- Right-click AmtPtpDeviceUsbKm.inf and select Install.
🚀 Clean Update
- Open Device Manager.
- Under HID, find Wellspring Precision Touchpad, right-click it, and select Uninstall device.
- Check Delete the driver software for this device, then click Uninstall.
- Extract the archive, then right-click AmtPtpDeviceUsbKm.inf and select Install.
Use keys (Arrows, Tab, Alt or mouse), when touchpad driver not installed.
🚀 Normal Update
- Extract the archive, then right-click AmtPtpDeviceUsbKm.inf and select Install.
WellspringPTP 1.2026.0806.0650
ReleaseNotes
- Adjust scroll;
- Adjust slow cursor movement;
- Code optimization;
- Fixed bugs
📦 Installation
- Extract the archive.
- Run TestMode.bat, enter 1, and press Enter to enable Test Mode.
- Restart your computer. (Really)
- Run InstallSert.bat to install the certificate.
- Right-click AmtPtpDeviceUsbKm.inf and select Install.
🚀 Clean Update
- Open Device Manager.
- Under HID, find Wellspring Precision Touchpad, right-click it, and select Uninstall device.
- Check Delete the driver software for this device, then click Uninstall.
- Extract the archive, then right-click AmtPtpDeviceUsbKm.inf and select Install.
Use keys (Arrows, Tab, Alt or mouse), when touchpad driver not installed.
🚀 Normal Update
- Extract the archive, then right-click AmtPtpDeviceUsbKm.inf and select Install.
WellspringPTP 1.2026.0803.2311
Experimental support for additional MacBook models (untested on real hardware unless noted):
MacBook Pro 15"/16" (2018–2020) — T2 (MacBook Pro 16" 2019 ✅ tested)
MacBook Pro 13" (2018–2020, all port configs) — T2
MacBook Air (2018–2020) — T2
MacBook Air (2013–2015) (MacBook Air 2015 ✅ tested)
MacBook Pro 13" (2015, Force Touch, no Touch Bar)
📦 Installation
- Extract the archive.
- Run TestMode.bat, enter 1, and press Enter to enable Test Mode.
- Restart your computer. (Really)
- Run InstallSert.bat to install the certificate.
- Right-click AmtPtpDeviceUsbKm.inf and select "Install".
WellspringPTP 1.2026.0803.1021
WellspringPTP Driver
The USB KM driver has been extensively rewritten.
WellspringPTP targets the USB KM implementation exclusively.
🚀 Architecture
Reworked the contact processing pipeline with clear separation between ActiveContact, Match, and PTPCore.
Replaced the legacy slot-based identity model with a pool-based contact lifetime model.
Implemented a new contact matcher featuring:
branch-and-bound candidate pruning,
dead-reckoning position prediction,
normalized contact shape distance,
per-axis velocity estimation.
🛠 Fixes
Fixed incorrect KeQueryPerformanceCounter() usage that affected all timing-dependent logic.
Fixed an SMP race condition on DEVICE_CONTEXT by introducing proper spinlock synchronization.
Fixed multiple stability issues including:
NULL pointer dereference,
memory leak,
interrupt race condition.
Fixed TipDropApplied being incorrectly used as a confidence flag, resolving cascading tap failures.
Fixed Y-axis inversion inside the bottom dead zone.
Fixed phantom UP events generated for palm contacts.
Fixed force-touch drag lockout matching semantics.
Added mitigation for T2 / BCM5974 firmware slot reassignment noise (origin == 0 glitch).
Improved gradual palm detection through birth-size tracking.
⚡ Performance & Stability
Removed EMA smoothing during gesture frames, eliminating scroll damping and inertia hitching.
Fixed scroll velocity scaling carry bug.
Reduced interrupt handler lock hold time to improve responsiveness.
✨ New Features
Force Touch — press and release with one finger to open the context menu (right-click).
🧹 Removed
Other drivers.
Unused haptics code.
Obsolete gesture-related source files.
📦 Installation
- Extract the archive.
- Run TestMode.bat, enter 1, and press Enter to enable Test Mode.
- Restart your computer. (Really)
- Run InstallSert.bat to install the certificate.
- Right-click AmtPtpDeviceUsbKm.inf and select "Install".