png-to-terminal
| Crates.io | png-to-terminal |
| lib.rs | png-to-terminal |
| version | 0.1.1 |
| created_at | 2026-01-01 22:46:08.775506+00 |
| updated_at | 2026-01-01 22:49:16.261347+00 |
| description | Render PNG images directly in the terminal using TrueColor |
| homepage | |
| repository | https://github.com/tuna4ll/png-to-terminal |
| max_upload_size | |
| id | 2017645 |
| size | 13,214 |
Tuna (tuna4ll)
documentation
README
# png-to-terminal
Render PNG images directly in the terminal using 24-bit TrueColor.
This tool draws real image pixels in the terminal using Unicode half-block characters (`▀`).
It is **not ASCII art**.
---
## Requirements
- A terminal with TrueColor (24-bit) support
- Windows Terminal
- WezTerm
- Kitty
- Alacritty
> Classic PowerShell console is **not supported**.
---
## Install
```bash
cargo install png-to-terminal
Usage
png-to-terminal image.png
Optional width:
png-to-terminal image.png 40
How it works
- Each terminal character represents two vertical pixels
- Foreground color = top pixel
- Background color = bottom pixel
- Uses ANSI TrueColor escape sequences
License
MIT