kiwiz/twiddler-ctl

Python

twiddler-ctl

A CLI tool to manage Twiddler (v7) configurations

Features

Converting between binary (.cfg) files and a text-based format
Support for alternative keyboard layouts
Syncing a set of configuration files to the Twiddler
(WIP) Untethered Re-Chording Mode datalog encoding/decoding
(WIP) Chord visualizations

Installation

Install with pipx or pip:

pipx install twiddler-ctl

Usage

Manipulating configuration files

To Text:

twiddler-ctl convert input.cfg output.txt

To Binary:

twiddler-ctl convert input.txt output.cfg

Visualize configuration file

twiddler-ctl visualize input.cfg

Sync configurations

Copy config.sample.ini and rename to config.ini
Update the file to point to your Twiddler
Sync configs with twiddler-ctl sync

Print valid keys

twiddler-ctl dump --table=keys

Manipulating Untethered Re-Chording Mode datalog files

Encoding:

twiddler-ctl convert-log input.txt output.log

Decoding:

twiddler-ctl convert-log input.log output.txt