Repository files navigation

libwacom is a library to identify graphics tablets and their model-specificfeatures. It provides easy access to information such as "is this a built-inon-screen tablet", "what is the size of this model", etc.

The name libwacom is historical - it was originally developed for Wacom devicesonly but now supports any graphics tablet from any vendor.

libwacom does not make a tablet work. libwacom is merely a database with aC library wrapper forinformation about a tablet. It has no effect on whetherthat tablet works.

libwacom is currently used by GUI toolkits (GNOME, KDE, others?) to mapbuilt-in tablets to the correct screen and by libinput to determine configurationoptions such as the left-handed settings. SVG layout files are used to describetablet visually.

A common indicator that a device is not supported by libwacom is that it worksnormally in a GNOME session, but the device is not correctly mapped to thescreen.

Use thelibwacom-list-local-devices tool to list all local devices recognizedby libwacom. If your device is not listed, but it is available as an eventdevice in the kernel (see/proc/bus/input/devices) and in the X session (seexinput list), the device is missing from libwacom's database.Use thelibwacom-list-devices tool to list all known devices and verifythe tablet is not in that list.

Seethis wiki page on adding a new device and how to test it.

The API documentation is available athttps://linuxwacom.github.io/libwacom/