toipe

A trusty terminal typing tester.

Crates.io badge Lints and checks badge docs.rs badge

# Usage ## Install ### From GitHub Go to the [latest release](https://github.com/Samyak2/toipe/releases/latest), scroll down to "Assets" and download the correct file for your platform (`.zip` in case of Mac OS, `.tar.gz` in case of Linux). Unzip the file and run the `toipe` binary inside. ### From Cargo Alternatively, if you have the `cargo` tool (part of the Rust toolchain) installed on your system, you can use: ``` cargo install toipe ``` ## Run typing test toipe looks best on a nice terminal (such as Alacritty) with color and style support. If installed through GitHub, run the binary (found inside the zip/tar.gz file after extracting) directly: ``` ./toipe ``` If installed through `cargo`, use: ``` toipe ``` ## Keyboard shortcuts See `toipe --help` for a list of keyboard shortcuts (the list can also be found [here](https://github.com/Samyak2/toipe/blob/main/src/config.rs#L10)). ## Show less or more text To change the number of words shown in each test, use the `-n` flag (default: 30): ``` toipe -n 10 ``` ``` toipe -n 100 ``` ## Use a different word list By default, a list of top 250 English words (`top250`) is used and random words are selected from it. See `toipe -h` for a list of available built-in word lists. To use the OS provided word list instead, use: ``` toipe -w os ``` Note: the OS word list varies a lot from system to system and usually has more than 100,000 words. This can lead to difficult and esoteric words appearing in the test, reducing your typing speed. You can provide your own word list too (Note: the word list must meet [these assumptions](https://docs.rs/toipe/latest/toipe/textgen/struct.RawWordSelector.html#assumptions)): ``` toipe -f /path/to/word/list ``` ## Add punctuation to test By default, only lowercase words are shown. To add punctuation and sentence case, use the `-p` flag: ``` toipe -p ``` # Platform support - toipe was only tested on Linux and Mac OS. If you find any problems, please [open an issue](https://github.com/Samyak2/toipe/issues). - Windows is not supported yet. Follow [this issue](https://github.com/Samyak2/toipe/issues/14) for updates. It should work on WSL though. # License MIT