# ttyper
[](https://crates.io/crates/ttyper)
[](https://github.com/max-niederman/ttyper)
[](https://github.com/max-niederman/ttyper/actions)
[](https://github.com/max-niederman/ttyper/issues)
[](./LICENSE.md)
Ttyper is a terminal-based typing test built with Rust and tui-rs.

## installation
With [Cargo](https://crates.io):
```bash
cargo install ttyper
```
## usage
For usage instructions, you can run `ttyper --help`.
### examples
| `ttyper` | 50 of the 200 most common english words |
| `ttyper -w 100` | 100 of the 200 most common English words |
| `ttyper -w 100 -l english1000` | 100 of the 1000 most common English words |
| `ttyper text.txt` | contents of `text.txt` split at whitespace |
## languages
The following languages are available by default:
- english100
- english200
- english1000
- c
- csharp
- go
- html
- java
- javascript
- python
- ruby
- rust
Additional languages can be added by creating a file in `TTYPER_CONFIG_DIR/language` with a word on each line. On Linux, the config directory is `$XDG_CONFIG_DIR/ttyper`; on Windows, it's `C:\Users\user\AppData\Roaming\ttyper`; and on macOS it's `$HOME/Library/Application Support/ttyper`.