W

The wacom_config script intends to define several actions on Wacom tablets.

README.md

Synopsis

The wacom_config script intends to define several actions on Wacom tablets.

The implemented actions currently are:

  • Toggling the pointing mode between "Absolute" and "Relative".
  • Rotating the tablet orientation by 90° (counter clockwise).
  • Decrease or Increase the sensitivity of the stylus pressure.
  • Get the battery power status of the tablet.
  • Emulate the action associated to the pad Button n° (where N is either 1, 2, 3 or 4). This makes sense if used in conjunction with xbindkeys.
  • (Re)Initialize the wacom_config settings.
  • Display a notification on disconnection.

Configuration steps (recommended)

This script works on command line (run wacom_config without argument to have a description of the subcommands).

Getting notifications.

For each wacom_config action, you should be notified if the notify-send program is available on your system.

Associating actions to the pad buttons

Obviously, using xbindkeys makes it a little bit more functional.

Indeed, if you are using xbindkeys, this allows to bind subcommands to the tablet buttons by adding the following lines in your ${HOME}/.xbindkeysrc file (assuming that the script is located at /usr/local/src/wacom_config):

"/usr/local/src/wacom_config/wacom_config pad_button 1"
     m:0x10 + b:20   (mouse)
"/usr/local/src/wacom_config/wacom_config pad_button 2"
     m:0x10 + b:21   (mouse)
"/usr/local/src/wacom_config/wacom_config pad_button 3"
     m:0x10 + b:22   (mouse)
"/usr/local/src/wacom_config/wacom_config pad_button 4"
     m:0x10 + b:23   (mouse)

Remember that you have to reload xbindkeys to make those changes effective (/e.g./, by running killall -HUP xbinkeys).

Thus, once initialized (by the wacom_config init command), you are able to access to the associated commands by clicking on the tablet buttons.

Automating initialisation process

Additionally, in order to automate the initialization process, you can add an udev rule to make it work.

prompt$ cd /etc/udev/rules.d
prompt$ sudo ln -s /usr/local/src/wacom_config/config/wacom_config.udev_rules 99-wacom-config.rules
prompt$ sudo udevadm control --reload-rules
prompt$ sudo udevadm trigger

From now, your Wacom tablet should be initialized when connected (USB or Bluetooth) and you should be notified on disconnection.

Finally, a default configuration file is provided with this program, which is loaded first. You can also change the settings by creating a .wacom-config file in your home directory. All settings in this file will superseed the default ones.

About wacom-config

This program will be (I Hope) fully described in the french journal "GNU/Linux Magasine" before the end of 2020. A complete an precise reference will be given after publication.

Copyrights

Copyright © 2020 -- DoccY's Productions

Authors: Alban Mancheron doccy@mancheron.fr

This software is a computer program whose purpose is to define and customize several actions on Wacom tablets.

This software is governed by the CeCILL license under French law and abiding by the rules of distribution of free software. You can use, modify and/ or redistribute the software under the terms of the CeCILL license as circulated by CEA, CNRS and INRIA at the following URL "http://www.cecill.info".

As a counterpart to the access to the source code and rights to copy, modify and redistribute granted by the license, users are provided only with a limited warranty and the software's author, the holder of the economic rights, and the successive licensors have only limited liability.

In this respect, the user's attention is drawn to the risks associated with loading, using, modifying and/or developing or reproducing the software by the user in light of its specific status of free software, that may mean that it is complicated to manipulate, and that also therefore means that it is reserved for developers and experienced professionals having in-depth computer knowledge. Users are therefore encouraged to load and test the software's suitability as regards their requirements in conditions enabling the security of their systems and/or data to be ensured and, more generally, to use and operate it in the same conditions as regards security.

The fact that you are presently reading this means that you have had knowledge of the CeCILL license and that you accept its terms.

text of the complete CeCILL Licence (v2.1):

Thanks

Remember that comments are welcome.

Enjoy using wacom_config and feel free to improve it.

Alban Mancheron doccy@mancheron.fr