#tui #terminal #typing

app thokr

sleek typing tui with visualized results and historical logging

7 unstable releases (3 breaking)

0.4.1 Jun 13, 2022
0.4.0 May 30, 2022
0.3.0 May 2, 2022
0.2.0 Apr 29, 2022
0.0.1 Apr 25, 2022

#3 in #typing

Download history 17/week @ 2023-01-18 13/week @ 2023-01-25 13/week @ 2023-02-01 56/week @ 2023-02-08 43/week @ 2023-02-15 5/week @ 2023-02-22 11/week @ 2023-03-01 7/week @ 2023-03-08 9/week @ 2023-03-15 4/week @ 2023-03-22 12/week @ 2023-03-29 10/week @ 2023-04-05 15/week @ 2023-04-12 16/week @ 2023-04-19 4/week @ 2023-04-26 18/week @ 2023-05-03

56 downloads per month

MIT license

730 lines


✨ sleek typing tui with visualized results and historical logging

GitHub Build Workflow GitHub Deploy Workflow License Crate Version Github Stars



For detailed usage run thokr -h.

thokr 0.4.1
sleek typing tui with visualized results and historical logging

    thokr [OPTIONS]

    -f, --full-sentences <NUMBER_OF_SENTENCES>
            number of sentences to use in test

    -h, --help
            Print help information

    -l, --supported-language <SUPPORTED_LANGUAGE>
            language to pull words from [default: english] [possible values: english, english1k,

    -p, --prompt <PROMPT>
            custom prompt to use

    -s, --number-of-secs <NUMBER_OF_SECS>
            number of seconds to run test

    -V, --version
            Print version information

    -w, --number-of-words <NUMBER_OF_WORDS>
            number of words to use in test [default: 15]



$ cargo install thokr


$ docker run -it thatvegandev/thokr

Arch Linux

Install thokr-git from the AUR


For detailed usage run thokr -h.


command test contents
thokr 50 of the 200 most common english words
thokr -w 100 100 of the 200 most common English words
thokr -w 100 -l english1k 100 of the 1000 most common English words
thokr -w 10 -s 5 10 of the 200 most common English words (hard stop at 5 seconds)
thokr -p "$(cat foo.txt)" custom prompt with the output of cat foo.txt
thokr -f 4 4 grammatical sentences with full stops; overrides word settings

During a test you can press ← to start over or → to see a new prompt (assuming you didn't supply a custom one)

Supported Languages

The following languages are available by default:

name description
english 200 most common English words
english1k 1000 most common English words
english10k 10000 most common English words


Upon completion of a test, a row outlining your results is appended to the log.csv file found in the following platform-specific folders. This way you can easily track your progress over time.

platform value example
Linux $XDGCONFIG_HOME/_project_path or $HOME/.config/project_path /home/colby/.config/thokr
macOS $HOME/Library/Application Support/project_path /Users/Colby/Library/Application Support/thokr
Windows {FOLDERIDRoamingAppData}_project_path\config C:\Users\Colby\AppData\Roaming\thokr\config


  • ⚡️ Performance
    • Right now there are known performance issues surrounding the rendering of the tui at each tick interval and/or key press. Ideally each render uses the prior render as a base and only makes the necessary adjustments (possibly using StatefulWidget), but I haven't been able to figure that out yet.
  • 🔠 Multi-language support
    • I decided not to launch thokr with languages besides english because of some odd rendering issues I was experiencing when trying to input characters with accents. It's as though I'm not able to properly input the character in raw mode. I'd love to have that figure out before shipping other languages because I personally felt the experience was a bit jarring. I'll open an bug report for it with more details and replication steps -- would love more eyes on that problem!
  • 🧪 Tests
    • I've only written a small amount of tests at this point. I haven't sat down to really think through what tests look like when the output is dependent on the users terminal size, font size, etc. If you have any ideas for this please open up an issue and start the discussion!


All contributions are greatly appreciated.

If you have a suggestion that would make thokr better, please fork the repo and create a pull request. You can also simply open an issue and select Feature Request

  1. Fork the repo
  2. Create your feature branch (git checkout -b [your_username]/xyz)
  3. Commit your changes (git commit -m 'add some xyz')
  4. Rebase off main (git fetch --all && git rebase origin/main)
  5. Push to your branch (git push origin [your_username]/xyz)
  6. Fill out pull request template

See the open issues for a full list of proposed features (and known issues).


Distributed under the MIT License. See LICENSE.md for more information.


Check out these amazing projects that inspired thokr!


github twitter youtube


~300K SLoC