base on Open source, cross-platform, user-mode tablet driver [](https://github.com/OpenTabletDriver/OpenTabletDriver/actions) [](https://github.com/OpenTabletDriver/OpenTabletDriver/releases/latest) # OpenTabletDriver English | [Español](docs/README_ES.md) | [Français](docs/README_FR.md) | [Deutsch](docs/README_DE.md) | [Português-BR](docs/README_PTBR.md) | [Nederlands](docs/README_NL.md) | [한국어](docs/README_KO.md) | [Русский](docs/README_RU.md) | [简体中文](docs/README_CN.md) | [繁體中文](docs/README_TW.md) | [Ελληνικά](docs/README_EL.md) | [Magyar](docs/README_HU.md) OpenTabletDriver is an open source, cross platform, user mode tablet driver. The goal of OpenTabletDriver is to be cross platform as possible with the highest compatibility in an easily configurable graphical user interface. <p align="middle"> <img src="https://i.imgur.com/XDYf62e.png" width="410" align="middle"/> <img src="https://i.imgur.com/jBW8NpU.png" width="410" align="middle"/> <img src="https://i.imgur.com/ZLCy6wz.png" width="410" align="middle"/> </p> # Supported Tablets All statuses of tablets that are supported, untested, and planned to be supported can be found here. Common issue workarounds can be found in the wiki for your platform. - [Supported Tablets](https://opentabletdriver.net/Tablets) # Installation - [Windows](https://opentabletdriver.net/Wiki/Install/Windows) - [Linux](https://opentabletdriver.net/Wiki/Install/Linux) - [MacOS](https://opentabletdriver.net/Wiki/Install/MacOS) # Running OpenTabletDriver binaries OpenTabletDriver functions as two separate processes that interact with each other seamlessly. The active program that does all of the tablet data handling is `OpenTabletDriver.Daemon`, while the GUI frontend is `OpenTabletDriver.UX.*`, where `*` depends on your platform¹. The daemon must be started in order for anything to work, however the GUI is unnecessary. If you have existing settings, they should apply when the daemon starts. > ¹Windows uses `Wpf`, Linux uses `Gtk`, and MacOS uses `MacOS` respectively. This for the most part can be ignored if you don't build it from source as only the correct version will be provided. ## Building OpenTabletDriver from source The requirements to build OpenTabletDriver are consistent across all platforms. Running OpenTabletDriver on each platform requires different dependencies. ### All platforms - .NET 8 SDK (can be obtained from [here](https://dotnet.microsoft.com/download/dotnet/8.0) - You want the SDK for your platform, Linux users should install via package manager where possible) #### Windows Run `build.ps1` to produce binary builds to 'bin' folder. These builds will run in portable mode by default. #### Linux Required packages (some packages may be pre-installed for your distribution): - libx11 - libxrandr - libevdev2 - GTK+3 Run `./eng/linux/package.sh`. If a "package" build is desired, there is official support for the following packaging formats: | Package Format | Command | | --- | --- | | Generic binary tarball (`.tar.gz`) | `./eng/linux/package.sh --package BinaryTarBall` | | Debian package (`.deb`) | `./eng/linux/package.sh --package Debian` | | Red Hat package (`.rpm`) | `./eng/linux/package.sh --package RedHat` | The generic binary tarball is designed to be extracted from the root directory. #### MacOS [Experimental] Run `./eng/macos/package.sh --package true`. # Features - Fully platform-native GUI - Windows: `Windows Presentation Foundation` - Linux: `GTK+3` - MacOS: `MonoMac` - Fully fledged console tool - Quickly acquire, change, load, or save settings - Scripting support (json output) - Absolute cursor positioning - Screen area and tablet area - Center-anchored offsets - Precise area rotation - Relative cursor positioning - px/mm horizontal and vertical sensitivity - Pen bindings - Tip by pressure bindings - Express key bindings - Pen button bindings - Mouse button bindings - Keyboard bindings - External plugin bindings - Saving and loading settings - Auto-loads user settings via `settings.json` in the active user `%localappdata%` or `.config` settings root directory. - Plugins - Filters - Output modes - Tools # Contributing to OpenTabletDriver If you wish to contribute to OpenTabletDriver, check out the [issue tracker](https://github.com/OpenTabletDriver/OpenTabletDriver/issues). When creating pull requests, follow the guidelines outlined in our [contribution guidelines](https://github.com/OpenTabletDriver/OpenTabletDriver/blob/master/CONTRIBUTING.md). If you have any issues or suggestions, [open an issue ticket](https://github.com/OpenTabletDriver/OpenTabletDriver/issues/new/choose) and fill out the template with relevant information. We welcome both bug reports, as well as new tablets to add support for. In many cases adding support for a new tablet is quite easy. For issues and PRs related to OpenTabletDriver's [web page](https://opentabletdriver.net), see the repository [here](https://github.com/OpenTabletDriver/opentabletdriver.github.io). ### Supporting a new tablet If you'd like us to add support for a new tablet, open an issue or join our [discord](https://discord.gg/9bcMaPkVAR) asking for support. *We generally prefer that adding support for a tablet be done through discord, due to the back-and-forth involved*. We'll have you do a few things like making a recording of the data sent by your tablet using our built-in tablet debugging tool, testing features of the tablet (on-tablet buttons, pen buttons, pen pressure, etc) with different configs we'll send you to try. You're also of course welcome to open a PR adding support for it yourself, if you have a good grasp on what's involved. Generally this process is relatively easy, especially if it's for a tablet manufacturer we already have support for on other tablets. ", Assign "at most 3 tags" to the expected json: {"id":"2291","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"