OpenTabletDriver(8)

NAME
opentabletdriver, otd, otd-gui, otd-daemon - User mode FOSS tablet driver

SYNOPSIS
otd [OPTIONS...] otd-gui [OPTIONS...] otd-daemon [OPTIONS...]

DESCRIPTION
OpenTabletDriver is a cross platform, open source, user mode graphics tablet driver aiming for the highest compatibility in an easily configurable graphical user interface.

OPTIONS

  Daemon Options (otd-daemon)
[-a, --appdata <directory>] Manually specify application data directory, defaults to ~/.config/OpenTabletDriver/ [-c, --config <directory>] Manually specify configuration directory (location of JSON files used to recognize tablets) [--version] Show version information [-?, -h, --help] Show help and usage information

  Graphical Front-end Options (otd-gui)
[-m, --minimized] Start OpenTabletDriver minimized, if possible in the desktop environment installed [--version] Show version information [-?, -h, --help] Show help and usage information for the GUI

DIAGNOSTICS
The daemon log is created in the application data directory, which by default is located at
        ~/.config/OpenTabletDriver/Logs/
The file format is almost JSON, with an end-of-array marker missing. This can be alleviated by appending a square bracket end ']' to the end of the file.

FREQUENT ISSUES AND QUESTIONS

  Failed to open device streams
This occurs due to a lack of permissions to open a device stream. It is resolved by creating udev rules that give these permissions. If you installed OpenTabletDriver via your package manager, you may need to run the following command, and then replug your tablet.
        sudo udevadm control --reload-rules

  Poor performance with NVIDIA
Disable "Force full composition pipeline" in the NVIDIA settings panel.

  Failed to initialize virtual device
The virtual device uses the uinput kernel module to create a virtual tablet. Common errors and their solution are provided below: EACCESS
    The udev rules have been installed incorrectly. If you are using an official OpenTabletDriver package, this is a bug and should be reported. The udev rules need to be located in one of the following directories:
            /etc/udev/rules.d/
            /usr/lib/udev/rules.d/
    and the file name must end with .rules Also see: udev(7)
ENODEV
    Most modern Linux distributions have uinput enabled, so this is usually caused by a missing reboot after a kernel update (and therefore no modules available to load), before uinput was loaded. If you have a custom compiled kernel, ensure that your kernel configuration includes the following as either 'y' (built-in) or 'm' (as module):
            CONFIG_INPUT_UINPUT

ENVIRONMENT

  DISPLAY
The X11 display to use

  WAYLAND_DISPLAY
The Wayland display to use. If both WAYLAND_DISPLAY and DISPLAY is set, WAYLAND_DISPLAY takes priority.

FILES

  bin/otd-daemon
The OpenTabletDriver driver daemon. This must be running at all times to provide a working tablet.

  bin/otd-gui
The graphical user interface for interacting with the daemon

  bin/otd
The command-line interface for interacting with the daemon. The command line interface is provided as-is.

  ~/.config/OpenTabletDriver/settings.json
The settings file used by the daemon

NOTES
This manpage is not autogenerated. Therefore the information provided within this man page may be out of date. We refer to OpenTabletDriver's website which has an up to date FAQ and other instructions.

BUGS

  Unreliable autostart with systemd
The systemd user service provided with OpenTabletDriver depends on a functioning graphical-session.target systemd user unit. If the target isn't initialized at the correct time, the OpenTabletDriver daemon can start before the environment variables are ready, resulting in the daemon crashing because it could not grab the correct display information. If you have this issue, a workaround is to put otd-daemon in your desktop environments autostart. However, you lose the crash handling provided by systemd. Some Linux distributions expect you to fix the target yourself.

SEE ALSO
OpenTabletDriver website: https://www.opentabletdriver.net/