_ _
| | _____ _ _| |__ _ __
| |/ / _ \ | | | '_ \| '__|
| < __/ |_| | |_) | |
|_|\_\___|\__, |_.__/|_|
|___/
practice the keys that slow you down
Adaptive TUI typing trainer in Rust, bringing keybr.com's algorithm to your terminal. Offline touch-typing practice that imports your keybr.com data export.
keybr-tui times every key you press, finds the ones that slow you down, and builds lessons around them. Already practicing on keybr.com? Bring your keybr.com history and continue where you left off.
curl -sSf https://y0sif.github.io/keybr-tui/install.sh | shThe script installs the latest release on Linux (x86_64) and macOS (Intel and Apple Silicon), into /usr/local/bin when it is writable and ~/.local/bin otherwise. On Windows, use Cargo or the prebuilt zip below.
Other ways to install: Cargo, prebuilt binaries, Nix, from source
Cargo: cargo install keybr-tui --locked
Prebuilt binaries: every release has archives for Linux x86_64, macOS (Intel and Apple Silicon) and Windows x86_64 (.zip). Extract one and run keybr-tui.
Nix: nix run github:y0sif/keybr-tui, or nix profile install github:y0sif/keybr-tui to keep it.
From source: clone the repository, then run cargo install --path . --locked inside it.
A specific version: put KEYBR_TUI_VERSION with a tag from the releases page before sh:
curl -sSf https://y0sif.github.io/keybr-tui/install.sh | KEYBR_TUI_VERSION=vX.Y.Z shkeybr-tui keeps a per-key model of your speed an 8000 d accuracy and uses it to decide what you practice next.
- Start small. You begin with six letters, not the whole keyboard.
- Earn the rest. A new letter unlocks once every letter you have reaches your target speed.
- Drill the weak spot. Your slowest letter becomes the focus key and appears in every word. You can pin a letter yourself, or in English a combination drill such as
cror-tion, in Settings. - Practice real words. Lessons use real words of your language that fit your letters, with pronounceable pseudo-words from keybr.com's phonetic model filling in when too few fit.
- Learn from each lesson. When a lesson ends, each key's average time in it updates that key's smoothed speed, the same calculation keybr.com runs.
keybr-tui runs keybr.com's adaptive lessons and progress tracking in your terminal.
| Feature | What you get |
|---|---|
| keybr.com import | Your unlocked letters and key speeds from a keybr.com data export |
| 27 languages | keybr.com's word list, phonetic model and letter order for each |
| Live dashboard | Last lesson's speed and accuracy, a per-key heatmap and a daily goal above the text |
| Progress screen | Speed, best, attempts, errors and status for every letter |
| Two error modes | Forgive mistakes and keep moving, or stop until you correct them |
| Local and offline | No account, no network, stats saved as plain local files |
Run keybr-tui to start practicing; every flag below is optional.
keybr-tui [OPTIONS]| Flag | Description |
|---|---|
--target-wpm <N> |
Target typing speed in words per minute (default: 35) |
--error-mode <MODE> |
stop-on-error (or stop) holds the cursor on a mistake; move-on forgives it |
--reset |
Delete the practice language's saved stats and start fresh |
--data-dir |
Print the folder your stats are saved in and exit |
--import <FILE> |
Import a keybr.com data export and exit (see below) |
--force |
With --import, replace existing stats |
--layout <LAYOUT> |
With --import, the keybr.com layout family to import (see below) |
--language <CODE> |
Practice language: a code from Languages (default: en) or the language's name; saved to the config |
--help |
Show help |
--version |
Show version |
| Screen | Keys |
|---|---|
| Menu | Up/Down move, Enter selects, q or Esc quits |
| Typing | Esc returns to the menu, Tab switches the error mode, Backspace steps back one character and clears its mistake |
| Progress | Up/Down, PageUp/PageDown and Home/End scroll; Esc returns to the menu |
| Settings | Up/Down pick a row, Left/Right change it; Esc returns to the menu |
Ctrl+C quits from any screen. A finished lesson rolls straight into the next one.
keybr-tui imports a keybr.com data export and continues from the same learning state. On keybr.com, open your profile and click Download data to get typing-data.json, then run:
keybr-tui --import typing-data.jsonThe import replays your sessions the way keybr.com does, so your unlocked letters, key speeds and focus letter match the website. It takes the sessions of your practice language (--language picks another) in one layout family, by default the family of your latest session.
--layout colemakimports another family, and--layout allmerges every family into one set of key stats.- The export does not record your target speed. If yours on keybr.com differs from the one in your config, pass it with
--target-wpm <N>, since unlocks depend on it. - Existing stats are kept unless you pass
--force, which saves a.bakcopy first. - English (UK) and Croatian cannot be imported: keybr.com records their sessions under another language's layouts.
Switch the practice language with the Language row in Settings, or at launch with --language fr (a name such as français works too). Each language keeps its own stats, and keybr-tui remembers your choice.
| Code | Language | Code | Language | Code | Language |
|---|---|---|---|---|---|
en |
English | fi |
Finnish (Suomi) | nl |
Dutch (Nederlands) |
en-gb |
English (UK) | fr |
French (Français) | pl |
Polish (Polski) |
be |
Belarusian (Беларуская) | hr |
Croatian (Hrvatski) | pt |
Portuguese (Português) |
cs |
Czech (Čeština) | hu |
Hungarian (Magyar) | ro |
Romanian (Română) |
da |
Danish (Dansk) | hy |
Armenian (Հայերեն) | ru |
Russian (Русский) |
de |
German (Deutsch) | it |
Italian (Italiano) | sl |
Slovenian (Slovenščina) |
el |
Greek (Ελληνικά) | lt |
Lithuanian (Lietuvių) | sv |
Swedish (Svenska) |
es |
Spanish (Español) | lv |
Latvian (Latviešu) | tr |
Turkish (Türkçe) |
et |
Estonian (Eesti) | nb |
Norwegian Bokmål (Norsk bokmål) | uk |
Ukrainian (Українська) |
keybr-tui needs no configuration: change settings on the Settings screen (main menu, Settings). Settings live in config.toml, which also holds a few options the screen does not show, such as the daily goal: see docs/configuration.md.
- docs/configuration.md: every setting and
config.tomlkey - docs/comparison.md: how keybr-tui compares to other typing trainers
- docs/faq.md: frequently asked questions
- docs/troubleshooting.md: common issues and fixes
- CONTRIBUTING.md: building from source and the contribution workflow
keybr-tui ports the learning algorithm of keybr.com by aradzie and ships its phonetic models, word lists and keyboard layout table. See data/README.md for where each file comes from. Built with ratatui and crossterm.
Copyright (C) 2026 keybr-tui contributors. keybr-tui is licensed under the GNU Affero General Public License v3.0 only because it includes and adapts AGPLv3 material from keybr.com. See NOTICE for third-party notices.