Skip to content

WellspringPTP 1.2026.0824.1806

Choose a tag to compare

@Osaul4ik Osaul4ik released this 24 Aug 18:15
· 5 commits to ForceTouch_Emulation since this release
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