diff --git a/site/_wiki/Documentation/ConfigurationGuide.md b/site/_wiki/Documentation/ConfigurationGuide.md index ed971ae..3af3c95 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 have 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..36d18e6 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: