termtypr 0.5.0

A Python CLI application for practicing and improving typing speed

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.