Metadata-Version: 2.1
Name: PySetWacom
Version: 0.1.3
Summary: A GUI utility for configuring buttons on graphics tablets and styli
Home-page: https://github.com/domdfcoding/PySetWacom
Author: Dominic Davis-Foster
Author-email: dominic@davis-foster.co.uk
License: GPLv3
Platform: UNKNOWN
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: License :: OSI Approved :: GNU General Public License v3 (GPLv3)
Classifier: Operating System :: POSIX :: Linux
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3.6
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Topic :: Utilities
Classifier: Topic :: Artistic Software
Classifier: Topic :: Multimedia :: Graphics
Requires-Dist: domdf-python-tools (>=0.1.17)
Requires-Dist: appdirs (>=1.4.3)
Requires-Dist: sh (>=1.12.14)
Requires-Dist: Pypubsub (>=4.0.3)
Requires-Dist: pid (>=2.2.5)
Requires-Dist: domdf-wxpython-tools (>=0.2.0)

**********************
PySetWacom
**********************

.. image:: https://travis-ci.org/domdfcoding/PySetWacom.svg?branch=master
    :target: https://travis-ci.org/domdfcoding/PySetWacom
    :alt: Build Status
.. image:: https://readthedocs.org/projects/pysetwacom/badge/?version=latest
    :target: https://pysetwacom.readthedocs.io/en/latest/?badge=latest
    :alt: Documentation Status
.. image:: https://img.shields.io/pypi/v/pysetwacom.svg
    :target: https://pypi.org/project/pysetwacom/
    :alt: PyPI
.. image:: https://img.shields.io/pypi/pyversions/PySetWacom.svg
    :target: https://pypi.org/project/PySetWacom/
    :alt: PyPI - Python Version


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

Dependencies
=============

xsetwacom must be installed for this program to function. Python dependencies include:

.. code-block:: bash

	appdirs>=1.4.3
	domdf_python_tools>=0.1.17
	domdf_wxpython_tools>=0.2.0
	Pypubsub>=4.0.3
	pid>=2.2.5
	sh>=1.12.14

These can all be installed using ``pip``.

wxPython (4.0.7 or greater) must also be installed. See https://wxpython.org/pages/downloads/ for more information and installation instructions.

PyGObject must also be installed. See https://pygobject.readthedocs.io/en/latest/ for more information and installation instructions.


Brief Tutorial
================

`PySetWacom` can be run from the terminal with the command

.. code-block:: bash

	$ PySetWacom

or from your application menu.

AppIndicator
---------------

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

.. image:: images/AppIndicator.png

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

.. image:: images/AppIndicatorMenu.png

Editor
-------

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

.. image:: images/Editor.png
	:width: 400

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


.. image:: images/Edit_Mapping.png
	:width: 400

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:: images/Manage_Devices.png
	:width: 400




