TermTypr

A modern, well-architected Python terminal application for practicing and improving typing speed with real-time feedback and comprehensive statistics.

Features

• Interactive Typing Tests - Real-time WPM and accuracy tracking
• Rich Statistics - Detailed performance analytics with visual charts
• Multiple Themes - Light and dark visual themes
• Game Modes - Random words and phrase typing challenges
• Record Tracking - Personal best tracking with comparison
• Persistent History - All your typing sessions saved locally

Quick Start

Installation

pip install termtypr

Run

termtypr

CLI Commands

termtypr start              # Start the typing trainer
termtypr stats              # View statistics from command line
termtypr add-words word1    # Add custom words
termtypr list-words         # List 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  # On Windows: .venv\Scripts\activate
pip install -e ".[dev]"

Run Tests

pytest tests/ -v           # Run all tests
pytest --cov=termtypr tests/    # With coverage

Contributing

Contributions are welcome! Please read CONTRIBUTING.md for guidelines.

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.