Installation Guide - ceilingwaffle/OpenTabletDriver GitHub Wiki

Windows

Installation on Windows can be either portable or installed with the installer/auto-updater.

Installer

  1. Download the latest installer executable

    This is found under the Assets expander, which may be collapsed. Click to open it.

  2. Extract it to a whichever directory you wish, but do not forget where it is.

    You will be using the installer/updater to launch OpenTabletDriver and keep up to date.

  3. Run OpenTabletDriver.Installer.exe, and click Install.
  4. Once installation is complete, click Start.

To relaunch OpenTabletDriver at any point after, just run the same OpenTabletDriver.Installer.exe file.

Portable

Note 1: You will not be notified of updates if you decide to go this route.

Note 2: The portable version is sensitive to the working directory, do not launch it from the start menu!

  1. Download the latest release: OpenTabletDriver.win-x64.zip

    This is found under the Assets expander, which may be collapsed. Click to open it.

  2. Extract to the folder you intend to use for portability.
  3. Run OpenTabletDriver.UX.Wpf.exe in the directory you extracted it to.

To relaunch in the future, run that same executable.

Linux

This varies between distributions, so this will only cover the distributions I officially maintain.

Other packaged distributions are linked in the releases.

Debian/Ubuntu Installation

  1. Download the latest release: OpenTabletDriver.deb

    This is found under the Assets expander, which may be collapsed. Click to open it.

  2. Run the following in a terminal:
# This will install the package, assuming you are in the correct directory
sudo apt install ./OpenTabletDriver.deb
# Reload the systemd user unit daemon
systemctl --user daemon-reload
# Enable and start the user service
systemctl --user enable opentabletdriver --now

Arch Linux Installation

  1. Use an AUR helper to install opentabletdriver-git
  2. Run the following in a terminal:
# Reload the systemd user unit daemon
systemctl --user daemon-reload
# Enable and start the user service
systemctl --user enable opentabletdriver --now

MacOS (Experimental)

MacOS is a bit difficult to get working on newer versions, such as Catalina or Mojave due to some changes they made for security reasons.

If you are running an older version such as High Sierra, these can be skipped.

Portable

  1. Download the latest release: OpenTabletDriver.osx-x64.tar.gz
  2. Download and install the .NET 5 Runtime
  3. Extract it to a known directory.
  4. Using a terminal, navigate to the directory you extracted to.
  5. In that terminal, run:

    If it fails to start due to stuff being unsigned, you will have to allow each file in the directory individually.

dotnet ./OpenTabletDriver.Daemon.dll & open ./OpenTabletDriver.UX.MacOS.app

You will have to perform steps 4-5 each time you wish to run the driver, until we figure out a better way to use this.