Skip to content

Releases

WellspringPTP-1.2026.1110.1100

Choose a tag to compare

@Osaul4ik Osaul4ik released this 16 Nov 13:09
e1053e9

✨ 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

Choose a tag to compare

@Osaul4ik Osaul4ik released this 09 Nov 12:41
bfb0278

✨ 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

Choose a tag to compare

@Osaul4ik Osaul4ik released this 26 Oct 10:52
f6eb638

✨ 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

Choose a tag to compare

@Osaul4ik Osaul4ik released this 14 Oct 21:48
0ea6727

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

Choose a tag to compare

@Osaul4ik Osaul4ik released this 29 Aug 09:42
eeb6989

🚀 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!

Ko-fi


WellspringPTP 1.2026.0824.1806

Choose a tag to compare

@Osaul4ik Osaul4ik released this 24 Aug 18:15
3483fbe

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.

Screenshot_2

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!

Ko-fi


🙏 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

Choose a tag to compare

@Osaul4ik Osaul4ik released this 07 Aug 10:16
96d6768

✨ 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) in AmtRecentLiftFindNearby when WindowTicks <= 0 by explicitly zero-initializing them before returning.

  • Applied additional stability fixes and code improvements across:

    • Activecontact.c
    • Device.c
    • Hid.c
    • Ptpcore.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

  1. Extract the archive.
  2. Run TestMode.bat, enter 1, and press Enter to enable Test Mode.
  3. Restart your computer. (Really)
  4. Run InstallSert.bat to install the certificate.
  5. Right-click AmtPtpDeviceUsbKm.inf and select Install.

🚀 Clean Update

  1. Open Device Manager.
  2. Under HID, find Wellspring Precision Touchpad, right-click it, and select Uninstall device.
  3. Check Delete the driver software for this device, then click Uninstall.
  4. 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

  1. Extract the archive, then right-click AmtPtpDeviceUsbKm.inf and select Install.

WellspringPTP 1.2026.0806.0650

Choose a tag to compare

@Osaul4ik Osaul4ik released this 06 Aug 07:08
af60a63

ReleaseNotes

  • Adjust scroll;
  • Adjust slow cursor movement;
  • Code optimization;
  • Fixed bugs

📦 Installation

  1. Extract the archive.
  2. Run TestMode.bat, enter 1, and press Enter to enable Test Mode.
  3. Restart your computer. (Really)
  4. Run InstallSert.bat to install the certificate.
  5. Right-click AmtPtpDeviceUsbKm.inf and select Install.

🚀 Clean Update

  1. Open Device Manager.
  2. Under HID, find Wellspring Precision Touchpad, right-click it, and select Uninstall device.
  3. Check Delete the driver software for this device, then click Uninstall.
  4. 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

  1. Extract the archive, then right-click AmtPtpDeviceUsbKm.inf and select Install.

WellspringPTP 1.2026.0803.2311

Choose a tag to compare

@Osaul4ik Osaul4ik released this 03 Aug 23:42
158d087

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

  1. Extract the archive.
  2. Run TestMode.bat, enter 1, and press Enter to enable Test Mode.
  3. Restart your computer. (Really)
  4. Run InstallSert.bat to install the certificate.
  5. Right-click AmtPtpDeviceUsbKm.inf and select "Install".

WellspringPTP 1.2026.0803.1021

Choose a tag to compare

@Osaul4ik Osaul4ik released this 03 Aug 10:54

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

  1. Extract the archive.
  2. Run TestMode.bat, enter 1, and press Enter to enable Test Mode.
  3. Restart your computer. (Really)
  4. Run InstallSert.bat to install the certificate.
  5. Right-click AmtPtpDeviceUsbKm.inf and select "Install".