Skip to content

domdfcoding/PySetWacom

Repository files navigation

PySetWacom

Docs Documentation Build Status Docs Check Status
Tests Linux Test Status CodeFactor Grade pre-commit.ci status
PyPI PyPI - Package Version PyPI - Supported Python Versions PyPI - Supported Implementations PyPI - Wheel
Activity GitHub last commit Maintenance
Other License GitHub top language Requirements Status pre-commit

A GUI utility for configuring buttons on graphics tablets and styli, using the xsetwacom utility.

Installation

Before installing PySetWacom ensure you have installed the following:

  • xsetwacom. This may be installed by default.
  • PyGObject. See https://pygobject.readthedocs.io/en/latest/ for more information and installation instructions.

    On Ubuntu you may need to install libgirepository1.0-dev, libcairo2-dev and python3-gi.

  • wxPython (version 4.0.7 or greater). See https://wxpython.org/pages/downloads/ for more information and installation instructions.

    On Ubuntu you may also need to install libsdl2-2.0.0.

Depending on your tablet model you may need to install DIGImend. See https://digimend.github.io/ for further information, a list of supported devices, and installation instructions.

PySetWacom can be installed from PyPI.

To install with pip:

$ python -m pip install PySetWacom

Brief Tutorial

PySetWacom can be run from the terminal with the command

$ PySetWacom

or by selecting its icon from your application menu.

AppIndicator

Once started, you should see an AppIndicator icon appear that looks like this:

image

You can click this icon to show the Editor window, switch profiles, or quit PySetWacom.

image

Editor

In the Editor window, you can change profiles and edit the mappings for the different buttons on your tablet.

image

Double clicking on a button opens the Edit Mapping dialog, where you can type in the mapping or capture it from your keyboard.

image

If there are devices in the list that you don't want to configure, or if there is a new device you want to add, you can click the Manage Devices button in the Editor window.

image

Further Reading

https://github.com/linuxwacom/xf86-input-wacom/wiki/Tablet-Configuration-1:-xsetwacom-and-xorg.conf https://github.com/linuxwacom/xf86-input-wacom/wiki/xsetwacom https://www.x.org/releases/current/doc/man/man4/mousedrv.4.xhtml https://wiki.archlinux.org/index.php/Wacom_tablet