https://github.com/Samyak2/toipe
yet another typing test, but crab flavoured
https://github.com/Samyak2/toipe
hacktoberfest rust terminal tui typing typing-test
Last synced: 3 months ago
JSON representation
yet another typing test, but crab flavoured
- Host: GitHub
- URL: https://github.com/Samyak2/toipe
- Owner: Samyak2
- License: mit
- Created: 2022-01-10T13:27:48.000Z (over 3 years ago)
- Default Branch: main
- Last Pushed: 2024-06-10T16:09:00.000Z (10 months ago)
- Last Synced: 2025-01-16T17:21:55.448Z (3 months ago)
- Topics: hacktoberfest, rust, terminal, tui, typing, typing-test
- Language: Rust
- Homepage:
- Size: 1.37 MB
- Stars: 608
- Watchers: 5
- Forks: 32
- Open Issues: 24
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- awesome-useful-projects - <img src="https://icon.horse/icon/github.com" height="20px" align="center"/>/Samyak2/toipe - Typing test (Jump To / CLI/TUI Apps)
- awesome-useful-projects - <img src="https://icon.horse/icon/github.com" height="20px" align="center"/>/Samyak2/toipe - Typing test (CLI/TUI Apps / Other)
README
toipe
A trusty terminal typing tester.
# 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