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

typo <path-to-file>

The crate is published as typocode, but the installed binary is typo, matching the original C version's command name.

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.

typo src/main.rs
typo README.md
typo ~/notes/algorithms.py

Stripping comments

Pass --no-comments (or -C) to remove comments before the run. The language is auto-detected from the file extension; files in unsupported languages pass through unchanged.

typo --no-comments src/main.rs
typo -C app.py

Both line and block comments are removed. Lines that contain only a comment disappear entirely, so the player never has to type through a hole left by a removed comment. String literals are respected, so a comment-looking marker inside a string is left alone.

Built-in languages: Rust, C, C++, Java, JavaScript, TypeScript, Go, Swift, Kotlin, Scala, C#, Dart, PHP, Python, Ruby, Bash, Fish, Elixir, R, Perl, Lua, Haskell, Elm, PureScript, SQL, HTML, XML, SVG, Markdown, Clojure, Common Lisp, Scheme, Racket, OCaml, F#, SML, Erlang, Julia, Nim, Crystal, Zig, Gleam.

Controls

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.