TermTypr

Practice your typing right in the terminal. Track your speed, see where you improve, and have fun doing it.

What it does

• Two game modes — random words or full phrases
• Live feedback — WPM and accuracy update as you type
• Stats & charts — see your history, personal bests, and trends over time
• Customizable — set the word count per game, switch themes, add your own words
• Runs anywhere — works on any terminal with Python 3.10+

Install and run

pip install termtypr
termtypr

That's it. The main menu lets you pick a game mode and start typing.

CLI commands

termtypr                        # Launch the app
termtypr stats                  # Quick stats from the command line
termtypr add-words word1 word2  # Add your own words to the pool
termtypr list-words             # See all available words

Development

Setup Development Environment

git clone https://github.com/SteMazzO/termtypr.git
cd termtypr
python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
pip install -e ".[dev]"

Run Tests

pytest tests/ -v

Contributing

Contributions are welcome — see CONTRIBUTING.md.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Acknowledgments

• Inspired by MiType, 10FastFingers, and TypeRacer
• Text samples from Typeracer Data
• Built with Textual by Textualize

Changelog

See CHANGELOG.md for version history and release notes.