Troubleshooting

Having issues? This is a quick guide to find the most-likely source of the problem, gather logs, and submit a good bug report.

Known Issues

Some issues are reported commonly enough that they deserve special mention. Please quickly check our list of known issues to see yours is one.

Where's the Problem?

Symptom	Component
Any non-GNOME/Unity/Cinnamon control panel issue.	Third-party
The GNOME/Unity/Cinnamon control panel settings (e.g. button mapping, display mapping, etc.) are misapplied.	GNOME
The GNOME/Unity/Cinnamon control panel layout is incorrect.	GNOME
The GNOME/Unity/Cinnamon control panel does not work correctly.	GNOME
The GNOME/Unity/Cinnamon control panel detects the device, but it has incorrect information.	libwacom
The device works but does not show up in xsetwacom	xf86-input-wacom
The xsetwacom utility is not working properly.	xf86-input-wacom
The device works but is misconfigured (non-GNOME/Unity/Cinnamon desktop).	xf86-input-wacom
The device works but graphics applications like GIMP, Krita, MyPaint, or Inkscape behave incorrectly.	xf86-input-wacom
The device works and shows up in xsetwacom, but behaves incorrectly in all programs -- not just graphics applications.	Kernel
The device does not work at all.	Kernel
The device is not listed in the output of grep -H "" /sys/module/*wacom*/drivers/*/*/input/*/name	Kernel
Nothing is listed in the output of ls -d /sys/module/*wacom*	Kernel

Gathering Logs

The sysinfo.sh script from our wacom-hid-descriptors repository can be used to gather system information. When filing a bug, please run the script and attach its output for review.

Submitting Bug Reports

Depending on the component which is at fault, you will need to file a bug in one of several places:

Third-Party: Distributions based on desktops like KDE make use of control panels that the linuxwacom project does not test or review. It is recommended to get in touch with either the distribution or control panel developer to report issues.

GNOME: If you are using Unity, Cinnamon, or any other fork of the GNOME 3 desktop, it is recommended to see if your issue is present in GNOME itself. One way to to this is to try your tablet inside the latest Fedora Live CD since this will have an up-to-date version of GNOME. If the issue is also present on the Live CD, you should file an issue directly against GNOME. Otherwise, please file an issue against your particular fork:

• gnome-control-center issues
• unity-control-center issues
• cinnamon-control-center issues

libwacom: Issues with libwacom should be filed at libwacom issues.

xf86-input-wacom: Issues with xf86-input-wacom should be filed at xf86-input-wacom issues.

Kernel: Issues with the kernel driver should be filed at input-wacom issues.