A terminal based typing test.




sudo curl -L -o /usr/local/bin/tt && sudo chmod +x /usr/local/bin/tt


sudo curl -L -o /usr/local/bin/tt && sudo chmod +x /usr/local/bin/tt


There is a windows binary but it is largely untested. Using WSL is strongly encouraged (or alternatively switching to a proper OS ;)).

From source

git clone
make && sudo make install


go get if you have $GOPATH/bin in your $PATH.

Best served on a terminal with truecolor and cursor shape support (e.g kitty, iterm)


By default 50 words from the top 1000 words in the English language are used to
constitute the test. Custom text can be supplied by piping arbitrary text to
the program. Each paragraph in the input is shown as a separate segment of the


  • Pressing escape at any point restarts the test.
  • C-c exits the test.


  • tt -n 10 produces a test consisting of 10 randomly drawn English words
  • tt -n 10 -g 5 produces a test consisting of 50 randomly drawn words in 5 groups of 10 words each.
  • tt -t 10 starts a timed test consisting of 50 words
  • tt -theme gruvbox Starts tt with the gruvbox theme

The default behaviour is equivalent to tt -n 50.

See -help for an exhaustive list of options.


Custom themes and word lists can be defined in ~/.tt/themes and ~/.tt/words
and used in conjunction with the -theme and -words flags. A list of
preloaded themes and word lists can be found in words/ and themes/ and are
accessible by default using the respective flags.


tt is designed to be easily scriptable and integrate nicely with
other *nix tools. With a little shell scripting most features the user can
conceive of should be possible to implement. Below are some simple examples of
what can be achieved.

  • shuf -n 40 /usr/share/dict/words|tt Produces a test consisting of 40 random words drawn from your system's dictionary.
  • curl|jq -r .content|tt Produces a test consisting of a random quote.
  • alias ttd='tt -csv >> ~/wpm.csv' Creates an alias called ttd which keeps a log of your progress in your home directory`.