Skip to content

ayushdeolasee/typist

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

3 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

typist

A terminal-based typing speed test, inspired by MonkeyType. Test your typing speed and accuracy without leaving the command line.

Features

  • Timed tests: 15, 30, 60, and 120 seconds
  • Real-time WPM and countdown timer
  • Character-level feedback (correct, incorrect, overflow)
  • MonkeyType-style dark theme
  • WPM-over-time graph on the results screen
  • Persistent test history saved to ~/.config/typist/history.json
  • history and stats subcommands to review past performance
  • Custom text file support via -f
  • Backspace across word boundaries

Installation

Prerequisites

macOS / Linux

git clone https://github.com/ayushdeolasee/typist
cd typist
./install.sh

Installs the binary to /usr/local/bin (macOS) or ~/.local/bin (Linux).

Windows

git clone https://github.com/ayushdeolasee/typist
cd typist
.\install.ps1

Installs the binary to %LOCALAPPDATA%\typist\ and adds it to your PATH.

Build manually

git clone https://github.com/ayushdeolasee/typist
cd typist
go build -o typist .
./typist

Usage

typist                   # 30-second test (default)
typist -t 15             # 15-second test
typist -t 60             # 60-second test
typist -t 120            # 120-second test
typist -f poem.txt       # Type from a custom text file
typist history           # View last 10 results
typist stats             # View all-time statistics
typist --help            # Show help

Valid durations: 15, 30, 60, 120.

Controls

During the test:

Key Action
Any character Start timer (on first press) and type
Space Advance to next word
Backspace Delete last character (can cross back into previous word)
Esc / Ctrl+C Quit

Results screen:

Key Action
Tab Restart with the same settings
q / Esc Exit

Keystrokes are ignored for a brief moment when the summary first appears, so trailing typing won't accidentally restart or close it.

Text size

Typist renders at your terminal's font size — a terminal app can't change the font itself. To make the words larger, zoom your terminal (⌘ + on macOS, Ctrl + on most Linux terminals) or raise the font size in your terminal's settings.

Running Tests

go test ./...

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors