Tweakeys Studio

Your keyboard, free of your system's limits

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.

grecBase layer › grec
¬`!1"2£3$4%5^6&7*8(9)0_-+=BackspaceTabQWERTYUIOP{[}]EnterCaps LockASDFGHJKL:;@'~#Shift|\ZXCVBNM<,>.?/ShiftCtrlWinAltAltGrWinMenuCtrl

Engine on standby: it loads when you click in the box.

  • 9 layers
  • 5 export formats
  • 100% in the browser
  • 15 geometries

The engine

A state machine between your fingers and the system

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.

01

Interception

The engine captures the physical keystroke before the system.

scancode
0x1B
position
25
02

State machine

It resolves it with its own state: modifiers, layer, sublayer, Caps Lock, time windows.

modifiers
none
sublayer
grec
window
none pending
03

Injection

It sends the result: Unicode character, special key or shortcut.

output
ζ
unicode
U+03B6
Native layout and Tweakeys compared
Native layoutTweakeys
LevelsFew levels (Shift, AltGr…)
9 layers
BaseShiftAltGrAltGr+ShiftCaps LockCaps Lock+ShiftLeft AltCtrlWin
Dead keysOn a single level
Chainable sublayers, 4 levels each
acute → acute+tilde → ṍ
Contextual behaviorNone
Combos (keys pressed together, ~70 ms window) and hold-tap
tap-preferred · hold-preferred · balanced
RemappingFixed
Physical mappings
Caps Lock → Shift
Rare charactersHard to reach
Direct Unicode injection, arbitrary ligatures

Features

QMK/ZMK keyboard features, on any keyboard

Hold-tap, combos and mappings are usually reserved for programmable mechanical keyboards. Tweakeys brings them in software, to a standard keyboard.

AltGr3 / 9œ

9 layers

Base, Shift, AltGr, AltGr+Shift, Caps Lock, Caps Lock+Shift, Left Alt, Ctrl and Win: one key can carry nine values.

´
acute
´~
acute + tilde
ṍ
final character

Chainable sublayers

A dead key opens a sublayer, which can open another: acute, then tilde, then o gives ṍ. Each sublayer has 4 levels.

0200 ms400
outputCtrl

Hold-tap

Tapped, the key types a letter; held, it becomes a modifier.

Hold the key to try it.

tap-preferred · hold-preferred · balanced

Esc
070 ms window140 ms

Combos

Two keys pressed within about 70 ms produce a third output. Outside the window, each keeps its own value.

Caps Lock
→ Shift

Mappings

One physical key replaces another before any resolution. Caps Lock becomes a second Shift, without touching the system.

qu⇒

Unicode and ligatures

A key injects any Unicode character, or an entire string. No more codes to memorize for rare characters.

The studio

Edit visually, without writing JSON

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.

Designed for desktop
  1. Open the studio

Geometries

Your real keyboard, not a generic one

Physical shapes read from their original KLE files, orthos and splits included.

All geometries →

Use your layout

Two ways to install it

Native drivers reproduce the layout and dead keys, but not the state machine's behaviors. Choose based on what your layout uses.

Tweakeys engine

full behavior

A resident program reads your config.json and applies the whole state machine. Windows and Linux (X11).

  • Layers and sublayersYes
  • Hold-tapYes
  • CombosYes
  • MappingsYes
  • Per-application exclusionYes
  • Resident softwareRequired
Download the engine

Exported native driver

layout + dead keys

Classic system install, no resident software. The studio warns you about everything that will be lost.

  • Layers and sublayersLayout and dead keys
  • Hold-tapNo
  • CombosNo
  • MappingsNo
  • Per-application exclusionNo
  • Resident softwareNone
Export from the studio

One config.json produces five files

KLCWindows
.klc

Microsoft Keyboard Layout Creator.

No hold-tap, combos or mappings.

AHKWindows
.ahk

Standalone AutoHotKey script.

No hold-tap, combos or mappings.

XKBLinux
.xkb

X Keyboard Extension.

No hold-tap, combos or mappings.

XComposeLinux
.compose

Compose sequences.

No hold-tap, combos or mappings.

KeylayoutmacOS
.keylayout

Apple XML format.

No hold-tap, combos or mappings.

Download

Install the engine

The engine is available for Windows and Linux (X11).

Windows

Native client, icon in the notification area, exclusion by application or window title.

version
coming soon
sha256
coming soon
requires
coming soon
  1. 01Download the installer.
  2. 02Launch Tweakeys: the icon appears in the notification area.
  3. 03Load your config.json, then set exclusions if needed.
Windows: coming soon

Linux (X11)

Client for X11 sessions.

version
coming soon
sha256
coming soon
requires
coming soon
  1. 01Download the archive.
  2. 02Launch the X11 client.
  3. 03Load your config.json.
Linux (X11): coming soon

macOS: no engine, export a .keylayout file from the studio.

A single source of truth

The whole layout fits in config.json

The studio writes this file for you; you can also edit it by hand. Real excerpts from Optimot, used as an example.

  • 01rcindex maps each physical scancode, written in hexadecimal, to a position number.
  • 02Positions start at 1: position 1 is the first value of every layer.
  • 03Keys missing from rcindex keep their native behavior.
Optimot · excerpt
"rcindex": {
  "Backquote": 1,
  "Digit1": 2,
  "Digit2": 3,
  "Digit3": 4,
  "Digit4": 5,
  …
}

Questions

Frequently asked questions

Your layout, key by key

Open the studio to build and test it, then install the engine or export a native driver.