typocode

Terminal typing game that uses source code as practice text. Loads any text file, paginates it to fit your terminal. Live timer and accuracy in the footer; end-of-run summary with your final time and accuracy.

Rust rewrite of the original C version TypoCode, built on Ratatui and crossterm for a faithful, resize- aware, cross-platform experience.

Install

cargo install typocode

Or from source:

git clone https://github.com/Gabriel-c0Nsp/TypoCode-rs

cd TypoCode-rs/typocode

cargo install --path .

Usage

typocode <path-to-file>

Any UTF-8 text file works. Source code is the intended use, the pagination and strict-match rules are designed to make typing through a real codebase feel natural.

typocode src/main.rs

typocode README.md

typocode ~/notes/algorithms.py

Controls

Key	Action
any char	Type the next character.
`Tab`	Restart the run.
`Esc`	Quit.

Features

Strict-match typing with a visible extras buffer.
Green / red / default colouring per character state.
Line-number gutter that tracks source lines (visual wraps don't bump the counter).
Adaptive pagination that reflows on resize.
Live mm:ss timer and rounded accuracy percentage.
Summary panel on completion showing final time + accuracy.
Tab to restart from the top with a clean slate.

Non-goals (for now)

Word-aware wrapping. Char wrap keeps layout predictable for code.
WPM / words-per-minute stat, accuracy and time are the headline metrics.

License

MIT. See LICENSE.