wordl 0.3.0

Terminal Wordle game. Web like with keyboard hints and slow reveal animations.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55

# wordl

`Terminal wordle`. Web like terminal wordle game with keyboard hints, slow reveal animations etc.

<p align="center">
  <img src="./logo.png" alt="Wordl - Web like Terminal Wordle">
</p>

![Status](https://github.com/palerdot/wordl-rs/actions/workflows/rust.yml/badge.svg)
![Crates.io Version](https://img.shields.io/crates/v/wordl)

> Terminal Wordle.

**WORDL** aims to provide web like `Wordle` experience in the terminal, mainly
- `Slow Reveal` letter colors after guessing.
- Keyboard Hints

<img src="./wordl.gif" alt="Wordl - Web like Terminal Wordle">

### Installation

Install from [Cargo](https://doc.rust-lang.org/cargo/getting-started/installation.html).

```
cargo install wordl
```

Precompiled binaries are available in [Latest Releases page](https://github.com/palerdot/wordl-rs/releases/latest). Please note, the precompiled binaries are **not signed**. For example, in `MacOS`, you have to manually allow running the binary in `Security & Privacy` settings.

### Update

Update installed binary with [cargo-update](https://github.com/nabijaczleweli/cargo-update) like

```
cargo install-update wordl
```

If you don't want to install `cargo-update`, you can manually uninstall and install the latest binary from cargo.

### About

Rules are pretty simple.
- Type your guess and press `enter`. Press `Backspace` to clear already typed letter.
- Press `Ctrl-N` to start a new wordle guess. Please note, this only works if the game is over. i.e. You have guessed correctly or you ran out of 6 attempts. 
- Press `Esc` or `Ctrl-C` to exit the game.

If the terminal window is too small, keyboard hints are not shown. Please make sure your terminal has minimum required height for the keyboard hints to be shown.

`wordl-rs` is built with [Rust Ratatui library](https://github.com/ratatui-org/ratatui).

#### Wordle Words list

Data for Wordle words are present as `.txt` files in [`/files`](./src/wordle/files) directory. The data was initially seeded from [here](https://gist.github.com/cfreshman/a7b776506c73284511034e63af1017ee) and [here](https://gist.github.com/cfreshman/d5fb56316158a1575898bba1eed3b5da). Right now, wordle words list is not synced. If you want any words to be added or removed, please submit a PR.