Skip to main content

A terminal-based typing test inspired by Monkeytype

Project description

๐Ÿ’ Terminal Monkeytype

A beautiful, minimal, and fast CLI typing test that runs entirely in your terminal โ€” inspired by Monkeytype.
Track your WPM, accuracy, and view your past results directly in the console.

terminal-monkeytype-demo


โœจ Features

  • โšก Real-time WPM and accuracy tracking
  • โฑ๏ธ Supports both Word Count and Timed modes
  • ๐Ÿง  Local leaderboard saved automatically
  • ๐ŸŽจ Beautiful interface
  • ๐Ÿ’ป Works on Windows, macOS, and Linux

๐Ÿงฉ Installation

From PyPI

pip install terminal-monkeytype

๐Ÿ“ Make sure your Python version is 3.8 or higher

Optional (Recommended on macOS/Linux)

If the command isnโ€™t found after install:

pipx install terminal-monkeytype
pipx ensurepath

Then restart your terminal

๐Ÿš€ Usage

Once installed, simply run:

terminal-monkeytype

๐Ÿงญ Choose your mode:

  • Words Mode โ€“ Test your speed on 25 / 50 / 100 words
  • Time Mode โ€“ Type for 15s / 30s / 60s / 120s

๐ŸŽฏ After completion:

Youโ€™ll see your WPM, accuracy, and mistakes along with a mini leaderboard of recent results

๐Ÿ“Š Example Output

โฑ 60.0s | โšก 72.5 WPM | ๐ŸŽฏ 96.3% | Mistakes: 4 โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€ Test Complete!

Mode: time WPM: 72.5 Acc: 96.3% Time: 60s โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€ Recent Results: 2025-10-07 72.5 96.3 180 2025-10-06 69.8 94.1 120 โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€โ”€ [r] Retry [m] Menu [q] Quit [g] Github

๐Ÿง‘โ€๐Ÿ’ป Author

Aaquib Ali
๐Ÿ’ผ GitHub
๐Ÿ“ง Reach out for suggestions or contributions!

โš–๏ธ License

This project is licensed under the MIT License โ€“ see the LICENSE file for details

โญ Support

If you like this project, consider giving it a โญ on GitHub โ€” it helps more people discover it!

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

terminal_monkeytype-0.1.1.tar.gz (8.6 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

terminal_monkeytype-0.1.1-py3-none-any.whl (8.4 kB view details)

Uploaded Python 3

File details

Details for the file terminal_monkeytype-0.1.1.tar.gz.

File metadata

  • Download URL: terminal_monkeytype-0.1.1.tar.gz
  • Upload date:
  • Size: 8.6 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.13.7

File hashes

Hashes for terminal_monkeytype-0.1.1.tar.gz
Algorithm Hash digest
SHA256 5eb8d156dc7de23f9b939c6389a21a8bbbedad6dd79ed2ea7d9d98b1a1da7174
MD5 c5d27a59f3365b6233551e0c013aaae7
BLAKE2b-256 3ff5f0fa122105f8593388b74b6fc6a6c58ed0c267ca874442d60275c96cbe70

See more details on using hashes here.

File details

Details for the file terminal_monkeytype-0.1.1-py3-none-any.whl.

File metadata

File hashes

Hashes for terminal_monkeytype-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 01e0fdd8b11008f3486cef8a57ba94250c3ff8359be96526e9464352e531df0d
MD5 1097b702c7c679c97d4509d7a3fb561d
BLAKE2b-256 7b970ae30550c75c3ceaafe862046aeba2af35823015e4e17cefd36a93c797c7

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page