1 unstable release

0.1.0 Jan 23, 2022

#743 in Unix APIs

GPL-3.0 license

21KB
313 lines

TABSET

Crates.io Build Clippy Audit

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

Get Appimage

This crate can also be installed via cargo with:

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:

# 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.

Usage

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

Dependencies

~0.5–10MB
~65K SLoC