tooters 0.0.5

A Rust TUI Mastodon App
Documentation 
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
56
57
58
59
60
61

# TOOTERS RENAMED TO TOOT-RS as of 0.0.5

See https://crates.io/crates/toot-rs

There will be no further releases of tooters.

Toot-rs (formerly known as tooters) is a Rust-based Terminal User Interface (TUI) Mastodon app that allows you to view multiple toots on the screen at once. The project was created as a means to learn Rust and scratch a personal itch - the desire to see multiple toots on the screen at once. See the awesome python based [toot](https://github.com/ihabunek/toot), for something more complete.

Visit our website at [toot.rs](https://toot.rs) for more information and updates.

[![asciicast](https://asciinema.org/a/576920.svg)](https://asciinema.org/a/576920)

## Known issues

- does not load second page of toots (yet)

## Features

- View multiple toots on the screen at once
- Rust-based TUI for a fast and efficient user experience
- Easy navigation and interaction with toots

## Installation

To install Toot-rs, you need to have Rust and Cargo installed on your system. If you don't have them installed, follow the instructions on the [official Rust website](https://www.rust-lang.org/tools/install).

Once Rust and Cargo are installed, you can install Toot-rs by running the following command:

```bash
cargo install toot-rs
```

## Usage

To start using Toot-rs, simply run the following command in your terminal:

```bash
toot-rs
```

You will be prompted to enter your Mastodon instance URL and login credentials. Once logged in, you can navigate and interact with toots using the keyboard shortcuts provided.

## Keyboard Shortcuts

- [x] `j` or `↓`: Move down
- [x] `k` or `↑`: Move up
- [ ] `h` or `←`: Move left (switch column)
- [ ] `l` or `→`: Move right (switch column)
- [ ] `n`: Compose a new toot
- [ ] `r`: Reply to the selected toot
- [ ] `b`: Boost the selected toot
- [ ] `f`: Favourite the selected toot
- [x] `q`: Quit

## Contributing

We welcome contributions to Toot-rs! If you'd like to contribute, please fork the repository, make your changes, and submit a pull request. If you find any bugs or have feature requests, please open an issue on the GitHub repository.

## License

Toot-rs is released under the MIT License. See the [LICENSE](LICENSE) file for more information.