3 unstable releases
Uses new Rust 2024
| 0.2.0 | Feb 14, 2026 |
|---|---|
| 0.1.1 | Feb 14, 2026 |
| 0.1.0 | Feb 14, 2026 |
#18 in #image-cli
110KB
174 lines
[RUST] ASCII IMAGE GENERATOR
a fast rust-based cli tool that converts images into ascii art and renders the result as an image.
Requirements
- rust (latest stable)
Installation
cargo install ascii-image
Usage
ascii-image --input [options]
Options
| option | short | description | default |
|---|---|---|---|
--input <input> |
-i |
input image file | - |
--output <output> |
-o |
output ascii file | ascii.png |
--step <step> |
-s |
pixel step size | 8 |
--font-size <font_size> |
-f |
font size | 15 |
--charset <charset> |
-c |
character set | simple |
--print-chars |
print to terminal | false | |
--greyscale |
greyscale mode | false | |
--help |
-h |
show help | - |
Charset Presets
| Preset | Characters |
|---|---|
| simple | @#%*+=-:. |
| numbers | 9876543210 |
| numbers_rev | 0123456789 |
| binary | 10 |
| binary_rev | 01 |
| letters_lower | mnhqdykz |
| letters_upper | MNHQDYKZ |
| symbols | $@B%8&WM#*oahkbdpqwmZO0QLCJUYXzcvunxrjft/|()1{}[]?-_+~<>i!lI;:,'\"^. |
| matrix | `01 |
| extended | @%#*+=-:. |
| ascii_dense | $@B%8&WM#*oahkbdpqwmZO0QLCJUYXzcvunxrjft |
Charset Examples
| Charset | Example |
|---|---|
simple |
|
numbers |
|
numbers_rev |
|
binary |
|
binary_rev |
|
letters_lower |
|
letters_upper |
|
matrix |
|
extended |
|
ascii_dense |
|
symbols |
Dependencies
~6.5MB
~121K SLoC