Skip to content

README.md

Latest commit

 

History

History
121 lines (88 loc) · 2.95 KB

README.md

File metadata and controls

121 lines (88 loc) · 2.95 KB

termitype

 ____  ____  ____  __  __  ____  ____  _  _  ____  ____          made by sawsent
(_  _)( ___)(  _ \(  \/  )(_  _)(_  _)( \/ )(  _ \( ___)
  )(   )__)  )   / )    (  _)(_   )(   \  /  )___/ )__)
 (__) (____)(_)\_)(_/\/\_)(____) (__)  (__) (__)  (____)

A clean, minimal, fully-terminal typing test — inspired by Monkeytype, built for people who love the terminal.

Termitype focuses on:

  • a refined terminal UI
  • extensibility through adapters (macOS, Linux, Windows/PowerShell)
  • portability with zero external frameworks
  • a simple, fast typing experience

Features

✔ Minimal, beautiful terminal UI

A clean interface built specifically for terminal environments.
Fully adjustable width and height via settings.

✔ Real-time typing test

  • Randomized words
  • Accurate cursor simulation
  • Inline mistake highlighting
  • Previous, current, and next words clearly spaced

✔ Settings screen with full-text search

Settings are now searchable: type to filter options instantly.

✔ End-of-run results screen

Shows:

  • WPM
  • Accuracy
  • Duration
  • A diff-style view comparing typed vs expected text

✔ Adapter-based architecture

All OS-specific terminal behavior (cursor movement, color support, input handling) is abstracted.
Termitype works equally well on:

  • macOS (Terminal, iTerm2) (implemented)
  • Linux (not implemented)
  • Windows Terminal / PowerShell (not implemented)

✔ Persistent run storage

Store:

  • WPM
  • accuracy
  • date/time
  • detailed statistics
  • settings used for the run

✔ Stats dashboard

A new analytics-driven screen:

  • WPM personal best
  • rolling averages
  • lifetime totals

Roadmap

🔜 Color schemes

Easy to change themes to customize the look.

Philosophy

Termitype is designed to be:

  • fast — instant, frictionless startup
  • portable — independent of terminal quirks, without frameworks
  • extensible — clean architecture, easy to add new screens
  • pleasant — polished UI details without complexity

Installation

pip install termitype

Usage

Just run the termitype command to open the app!

termitype

Screenshots

Typing screen

typing screen

Results screen

results screen

Settings screen (with search)

settings search

Profile dashboard

profile dashboard

License

Licensed under the Apache License 2.0.
See the LICENSE file for details.

❤️ Inspiration

  • Monkeytype — for setting the bar high.
  • The simplicity of terminal tools that “just work.”