From 92c6dd1842b063f2fb790ecb0c52a04d52251d36 Mon Sep 17 00:00:00 2001 From: Sebastian 'gonX' Jensen Date: Mon, 31 Aug 2026 13:48:46 +0200 Subject: [PATCH 1/2] Wiki: Add how to override tablet configurations --- .../_wiki/Documentation/ConfigurationGuide.md | 26 +++++++++++++++++++ site/_wiki/FAQ/General.md | 3 +++ 2 files changed, 29 insertions(+) diff --git a/site/_wiki/Documentation/ConfigurationGuide.md b/site/_wiki/Documentation/ConfigurationGuide.md index ed971ae..992ed6d 100644 --- a/site/_wiki/Documentation/ConfigurationGuide.md +++ b/site/_wiki/Documentation/ConfigurationGuide.md @@ -14,6 +14,32 @@ on that page. [Tablet configuration reference]: {% link _wiki/Development/Configurations.md %} +### Adding custom tablet configurations {#installing-overrides} + +To test your new tablet configuration (internally named 'overrides'), you do +not need to recompile OpenTabletDriver from source. + +Instead, you can place them in the designated `Configurations` folder as +described in [the AppData section of the General FAQ](/Wiki/FAQ/General#appdata). + +If successful, you should see a log message similar to this: + +| Log Level | Log Group | Log Message | +| :-------: | :-------: | :---------- | +| Info | Detect | 1 configurations exist in '``'. Built-in configurations may be overridden if the Name matches exactly. + +Additionally, if you are overriding an existing configuration (by matching the +`Name` key value of the internal configuration exactly), you should also see +the following message during the detection loop: + +| Log Level | Log Group | Log Message | +| :-------: | :-------: | :---------- | +| Debug | Detect | Searching for tablet '``' +| Info | Detect | Overriding tablet configuration '``' + +> **Note:** OpenTabletDriver versions before v0.6.7 has limited logging for +> configuration overrides + ## Preparing your system for adding support It is highly recommended to remove (or unload) your existing tablet drivers diff --git a/site/_wiki/FAQ/General.md b/site/_wiki/FAQ/General.md index c08fb1e..bc2b3b4 100644 --- a/site/_wiki/FAQ/General.md +++ b/site/_wiki/FAQ/General.md @@ -46,8 +46,11 @@ The application data directory contents are as follows: | Cache | Folder | Contains cached metadata for the Plugin Manager | Plugins | Folder | Contains installed plugins (`.dll` files). This folder should not be modified manually. | Presets | Folder | Contains saved presets +| Configurations | Folder | (optional) Contains user-defined tablet configuration overrides (or additions) {: .table .table-dark } +> **Linux users:** Tablet configuration overrides can also be placed in `~/.local/share/OpenTabletDriver/Configurations/` + ## My cursor is going crazy! It teleports everywhere! {#emi-interference} This is caused by electromagnetic interference (EMI) from other devices. Make sure that the tablet is not near any of the following: From 1bfd30f85ee0fb481a05774863e5ad6fae0a8b61 Mon Sep 17 00:00:00 2001 From: Sebastian Jensen Date: Mon, 31 Aug 2026 17:00:21 +0200 Subject: [PATCH 2/2] Apply batched suggestions from code review Co-authored-by: Kuuuube <61125188+Kuuuube@users.noreply.github.com> --- site/_wiki/Documentation/ConfigurationGuide.md | 2 +- site/_wiki/FAQ/General.md | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/site/_wiki/Documentation/ConfigurationGuide.md b/site/_wiki/Documentation/ConfigurationGuide.md index 992ed6d..3af3c95 100644 --- a/site/_wiki/Documentation/ConfigurationGuide.md +++ b/site/_wiki/Documentation/ConfigurationGuide.md @@ -37,7 +37,7 @@ the following message during the detection loop: | Debug | Detect | Searching for tablet '``' | Info | Detect | Overriding tablet configuration '``' -> **Note:** OpenTabletDriver versions before v0.6.7 has limited logging for +> **Note:** OpenTabletDriver versions before v0.6.7 have limited logging for > configuration overrides ## Preparing your system for adding support diff --git a/site/_wiki/FAQ/General.md b/site/_wiki/FAQ/General.md index bc2b3b4..36d18e6 100644 --- a/site/_wiki/FAQ/General.md +++ b/site/_wiki/FAQ/General.md @@ -46,7 +46,7 @@ The application data directory contents are as follows: | Cache | Folder | Contains cached metadata for the Plugin Manager | Plugins | Folder | Contains installed plugins (`.dll` files). This folder should not be modified manually. | Presets | Folder | Contains saved presets -| Configurations | Folder | (optional) Contains user-defined tablet configuration overrides (or additions) +| Configurations | Folder | (optional) Contains user-defined tablet configuration overrides or additions {: .table .table-dark } > **Linux users:** Tablet configuration overrides can also be placed in `~/.local/share/OpenTabletDriver/Configurations/`