9 layers
Base, Shift, AltGr, AltGr+Shift, Caps Lock, Caps Lock+Shift, Left Alt, Ctrl and Win: one key can carry nine values.
Tweakeys emulates an entire keyboard in software: it intercepts each keystroke, resolves it in its own state machine, then injects the result. Layers, sublayers, hold-tap and combos, on any keyboard.
Engine on standby: it loads when you click in the box.
The engine
A classic layout is declared to the operating system and inherits its limits. Tweakeys, written in Rust, takes the keystroke before the system does and decides for itself what it produces.
Example: a key struck in Optimot's Greek sublayer.
The engine captures the physical keystroke before the system.
It resolves it with its own state: modifiers, layer, sublayer, Caps Lock, time windows.
It sends the result: Unicode character, special key or shortcut.
| Native layout | Tweakeys | |
|---|---|---|
| Levels | Few levels (Shift, AltGr…) | 9 layers BaseShiftAltGrAltGr+ShiftCaps LockCaps Lock+ShiftLeft AltCtrlWin |
| Dead keys | On a single level | Chainable sublayers, 4 levels each acute → acute+tilde → ṍ |
| Contextual behavior | None | Combos (keys pressed together, ~70 ms window) and hold-tap tap-preferred · hold-preferred · balanced |
| Remapping | Fixed | Physical mappings Caps Lock → Shift |
| Rare characters | Hard to reach | Direct Unicode injection, arbitrary ligatures |
Features
Hold-tap, combos and mappings are usually reserved for programmable mechanical keyboards. Tweakeys brings them in software, to a standard keyboard.
Base, Shift, AltGr, AltGr+Shift, Caps Lock, Caps Lock+Shift, Left Alt, Ctrl and Win: one key can carry nine values.
A dead key opens a sublayer, which can open another: acute, then tilde, then o gives ṍ. Each sublayer has 4 levels.
Tapped, the key types a letter; held, it becomes a modifier.
Hold the key to try it.
tap-preferred · hold-preferred · balanced
Two keys pressed within about 70 ms produce a third output. Outside the window, each keeps its own value.
One physical key replaces another before any resolution. Caps Lock becomes a second Shift, without touching the system.
A key injects any Unicode character, or an entire string. No more codes to memorize for rare characters.
The studio
The studio loads a configuration, draws it on your real keyboard and lets you inspect every key and every layer. Everything runs in the browser.
Geometries
Physical shapes read from their original KLE files, orthos and splits included.
Use your layout
Native drivers reproduce the layout and dead keys, but not the state machine's behaviors. Choose based on what your layout uses.
A resident program reads your config.json and applies the whole state machine. Windows and Linux (X11).
Classic system install, no resident software. The studio warns you about everything that will be lost.
Microsoft Keyboard Layout Creator.
No hold-tap, combos or mappings.
Standalone AutoHotKey script.
No hold-tap, combos or mappings.
X Keyboard Extension.
No hold-tap, combos or mappings.
Compose sequences.
No hold-tap, combos or mappings.
Apple XML format.
No hold-tap, combos or mappings.
Download
The engine is available for Windows and Linux (X11).
Native client, icon in the notification area, exclusion by application or window title.
Client for X11 sessions.
macOS: no engine, export a .keylayout file from the studio.
A single source of truth
The studio writes this file for you; you can also edit it by hand. Real excerpts from Optimot, used as an example.
"rcindex": {
"Backquote": 1,
"Digit1": 2,
"Digit2": 3,
"Digit3": 4,
"Digit4": 5,
…
}Questions
Open the studio to build and test it, then install the engine or export a native driver.