https://github.com/jtieri/nanashi
Browse 4chan from your terminal. A keyboard-driven imageboard client (rebuild in progress).
https://github.com/jtieri/nanashi
4chan imageboard ratatui rust terminal tui tui-app
Last synced: 26 days ago
JSON representation
Browse 4chan from your terminal. A keyboard-driven imageboard client (rebuild in progress).
- Host: GitHub
- URL: https://github.com/jtieri/nanashi
- Owner: jtieri
- License: mit
- Created: 2026-07-06T01:58:15.000Z (about 1 month ago)
- Default Branch: main
- Last Pushed: 2026-07-06T20:51:53.000Z (about 1 month ago)
- Last Synced: 2026-07-06T21:13:55.027Z (about 1 month ago)
- Topics: 4chan, imageboard, ratatui, rust, terminal, tui, tui-app
- Language: Rust
- Size: 8.54 MB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- Changelog: CHANGELOG.md
- Contributing: CONTRIBUTING.md
- License: LICENSE
- Roadmap: docs/ROADMAP.md
- Notice: NOTICE
Awesome Lists containing this project
README
# nanashi
nanashi is a terminal client for browsing 4chan. The name ๅ็กใ, "nameless",
is what anonymous posters were called on Japanese textboards.
nanashi is a fork of [tui-chan](https://github.com/tuqqu/tui-chan) that I'm rebuilding from the ground up.
It's early and rough, and plenty is going to move around while the rewrite lands,
so take anything here as a work in progress. The [roadmap](docs/ROADMAP.md) spells out where it's headed.
## Where it's going
The short version:
- vim-style navigation with remappable keybindings
- images and media drawn inline in the terminal (kitty graphics, with fallbacks
for terminals that can't manage it)
- feature parity with the 4chan website: catalog view, working quote links,
spoilers, archives, search, watching a thread for new replies, etc.
- saving media, and eventually posting
- other imageboards down the line, not only 4chan
## Installing
From crates.io:
```shell
cargo install nanashi
```
Or from source (you'll need [Rust](https://www.rust-lang.org/tools/install)):
```shell
git clone https://github.com/jtieri/nanashi.git
cd nanashi
cargo install --path .
```
Either way you get a `nanashi` binary in `~/.cargo/bin`. Run it with:
```shell
nanashi
```
To remove it later, `cargo uninstall nanashi`.
## Controls
Navigation is vim-style, and a count works in front of a motion, so `5j` moves
down five and `10G` jumps to the tenth item. Press `?` for the help bar.
| Action | Keys |
|---------------------------------|-------------------|
| Move down / up | `j` / `k` |
| Move between panes (back / in) | `h` / `l` |
| Jump to top / bottom | `gg` / `G` |
| Half page down / up | `Ctrl-d` / `Ctrl-u` |
| Next / previous page | `]` / `[` |
| Reload | `r` |
| Fullscreen the focused pane | `f` |
| Open thread/post in a browser | `o` |
| Open media in a browser | `O` |
| Copy thread/post url | `y` |
| Copy media url | `Y` |
| Toggle the help bar | `?` |
| Quit | `q` |
The bindings are built in for now. A config file to remap them is coming.
## Credits
nanashi started out as [tui-chan](https://github.com/tuqqu/tui-chan) by tuqqu.
See [NOTICE](NOTICE) for the attribution.
It isn't affiliated with 4chan. It just talks to the public API, so use it within
the site's rules.
## License
MIT, same as the original. See [LICENSE](LICENSE).