ttyping ⌨️
A minimal, monkeytype-inspired terminal typing test for English and Korean, built with Python and Textual.
ttyping provides a clean and focused typing practice environment directly in your terminal. It tracks speed (WPM) and accuracy, saving results locally for history viewing.
✨ Features
- Multi-language Support: Practice English (Qwerty, Dvorak, Colemak) and Korean (2-set, 3-set).
- Finger Practice: Target specific finger groups to improve muscle memory.
- Accuracy Focused: Optional target accuracy mode that restarts on mistakes.
- Local History: Keep track of your speed (WPM) and accuracy over time.
🚀 Installation
Install using uv (recommended):
uv tool install ttyping
🎮 Usage
Run the app without arguments to start English practice:
uvx ttyping
⌨️ Keybindings
| Key | Action |
|---|---|
| e, k, w, h, o, q | Main Menu shortcuts (English, Korean, Weak, History, Options, Quit) |
| Tab | Restart the test |
| Esc | Go back to previous menu |
| Ctrl+C | Quit the application |
| Space | Proceed to the next word |
| Enter | Select menu option or complete word |
🗺️ Changelog Highlights (v1.1.2 – v1.1.16)
All planned roadmap features have shipped:
Practice Modes
- ✅ Quote Mode: Full English/Korean quotes with real punctuation and capitalization.
- ✅ Zen Mode: Unlimited free typing — words stream in; end with
Ctrl+D. - ✅ Time Presets: Quick-select 15s / 30s / 60s / 120s from the Options menu.
- ✅ Daily Challenge: A date-seeded word set that changes once a day (
d).
Feedback & Statistics
- ✅ Live WPM Graph: Real-time speed curve rendered while typing.
- ✅ Consistency Score: Keystroke rhythm stability shown on results & history.
- ✅ Personal Bests: Record WPM per language with a "new personal best!" badge.
- ✅ Keyboard Heatmap: Layout map of cumulative error stats in Weakness Analysis.
UX & Customization
- ✅ Custom Themes: Five accent color presets persisted in config.
- ✅ Keypress Sound: Optional terminal bell on typing errors.
- ✅ History Export: Export results to CSV (
x) or JSON (j). - ✅ Configurable Keybindings: Alternative restart (F2) / back (F4) shortcuts.
Content
- ✅ More Code Languages: Go, C, TypeScript snippets.
- ✅ Remote Word Lists: Load practice text from an HTTP(S) URL (
--url). - ✅ Additional Languages: Japanese (romaji) word lists.
🛠️ Tech Stack
📄 License
Apache-2.0
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file ttyping-1.1.16.tar.gz.
File metadata
- Download URL: ttyping-1.1.16.tar.gz
- Upload date:
- Size: 470.4 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
41e4b7102be80f2ac44b506d36ef2635f6b79045bddb26d3e052d44b39a57ca8
|
|
| MD5 |
c62e9daed32b13e0e663966eead87191
|
|
| BLAKE2b-256 |
61854765afa7bddbfaace5a23c128031757e442d634d2e3d203815905bb9726e
|
Provenance
The following attestation bundles were made for ttyping-1.1.16.tar.gz:
Publisher:
pypi.yml on partrita/ttyping
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
ttyping-1.1.16.tar.gz -
Subject digest:
41e4b7102be80f2ac44b506d36ef2635f6b79045bddb26d3e052d44b39a57ca8 - Sigstore transparency entry: 2569650964
- Sigstore integration time:
-
Permalink:
partrita/ttyping@d7828d7bddbb693271164b56559259aba4d5ec65 -
Branch / Tag:
refs/tags/v1.1.2 - Owner: https://github.com/partrita
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
pypi.yml@d7828d7bddbb693271164b56559259aba4d5ec65 -
Trigger Event:
push
-
Statement type:
File details
Details for the file ttyping-1.1.16-py3-none-any.whl.
File metadata
- Download URL: ttyping-1.1.16-py3-none-any.whl
- Upload date:
- Size: 97.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
0ccd99afe6d71a70ea04bd593eba2258df4c665d7709862f1a2651943ed0a2a4
|
|
| MD5 |
e85790f1378234b549044dc9e18fa079
|
|
| BLAKE2b-256 |
a665c5032f099fe5ab3caa4427eb97d87f098f7950cf52085803f0d955a241e4
|
Provenance
The following attestation bundles were made for ttyping-1.1.16-py3-none-any.whl:
Publisher:
pypi.yml on partrita/ttyping
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
ttyping-1.1.16-py3-none-any.whl -
Subject digest:
0ccd99afe6d71a70ea04bd593eba2258df4c665d7709862f1a2651943ed0a2a4 - Sigstore transparency entry: 2569650970
- Sigstore integration time:
-
Permalink:
partrita/ttyping@d7828d7bddbb693271164b56559259aba4d5ec65 -
Branch / Tag:
refs/tags/v1.1.2 - Owner: https://github.com/partrita
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
pypi.yml@d7828d7bddbb693271164b56559259aba4d5ec65 -
Trigger Event:
push
-
Statement type:
