cc-translate

README

cc-translate

Translate CharaChorder Chord files between keyboard layouts. This makes it possible to use a "readable" Qwerty CSV chord file but make it usable when your CCL is configured with an alternate layout such as Colemak or Dvorak.

Installation

cc-translate is a command line program. Please download an appropriate binary for your computer at https://codeberg.org/jcowgar/cc-translate/releases

Uncompress, and then use!

Example Usage

# Simple translation of Qwerty to Colemak
$ cc-translate --layout colemak my-chords.csv translated-chords.csv

# Translate a Dovrak CSV back to Qwerty
$ cc-translate --layout dvorak --reverse my-chords.csv my-chords-qwerty.csv

# Register a user defined layout
$ cc-translate --register my-layout.yaml --layout my-laylout in.csv out.csv

User Defined Layout

Layouts are defined in a YAML file. An example that flips the A, B and C keys with the X, Y and Z keys would look like:

name: AbcXyz
translations:
  "a": "x"
  "b": "y"
  "c": "z"