|
2 | 2 |
|
3 | 3 | This is a low latency graphics tablet driver that is meant to be used with rhythm game [osu!](https://osu.ppy.sh/home) |
4 | 4 |
|
5 | | -Currently the driver only works when the TabletDriverGUI is running. |
6 | | - |
7 | | -The GUI minimizes to system tray / notification area. You can reopen the GUI by double clicking the system tray icon. |
8 | | - |
9 | | -**If you have problems with the driver, please read the FAQ:** |
10 | | - |
11 | | -**https://github.com/hawku/TabletDriver/wiki/FAQ** |
12 | | - |
13 | | -## Download |
14 | | - |
15 | | -### http://hwk.fi/TabletDriver/TabletDriverV0.2.3.zip |
16 | | - |
17 | | -# |
18 | | - |
19 | | -### Supported operating systems: |
20 | | - - Windows 10 64-bit |
21 | | - - Windows 8.1 64-bit |
22 | | - - Windows 8 64-bit |
23 | | - - Windows 7 64-bit (Multiple monitors do not work in absolute mode) |
24 | | - |
25 | | -# |
26 | | - |
27 | | -### Supported tablets: |
28 | | - - Wacom CTE-440 |
29 | | - - Wacom CTL-470 |
30 | | - - Wacom CTH-470 |
31 | | - - Wacom CTL-471 |
32 | | - - Wacom CTL-472 |
33 | | - - Wacom CTL-480 |
34 | | - - Wacom CTH-480 |
35 | | - - Wacom CTL-490 |
36 | | - - Wacom CTH-490 |
37 | | - - Wacom CTL-4100 USB |
38 | | - - Wacom CTL-4100 Bluetooth |
39 | | - - Wacom CTL-671 |
40 | | - - Wacom CTL-672 |
41 | | - - Wacom CTL-680 |
42 | | - - Wacom CTH-680 |
43 | | - - Wacom CTL-690 |
44 | | - - Wacom CTH-690 |
45 | | - - Wacom PTH-660 |
46 | | - - Wacom PTH-451 |
47 | | - - Wacom PTH-850 |
48 | | - - XP-Pen G430 (New 2017+ "Model B". Old G430 is not supported) |
49 | | - - XP-Pen G430S |
50 | | - - XP-Pen G540 Pro (G540 is not supported) |
51 | | - - XP-Pen G640 |
52 | | - - XP-Pen G640S |
53 | | - - XP-Pen Deco 01 |
54 | | - - XP-Pen Deco 01 v2 |
55 | | - - Huion 420 |
56 | | - - Huion H420 |
57 | | - - Huion H430P |
58 | | - - Huion H640P |
59 | | - - Huion osu!tablet |
60 | | - - Gaomon S56K |
61 | | - - VEIKK S640 |
62 | | - |
63 | | -### Configured, but not properly tested: |
64 | | -> - Huion New 1060 Plus |
65 | | -> - Huion Inspiroy Q11K |
66 | | - - Other Wacom tablets that might work: https://github.com/hawku/TabletDriver/blob/master/TabletDriverService/config/wacom.cfg |
67 | | - |
68 | | -# |
69 | | - |
70 | | -## Installation |
71 | | - |
72 | | -1. You might need to install these libraries, but usually these are already installed: |
73 | | - * https://www.microsoft.com/net/download/dotnet-framework-runtime |
74 | | - * https://aka.ms/vs/15/release/vc_redist.x86.exe |
75 | | - |
76 | | -2. Unzip the driver to a folder (Shorter path is recommended, for example `C:\Temp\TabletDriver`) |
77 | | -3. Uninstall all other tablet drivers. If you have problems with uninstalling the Wacom drivers, check the GitHub issue [#1](https://github.com/hawku/TabletDriver/issues/1) |
78 | | -4. Run `install_vmulti_driver.bat`. It might need a restart if there is another vmulti driver installed. |
79 | | -5. If you have Huion or Gaomon tablet, you need to run `install_huion_64.bat`, which is in the `driver_huion` directory. |
80 | | -6. Start the TabletDriverGUI.exe |
81 | | - |
82 | | -## Updating to a new version |
83 | | - |
84 | | -1. Unzip the new version |
85 | | -2. Start the TabletDriverGUI.exe |
86 | | - |
87 | | -## Uninstallation |
88 | | - |
89 | | -1. Uncheck the "Run at Windows startup" option in the GUI. |
90 | | -2. Run `remove_vmulti_driver.bat` |
91 | | -3. Run `remove_huion_64.bat`, which is in the `driver_huion` directory. |
92 | | - |
93 | | -# |
94 | | - |
95 | | -## VMulti and Huion driver binaries |
96 | | - |
97 | | -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: |
98 | | - |
99 | | -**VMulti driver:** |
100 | | -- https://www.xp-pen.com/upload/download/20181019/osuWin(20181019).zip |
101 | | - |
102 | | -**Huion WinUSB driver:** |
103 | | -- https://www.huiontablet.com/drivers/WinDriver/HuionTablet_WinDriver_v14.7.60.zip |
104 | | - |
105 | | -# |
106 | | - |
107 | | -## Changelog |
108 | | - |
109 | | ->**v0.2.3:** |
110 | | -> - Fixed "TabletDriverService.exe has stopped working" error when a tablet is not connected. |
111 | | -> - Relative mouse mode can now have different sensitivity on X and Y axis. |
112 | | -> - Added SendInput output mode to GUI |
113 | | -
|
114 | | ->**v0.2.2:** |
115 | | -> - XP-Pen G430S configuration by [frodriguez96](https://github.com/frodriguez96) and [riley-badour](https://github.com/riley-badour) |
116 | | -> - Huion New 1060 Plus configuration by [riley-badour](https://github.com/riley-badour) |
117 | | -> - Huion Inspiroy Q11K configuration by [octoberU](https://github.com/octoberU) |
118 | | -> - Wacom CTL-690 and CTH-690 configurations moved to tablet.cfg and DetectMask fixed. |
119 | | -> - Few more Wacom tablets can now be used while the official drivers are installed (check tablet.cfg) |
120 | | -> - Tablet button support for Wacom CTH-480, CTL-490, CTL-4100, Huion H430P and H640P. |
121 | | -> - Custom tablet data format configuration (check tablet.cfg for examples) |
122 | | -> - Pen and tablet button mapping to a mouse buttons and keyboard keys. |
123 | | -> - Pen button mapping to scroll. |
124 | | -> - Windows Ink pressure settings and test canvas. |
125 | | -> - Smoothing filter now also smooths out pen pressure. |
126 | | -> - Smoothing can be set to only smooth out when pen buttons are down. |
127 | | -> - Anti-smoothing compensation value is now in milliseconds (check tooltip for example values) |
128 | | -> - Ability start the TabletDriverService.exe without GUI (`tools\RunServiceOnly.bat`) |
129 | | -
|
130 | | ->**v0.2.1:** |
131 | | -> - XP-Pen G640S and VEIKK S640 configurations by [frodriguez96](https://github.com/frodriguez96) |
132 | | -> - Original XP-Pen, Huion and VEIKK driver processes will now be killed when the TabletDriverGUI starts. |
133 | | -> - Fixed cursor jumping to the corner when driver restarts or tablet disconnects. |
134 | | -> - Removed device list from driver startup. Might help with the problems that the driver restart is causing other USB devices to glitch out. |
135 | | -> - Relative mode position reset is now decided by when the last tablet movement was received (default 100 ms, `RelativeResetTime` command). |
136 | | -> - Added ability to disable automatic restart. |
137 | | -> - Added command name autocomplete to the console input (tab) and commands tab (control + space). |
138 | | -> - Added gravity filter (`GravityFilter` command). It's just for fun and testing. Works only when pen buttons are pressed. |
139 | | -> - Added 32-bit VMulti and Huion drivers to the driver zip file. |
140 | | -
|
141 | | ->**v0.2:** |
142 | | -> - **Improved the noise reduction filter and added the settings to the GUI.** |
143 | | -> - **Added an anti-smoothing filter which reduces the input latency on tablets that use hardware smoothing.** |
144 | | -> - Wacom CTE-440 support by [Poliwrath](https://github.com/Poliwrath) |
145 | | -> - Wacom PTH-660 support by [Implojin](https://github.com/Implojin) |
146 | | -> - XP-Pen Deco 01 v2 support by [Itsyuka](https://github.com/Itsyuka) |
147 | | -> - Modified Huion 420 and H420 tablet area size to match with the 2000 LPI resolution. |
148 | | -> - Updated Huion drivers to the latest version. |
149 | | -> - Moved the filter settings to filters tab in the GUI. |
150 | | -> - Added `Measure` command. Measures distances between clicked points. |
151 | | -> - Added an ability to "draw" tablet area by clicking two points with the pen. |
152 | | -> - Added "Restart driver" option to the notification icon menu. |
153 | | -> - Added 1000 Hz smoothing filter rate option to the GUI. |
154 | | -> - Added few tablets to wacom.cfg |
155 | | -> - Major code refactoring. |
156 | | -
|
157 | | ->**v0.1.5:** |
158 | | -> - New tablet configurations: Wacom CTL-4100 (USB only model), XP-Pen G540 Pro, XP-Pen Deco 01 and Huion osu!tablet |
159 | | -> Thanks to /u/THEqrunt for capturing the XP-Pen Deco 01 USB data. |
160 | | -> - Added `ResetDistance` command, it controls the relative mode position reset distance. |
161 | | -> - Code refactoring. |
162 | | -
|
163 | | ->**v0.1.4:** |
164 | | -> - Modified the Wacom CTL-471 full area size (147.20 x 92.25 mm to 152 x 95 mm) |
165 | | -> - New tablet configurations: Wacom PTH-850 and Huion H430P |
166 | | -> The PTH-850 configuration is made by [mojobojo](https://github.com/mojobojo) |
167 | | -> - Regenerated the wacom.cfg with new parameters, so it now includes PTH-450/650/850 and PTK-450/650 |
168 | | -
|
169 | | ->**v0.1.3:** |
170 | | -> - Added left handed mode / tablet invert option. |
171 | | -> - Added Wacom driver device support for the CTL-471 and 472 |
172 | | -> - Noise reduction filter improvement (`Noise` command) |
173 | | -
|
174 | | ->**v0.1.2:** |
175 | | -> - Added experimental support for leaving the Wacom drivers installed on the system. |
176 | | -> Supported tablets: CTL-470, CTL-480, CTH-480, CTL-4100 |
177 | | -> - Added `disable_wacom_drivers.bat` and `enable_wacom_drivers.bat` to the `tools` folder. |
178 | | -> These scripts are used to disable and enable Wacom drivers when using the experimental Wacom driver support. |
179 | | -> - Added driver restart button. |
180 | | -
|
181 | | ->**v0.1.1:** |
182 | | -> - Added support for Wacom CTL-4100 (USB and Bluetooth) |
183 | | -> - Added settings import / export to the main menu. |
184 | | -> - Added Wacom backup reader to the Wacom area tool. |
185 | | -> - Added tablet benchmark tools to the console output context menu (Right click). |
186 | | -> - Moved the `config.xml` to the `config` folder. |
187 | | -> - Added noise reduction filter (`Noise` command, not in the GUI) |
188 | | -> - Code refactoring |
189 | | -
|
190 | | ->**v0.1.0:** |
191 | | -> - Added `Bench` / `Benchmark` command. |
192 | | -> - Added `-hide` GUI command line parameter. GUI will start as minimized when you run `TabletDriverGUI.exe -hide` |
193 | | -> - Added an option to run the TabletDriverGUI at Windows startup. |
194 | | -
|
195 | | ->**v0.0.18:** |
196 | | -> - Added TabletDriverService.exe multi-instance prevention. |
197 | | -> - Added yet another Wacom 490 tip click fix. |
198 | | -> `KeepTipDown` command sets how long the pen tip button output should be kept down after the pen tip is released. |
199 | | -
|
200 | | ->**v0.0.17:** |
201 | | -> - Fixed driver crashing when used with the Huion or Gaomon tablets. |
202 | | -
|
203 | | ->**v0.0.16:** |
204 | | -> - Added smoothing filter rate selector. Use a lower rate if you have filter performance problems. |
205 | | -> - Added TabletDriverService.exe process priority warning when the priority isn't set to High. |
206 | | -> - Desktop size settings are now available to everyone. |
207 | | -> Previously shown only when the developer mode was enabled. |
208 | | -> Automatic size should be used, but if you have problems with the screen mapping: |
209 | | -> https://github.com/hawku/TabletDriver/issues/4 |
210 | | -> - First few tablet position packets are now ignored to prevent the cursor jumping to a wrong position when driver is started. |
211 | | -
|
212 | | ->**v0.0.15:** |
213 | | -> - Added more debug information to startuplog.txt. It now includes a list of connected input devices. |
214 | | -> - Added debug tools to the console output context menu (Right click). |
215 | | -> - Removed ClickPressure workaround from Wacom 490. |
216 | | -> You can re-enable that by adding `ClickPressure 500` to Commands tab. |
217 | | -> - Updated the wacom.cfg |
218 | | -
|
219 | | ->**v0.0.14:** |
220 | | -> - Fix for the console "Copy all" function. |
221 | | -
|
222 | | ->**v0.0.13:** |
223 | | -> - Added a direction indicator to the tablet area and moved the aspect ratio text to the middle of the area. |
224 | | -> - TabletDriverService process priority class is now set to "High" (suggestion by /u/Devocub) |
225 | | -> - TabletDriverService stability and error handling improvements (thanks to https://github.com/freakode) |
226 | | -> - New tablet configurations: Huion H420 (made by /u/uyghti) |
227 | | -> - Automatically generated Wacom tablet configurations (config\wacom.cfg) |
228 | | -
|
229 | | ->**v0.0.12:** |
230 | | -> - Added multi-instance prevention. Old TabletDriverGUI.exe should pop up if you try to open another one. |
231 | | -> - New tablet configurations: Wacom CTL-680 and CTH-680 |
232 | | -
|
233 | | ->**v0.0.11:** |
234 | | -> - Fix for DPI scaling problems. Screen mapping were wrong when the monitor DPI scaling wasn't 100% |
235 | | -> - Added a Wacom area tool. It should work with Wacom Intuos and Bamboo tablets (470->490) |
236 | | -> - Added startup debug log |
237 | | -
|
238 | | ->**v0.0.10:** |
239 | | -> - New tablet configurations: Wacom CTH-470, CTH-670, PTH-451 |
240 | | -> - Fix for the smoothing filter. The filter didn't turn on when the settings were applied. |
241 | | -> - Fix for the Huion H640P clicking problem and also added better data validation for Huion 420, |
242 | | -> Gaomon S56K, XP-Pen G430 and G640. |
243 | | -> - Modified click detection on CTL-490 and CTH-490 (tablet.cfg ClickPressure). |
244 | | -
|
245 | | ->**v0.0.9:** |
246 | | -> - Yet another fix for the clicking problem... Maybe this time it will work? |
247 | | -
|
248 | | ->**v0.0.8:** |
249 | | -> - Another fix for pen tip clicking. Improved the tablet data validation. |
250 | | -
|
251 | | ->**v0.0.7:** |
252 | | -> - Added aspect ratio text to screen and tablet area. |
253 | | -> - 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 |
254 | | -
|
255 | | ->**v0.0.6:** |
256 | | -> - Improved smoothing filter latency calculation |
257 | | -
|
258 | | ->**v0.0.5:** |
259 | | -> - Added Windows Ink mode with pressure sensitivity |
260 | | -> - Added relative mouse mode |
261 | | -> - Added tablet area rotation |
262 | | -> - Added optional smoothing filter |
263 | | -
|
264 | | ->**v0.0.4:** |
265 | | -> - Fixed a number conversion bug in the tablet area detection. |
| 5 | +### This driver has not been updated for latest Windows versions! |
| 6 | +#### Please, use OpenTabletDriver: |
| 7 | +https://github.com/OpenTabletDriver/OpenTabletDriver |
0 commit comments