Linux Installation Guide


Contents

    Ubuntu / Debian

    1. Download the latest release (OpenTabletDriver.deb)
    2. Download the Microsoft repository package (packages-microsoft-prod.deb) for your distribution
    3. Run the following commands in a terminal
      This assumes that you are in the directory in which you download these files to.
      # Add the Microsoft Packages repository, use the URL related to your distribution
      sudo dpkg -i packages-microsoft-prod.deb
      
      # Install the .NET runtime
      sudo apt update
      sudo apt install -y apt-transport-https
      sudo apt update
      sudo apt install -y dotnet-sdk-6.0
      
      # 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

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

      Alternatively, you can install opentabletdriver without an AUR helper.

    1. Run the following commands in a terminal to install and enable the OpenTabletDriver service.
      # Downloads the pkgbuild from the AUR.
      git clone https://aur.archlinux.org/opentabletdriver.git
      # Changes into the correct directory and installs OpenTabletDriver
      cd opentabletdriver && makepkg -si
      # Clean up leftovers
      cd ..
      rm -rf opentabletdriver
      # Reload the systemd user unit daemon
      systemctl --user daemon-reload
      # Enable and start the user service
      systemctl --user enable opentabletdriver --now
      

    Gentoo

    1. Add Guru overlay
      This is only required if you don't already have the Guru overlay configured
      # Add guru repository
      sudo layman -L
      sudo layman -a guru
      sudo layman -s guru
      
      # Enable guru repository
      sudo eselect repository enable guru
      sudo emerge --sync guru
      
    2. Edit /etc/portage/package.accept_keywords and add this line
      x11-drivers/OpenTabletDriver-bin ~amd64
      
    3. Run the following command
      # Install the OpenTabletDriver package
      sudo emerge OpenTabletDriver-bin
      

    NixOS

    1. Edit /etc/nixos/configuration.nix and add this in your configuration
      More configuration options can be found here
      # Enable OpenTabletDriver
      hardware.opentabletdriver.enable = true;
      

    Post-Installation

    You're advised to look at the console tab on OpenTabletDriver UX to catch any problems. If necessary, read through the FAQ.