Skip to content

Latest commit

 

History

History
206 lines (159 loc) · 7.74 KB

README.md

File metadata and controls

206 lines (159 loc) · 7.74 KB

TabletDriver

This is a low latency graphics tablet driver that is meant to be used with rhythm game osu!

Currently the driver only works when the TabletDriverGUI is running.

The GUI minimizes to system tray / notification area. You can reopen the GUI by double clicking the system tray icon.

If you have problems with the driver, please read the FAQ:

https://github.com/hawku/TabletDriver/wiki/FAQ

Download

Supported operating systems:

  • Windows 7 64-bit
  • Windows 8 64-bit
  • Windows 8.1 64-bit
  • Windows 10 64-bit

Supported tablets:

  • Wacom CTL-470
  • Wacom CTH-470
  • Wacom CTL-471
  • Wacom CTL-472
  • Wacom CTL-480
  • Wacom CTH-480
  • Wacom CTL-490
  • Wacom CTH-490
  • Wacom CTL-671
  • Wacom CTL-672
  • Wacom CTL-680
  • Wacom CTH-680
  • Wacom PTH-451
  • Wacom PTH-850
  • XP-Pen G430 (New 2017+ "Model B")
  • XP-Pen G540 Pro
  • XP-Pen G640
  • Huion 420
  • Huion H420
  • Huion H430P
  • Huion H640P
  • Gaomon S56K

Configured, but not properly tested:

Installation

  1. You might need to install these libraries, but usually these are already installed:

  2. Unzip the driver to a folder (Shorter path is recommended, for example C:\Temp\TabletDriver)

  3. Uninstall all other tablet drivers. If you have problems with uninstalling the Wacom drivers, check the GitHub issue #1

  4. Run install_vmulti_driver.bat. It might need a restart if there is another vmulti driver installed.

  5. If you have Huion or Gaomon tablet, you need to run install_huion_64.bat, which is in the driver_huion directory.

  6. Start the TabletDriverGUI.exe

Updating to a new version

  1. Unzip the new version
  2. Start the TabletDriverGUI.exe

Uninstallation

  1. Uncheck the "Run at Windows startup" option in the GUI.
  2. Run remove_vmulti_driver.bat
  3. Run remove_huion_64.bat, which is in the driver_huion directory.

VMulti and Huion driver binaries

If you want to compile the code and don't want to install anything from the TabletDriver binary package, you will need extract the missing drivers from these installation packages:

VMulti driver:

Huion WinUSB driver:

Changelog

v0.1.5:

  • New tablet configurations: Wacom CTL-4100 (USB only model), XP-Pen G540 Pro, XP-Pen Deco 01 and Huion osu!tablet Thanks to /u/THEqrunt for capturing the XP-Pen Deco 01 USB data.
  • Added ResetDistance command, it controls the relative mode position reset distance.
  • Code refactoring.

v0.1.4:

  • Modified the Wacom CTL-471 full area size (147.20 x 92.25 mm to 152 x 95 mm)
  • New tablet configurations: Wacom PTH-850 and Huion H430P The PTH-850 configuration is made by mojobojo
  • Regenerated the wacom.cfg with new parameters, so it now includes PTH-450/650/850 and PTK-450/650

v0.1.3:

  • Added left handed mode / tablet invert option.
  • Added Wacom driver device support for the CTL-471 and 472
  • Noise reduction filter improvement (Noise command)

v0.1.2:

  • Added experimental support for leaving the Wacom drivers installed on the system. Supported tablets: CTL-470, CTL-480, CTH-480, CTL-4100
  • Added disable_wacom_drivers.bat and enable_wacom_drivers.bat to the tools folder. These scripts are used to disable and enable Wacom drivers when using the experimental Wacom driver support.
  • Added driver restart button.

v0.1.1:

  • Added support for Wacom CTL-4100 (USB and Bluetooth)
  • Added settings import / export to the main menu.
  • Added Wacom backup reader to the Wacom area tool.
  • Added tablet benchmark tools to the console output context menu (Right click).
  • Moved the config.xml to the config folder.
  • Added noise reduction filter (Noise command, not in the GUI)
  • Code refactoring

v0.1.0:

  • Added Bench / Benchmark command.
  • Added -hide GUI command line parameter. GUI will start as minimized when you run TabletDriverGUI.exe -hide
  • Added an option to run the TabletDriverGUI at Windows startup.

v0.0.18:

  • Added TabletDriverService.exe multi-instance prevention.
  • Added yet another Wacom 490 tip click fix. KeepTipDown command sets how long the pen tip button output should be kept down after the pen tip is released.

v0.0.17:

  • Fixed driver crashing when used with the Huion or Gaomon tablets.

v0.0.16:

  • Added smoothing filter rate selector. Use a lower rate if you have filter performance problems.
  • Added TabletDriverService.exe process priority warning when the priority isn't set to High.
  • Desktop size settings are now available to everyone. Previously shown only when the developer mode was enabled. Automatic size should be used, but if you have problems with the screen mapping: hawku#4
  • First few tablet position packets are now ignored to prevent the cursor jumping to a wrong position when driver is started.

v0.0.15:

  • Added more debug information to startuplog.txt. It now includes a list of connected input devices.
  • Added debug tools to the console output context menu (Right click).
  • Removed ClickPressure workaround from Wacom 490. You can re-enable that by adding ClickPressure 500 to Commands tab.
  • Updated the wacom.cfg

v0.0.14:

  • Fix for the console "Copy all" function.

v0.0.13:

  • Added a direction indicator to the tablet area and moved the aspect ratio text to the middle of the area.
  • TabletDriverService process priority class is now set to "High" (suggestion by /u/Devocub)
  • TabletDriverService stability and error handling improvements (thanks to https://github.com/freakode)
  • New tablet configurations: Huion H420 (made by /u/uyghti)
  • Automatically generated Wacom tablet configurations (config\wacom.cfg)

v0.0.12:

  • Added multi-instance prevention. Old TabletDriverGUI.exe should pop up if you try to open another one.
  • New tablet configurations: Wacom CTL-680 and CTH-680

v0.0.11:

  • Fix for DPI scaling problems. Screen mapping were wrong when the monitor DPI scaling wasn't 100%
  • Added a Wacom area tool. It should work with Wacom Intuos and Bamboo tablets (470->490)
  • Added startup debug log

v0.0.10:

  • New tablet configurations: Wacom CTH-470, CTH-670, PTH-451
  • Fix for the smoothing filter. The filter didn't turn on when the settings were applied.
  • Fix for the Huion H640P clicking problem and also added better data validation for Huion 420, Gaomon S56K, XP-Pen G430 and G640.
  • Modified click detection on CTL-490 and CTH-490 (tablet.cfg ClickPressure).

v0.0.9:

  • Yet another fix for the clicking problem... Maybe this time it will work?

v0.0.8:

  • Another fix for pen tip clicking. Improved the tablet data validation.

v0.0.7:

  • Added aspect ratio text to screen and tablet area.
  • Workaround for pen tip click detection. Some tablets don't send correct button data, so the pen tip click is now detected from the pressure data

v0.0.6:

  • Improved smoothing filter latency calculation

v0.0.5:

  • Added Windows Ink mode with pressure sensitivity
  • Added relative mouse mode
  • Added tablet area rotation
  • Added optional smoothing filter

v0.0.4:

  • Fixed a number conversion bug in the tablet area detection.