Converts Twiddler3 keyboard configuration files to human readable format and vice versa
PowerShell
Switch branches/tags
Nothing to show
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Failed to load latest commit information.
.gitignore
Finnish.hid.txt
LICENSE
README.md
TwiddlerCfg2Text.ps1
TwiddlerText2Cfg.ps1
Us.hid.txt
twiddler_Finnish.cfg
twiddler_Finnish.text.cfg
twiddler_default.cfg
twiddler_default.text.cfg

README.md

TwiddlerCfgConverter

Converts Twiddler3 keyboard configuration files to human readable format and vice versa

  • Faster to create new configurations( from existing ones)

  • Allows using international charactersets and keyboards

  • Allows writing comments about design decisions.

  • Allows making groups of similar chord combinations for easier learning

Convert Twiddler3 cfg to text file

powershell -file TwiddlerCfg2Text.ps1 inputfilename outputfilename [HID file name]

Examples:

powershell -file TwiddlerCfg2Text.ps1 twiddler_default.cfg twiddler_default.text.cfg

powershell -file TwiddlerCfg2Text.ps1 twiddler_default.cfg twiddler_default.text.cfg Us.hid.txt

Convert Twiddler3 text file to cfg file

powershell -file TwiddlerText2Cfg.ps1 inputfilename outputfilename

Text file format:

# Starts a comment

Chord descriptions start with line:

-- Chords --

Single key:

modifier chords hid_modifier&key character

Example:

AN LLOL 0047

O ROOO 0004 a

Macro keys:

modifier chords hid_modifier&key,hid_modifier&key2... character1character2

Example:

O OLOM 000C,0012,0011,002C ion

Shown characters are fetched from HID key map file. Default file is Us.hid.txt.

Shown characters are only for visualisation, the actual conversion from text file to cfg file is done with hid_modifier&key values.

HID key map file can be Unicode and output file is always Unicode.

Config file creator adds MouseMap from default Twiddler configuration ( Twiddler3 does not use mousemap)