No description
Find a file
Linus Björnstam 6e6afad071 README with screenshots of the GUI
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-17 11:17:08 +01:00
corpus keyscore: a scorer, optimizer and GUI for keyboard layouts 2026-11-17 11:14:39 +01:00
docs README with screenshots of the GUI 2026-11-17 11:17:08 +01:00
src keyscore: a scorer, optimizer and GUI for keyboard layouts 2026-11-17 11:14:39 +01:00
tests keyscore: a scorer, optimizer and GUI for keyboard layouts 2026-11-17 11:14:39 +01:00
.gitignore keyscore: a scorer, optimizer and GUI for keyboard layouts 2026-11-17 11:14:39 +01:00
manifest.bjodat keyscore: a scorer, optimizer and GUI for keyboard layouts 2026-11-17 11:14:39 +01:00
packages.lock.json keyscore: a scorer, optimizer and GUI for keyboard layouts 2026-11-17 11:14:39 +01:00
README.md README with screenshots of the GUI 2026-11-17 11:17:08 +01:00

keyscore

keyscore scores and optimizes keyboard layouts for an ISO Swedish keyboard typed with the angle mod. It scores on Swedish and English text, and it has a GUI for tuning the scoring.

It is written in Bjolang. The GUI uses bjogui.

The Layout tab: the chosen layout on the board, and the parts of its score

The model

The scoring starts from Michael Capewell's rules and adds more rules. Lower is better. A score is a cost per key press.

  • Key costs: each key has a cost. A press costs the key's cost times the key weight.
  • Vowels on the top row: each press of a vowel on the top row costs more.
  • Pairs: a rule gives a cost or a bonus to each pair of presses on one hand. The rules are stretch keys, same finger, jumps between the top and bottom rows, easy jumps, close keys and adjacent keys. A pair with a space between costs a share of the full cost.
  • Row motion: a pair on one hand that changes rows costs by direction. If the outer finger is up, the hand keeps its shape. If the inner finger or a pinky is up, the hand twists. Pairs with the bottom row cost more, except pairs with the index keys.
  • Triples: hand runs, same-finger skips and two-finger runs.
  • Pinky load: each pinky can type a share of all presses at no cost. Each press past that share costs extra.
  • Finger distance: how far the fingers travel, in key widths per press. By default it is shown but not scored.

src/score.bjo describes each rule. src/board.bjo describes the board and the key costs.

The texts are in corpus/:

  • sv.txt and en.txt are extracts of featured Wikipedia articles. corpus/fetch.py fetches them again. They have the same weight.
  • bjolang.txt is Bjolang source code. Its weight is 0: it is shown but not in the mean.

Running

You need Bjolang. Put bjogui next to this folder, as ../bjogui. Run the programs from this folder.

Command What it does
bjo run . Prints the report: each layout's score on each text, the parts of the scores, and the pairs that cost each layout most.
bjo run src/gui.bjo Opens the GUI.
bjo run src/optimize.bjo [runs] [steps] [layout] [t-start] [vowels-left] [fixed=CHARS] Searches for a better layout by simulated annealing.
bjo run src/swaps.bjo [char] [layout] Tries to swap one character with each other key.
bjo run src/word.bjo word [layout] Shows what a word costs a layout, pair by pair.
bjo run tests/gui-shots.bjo [folder] Tests the GUI without a screen, and saves the screenshots in this file.

All the programs score with the numbers in params.txt if that file exists. If not, they use the defaults. The GUI writes params.txt.

The GUI

The left side shows each layout's score, best first. A change to a number rescores all the layouts at once. Click a layout to choose it for the Layout and Search tabs.

Each number and option has a blue "i" mark. Point at the mark to see what the setting does and its default value.

Rules

All the numbers of the model, by group. You can save the numbers as a named preset. Presets are kept in presets/. Save at the top writes the numbers to params.txt for the other programs. Defaults puts back the built-in numbers.

The Rules tab

Key costs

The cost of each key, shown on the board.

The Key costs tab

Layout

The chosen layout and each part of its score, for each text and as the mean. You can save a layout under a name, or remove a layout that is not built in. Saved layouts are kept in saved-layouts.txt and are listed at start.

Runs the optimizer from the chosen layout with the current numbers. For each result:

  • Keep adds it to the list.
  • Save saves it under the name in "Save as".
  • Copy puts it on the clipboard as a make-layout form for src/layouts.bjo.

The Search tab, after a short search

Layouts

The built-in layouts are in src/layouts.bjo. A layout is three rows of characters. The top row starts at Q, the home row at A and the bottom row at <. Spaces are skipped. With the default numbers the optimized layouts score about 4.3 to 4.5, Svdvorak scores 7.38 and QWERTY 15.38. An example is ZYK,Å:

ZYK,Å   XCHPW
IEDAÄ   VTRNS
ÖUFO. Q GMLBJ