65 lines
2.7 KiB
Markdown
65 lines
2.7 KiB
Markdown
# TABSET
|
|
[](https://crates.io/crates/tabset)
|
|
[](https://github.com/Ewpratten/tabset/actions/workflows/build.yml)
|
|
[](https://github.com/Ewpratten/tabset/actions/workflows/clippy.yml)
|
|
[](https://github.com/Ewpratten/tabset/actions/workflows/audit.yml)
|
|
|
|
|
|
`tabset` is a Linux command-line tool for configuring your drawing tablets.
|
|
|
|
The tool is based around the concept of configuration scripts, and follows a super simple, yet extensible configuration system. Each device you might own gets its own directory, and inside some simple metadata is stored along with a list of shell scripts you can use to set various `xsetwacom` options.
|
|
|
|
## Installation
|
|
|
|
[](https://github.com/Ewpratten/tabset/releases/latest)
|
|
|
|
This crate can also be installed via `cargo` with:
|
|
|
|
```sh
|
|
cargo install tabset
|
|
```
|
|
|
|
## Configuration
|
|
|
|
Configuration files are stored in `~/.config/tabset/`. These files are simply sorted by directory. Here is a listing of my personal configs:
|
|
|
|
```shell
|
|
# ewpratten@ewpratten-desktop ~/.config/tabset $ tree
|
|
.
|
|
└── devices
|
|
└── huion-kamvas-13
|
|
├── name
|
|
├── peripherals
|
|
└── profiles
|
|
├── blender.sh
|
|
├── default.sh -> blender.sh
|
|
└── disabled.sh
|
|
|
|
3 directories, 5 files
|
|
```
|
|
|
|
The `name` and `peripherals` files must exist for each device. `name` is mostly un-used at the moment, but should contain a friendly name for your device. `peripherals` is a list of strings that `tabset` will search for in the output of `xsetwacom --list` if you run the `tabset check <device>` command.
|
|
|
|
Each of the profile scripts just contain whatever configuration commands you want. You can see my blender one [in the example config directory](./example_configs/devices/huion-kamvas-13/profiles/blender.sh).
|
|
|
|
### Usage
|
|
|
|
```text
|
|
tabset 0.1.0
|
|
Evan Pratten <ewpratten@gmail.com>
|
|
A Linux drawing tablet configuration tool
|
|
|
|
USAGE:
|
|
tabset <SUBCOMMAND>
|
|
|
|
FLAGS:
|
|
-h, --help Prints help information
|
|
-V, --version Prints version information
|
|
|
|
SUBCOMMANDS:
|
|
check Check if a specific tablet is connected. Prints message and returns status code
|
|
help Prints this message or the help of the given subcommand(s)
|
|
list List all configured devices and their profiles
|
|
profile Set a specific tablet to use a specific profile
|
|
```
|