Table of Contents

Description

TBD

In the meantime, see the kwprocessor Github page.

Options

$ ./kwp -V
v1.00

$ ./kwp --help
Advanced keyboard-walk generator with configureable basechars, keymap and routes

Usage: ./kwp [options]... basechars-file keymap-file routes-file

 Options Short / Long        | Type | Description                                                 | Default
=============================+======+=============================================================+=========
  -V, --version              |      | Print version                                               |
  -h, --help                 |      | Print help                                                  |
  -o, --output-file          | FILE | Output-file                                                 |
  -b, --keyboard-basic       | BOOL | Include characters reachable without holding shift or altgr | 1
  -s, --keyboard-shift       | BOOL | Include characters reachable by holding shift               | 0
  -a, --keyboard-altgr       | BOOL | Include characters reachable by holding altgr (non-english) | 0
  -z, --keyboard-all         |      | Shortcut to enable all --keyboard-* modifier                |
  -1, --keywalk-south-west   | BOOL | Include routes heading diagonale south-west                 | 0
  -2, --keywalk-south        | BOOL | Include routes heading straight south                       | 1
  -3, --keywalk-south-east   | BOOL | Include routes heading diagonale south-east                 | 0
  -4, --keywalk-west         | BOOL | Include routes heading straight west                        | 1
  -5, --keywalk-repeat       | BOOL | Include routes repeating character                          | 0
  -6, --keywalk-east         | BOOL | Include routes heading straight east                        | 1
  -7, --keywalk-north-west   | BOOL | Include routes heading diagonale north-west                 | 0
  -8, --keywalk-north        | BOOL | Include routes heading straight north                       | 1
  -9, --keywalk-north-east   | BOOL | Include routes heading diagonale north-east                 | 0
  -0, --keywalk-all          |      | Shortcut to enable all --keywalk-* directions               |
  -n, --keywalk-distance-min | NUM  | Minimum allowed distance between keys                       | 1
  -x, --keywalk-distance-max | NUM  | Maximum allowed distance between keys                       | 1
  -

Examples

$ ./kwp basechars/full.base keymaps/en.keymap routes/3-to-3-exhaustive.route | head
0p;/
1qaz
2wsx
3edc
4rfv
5tgb
6yhn
7ujm
8ik,
9ol.

$ ./kwp basechars/full.base keymaps/en.keymap routes/2-to-10-max-3-direction-changes.route | head
-[
0p
1q
2w
3e
4r
5t
6y
7u
8i

$ ./kwp basechars/full.base keymaps/en.keymap routes/2-to-10-max-3-direction-changes.route | tail
zxcvbnm,.,k
';lkjhgfdfr
.,mnbvcxzxs
/.,mnbvcxcd
;lkjhgfdsde
[poiuytrer4
][poiuytrt5
lkjhgfdsasw
oiuytrewqw2
poiuytrewe3

./kwp basechars/full.base keymaps/en.keymap routes/2-to-10-max-3-direction-changes.route | wc -l
39828