toofan

A minimal, lightning-fast typing TUI
Practice with local word lists or real code snippets. No browser, no account, everything stays local.

---

Differences from upstream

• UTF-8 Input: For proper handling of non-ASCII symbol set (e.g. Cyrillic languages).
• Refactored Language Handling: Human and programming languages are now split into internal/lang/data/{human,programming}, instead of hard-coded difficulty there's now language and set properties.
• Monkeytype Wordsets: Added support for Monkeytype .json format.
• Runtime Wordset Loading: Wordsets can now be loaded from ~/.config/toofan/lang/<type>/<language> dynamically.
• Nix Flake: Try it with nix run github:beauloxe/toofan!

And some WIP/ideas:

• Finish dynamic calculations for tables in the profile page
• Add system theme (use terminal base16 colors)
• Move to JSON for state data? (sorry plain-text enjoyers)
• Fix duplicate words in typing tests (sometimes two identical words come one after another, e.g. expensive expensive)

Other features:

• Word count typing test mode
• Monkeytype-like sliding input line
• Ctrl-backspace to erase the whole word

AI Disclosure

Those changes were implemented using Codex CLI and GPT-5.4/5.5 on Medium thinking. I wanted to add new features for myself because I liked the project, but very little code was written by hand, so no guarantees on code safety, quality, etc.

Features

• Two Modes: Practice human-language word lists or real-world code snippets.
• Curated Lessons: Hand-written, topic-based code exercises across multiple languages.
• Dynamic Themes: Cycle between multiple aesthetic terminal themes (ctrl+t).
• Live Metrics: Real-time WPM speed and accuracy tracking.
• Error Review: See exactly which words you mistyped after every test.
• Ranks: Automated progression system based on your typing speed.
• Offline & Local: No browser, no account, zero telemetry.

Profile Dashboard

A personal overview of your typing speed history, personal bests across durations, and a daily activity map to keep you consistent. Press ctrl+p to open.

Installation (upstream-only)

⚠️ Note: Always take a backup (ctrl+s) before updating toofan.

curl (macOS & Linux)

curl -fsSL https://raw.githubusercontent.com/vyrx-dev/toofan/master/install.sh | sh

AUR

paru -S toofan-bin

Go

go install github.com/vyrx-dev/toofan@latest

Homebrew / Nix / Ubuntu / Fedora

Coming soon.

Build from Source

If you prefer building manually (requires Go):

git clone https://github.com/vyrx-dev/toofan.git
cd toofan
go build -o toofan .
mv toofan ~/.local/bin/

FAQ

How are stats calculated?

raw      = total_chars / 5 / elapsed_minutes
wpm      = (total_chars - uncorrected_errors) / 5 / elapsed_minutes
accuracy = (total_chars - all_mistakes) / total_chars × 100

• wpm - your net speed. Every 5 characters count as one "word". Uncorrected mistakes are subtracted.
• accuracy - counts every wrong keystroke, even if you corrected it with backspace.
• raw - your gross speed before any penalty.
• errors - press e on the results page to see exactly which words you mistyped.

How do I change word or code languages?

Press ctrl+l before starting a test. In words mode it shows available word-list languages. In code mode it shows available code-snippet languages.

Where are my files stored?

Everything lives in ~/.config/toofan/ as plain text files:

• config.txt : Your selected duration, mode, language, and theme
• results.txt : Every test result (date, wpm, accuracy, duration, mode/language/word set)
• pb.txt : Your personal bests per mode and duration
• lang/ : Optional runtime word lists and code snippets

Can I backup my data?

Yes. Press ctrl+s to save a backup and ctrl+r to restore from one. Backups are saved to ~/.config/toofan/backups/ and can be moved between machines.

How do I update toofan?

The update process depends on how you installed it:

curl (Quick Install): Just run the install command again. It will automatically download and replace the old binary.

curl -fsSL https://raw.githubusercontent.com/vyrx-dev/toofan/master/install.sh | sh

Go:

go install github.com/vyrx-dev/toofan@latest

AUR: Use your AUR helper to update the package:

paru -Syu toofan-bin

How do I uninstall Toofan?

If you installed via the curl Quick Install, simply delete the binary and the configuration folder:

rm ~/.local/bin/toofan
rm -rf ~/.config/toofan

(If you built it from source and moved it globally, run sudo rm /usr/local/bin/toofan instead).

Does it work offline?

Yes. Everything runs locally and is embedded in the binary. No internet needed.

Want more programming languages?

We're always looking to add more. If your favorite programming language isn't supported yet, open a PR with a few lesson files and we'll get it in. Check AGENTS.md for the file format.

Roadmap

• Curl script installation (macOS & Linux)
• Proper documentation for AI and contributors
• More language support (python, rust, c, typescript, etc.)
• Word set selection for word lists
• AUR, Homebrew, Nix packages
• Fix top pane alignment to match bottom panes in profile

Contributing

• New snippets : Drop a file in internal/lang/data/programming/<language>/ and rebuild
• New word lists : Add words.txt or a Monkeytype-style words.json with { "name": "...", "words": [...] }
• New code languages : Add a folder under internal/lang/data/programming/ with lesson files
• Runtime content : Put files under ~/.config/toofan/lang/human/<language>/ or ~/.config/toofan/lang/programming/<language>/
• New themes : One Go file with a color palette
• Bug fixes and UX improvements

If you're using an AI coding assistant, read AGENTS.md first.

Dependencies

• Bubble Tea : TUI framework
• Lipgloss : Terminal styling

---