README
¶
cliimage
A terminal image viewer that renders images using Unicode block characters with ANSI colors.
Installation
go install github.com/0x0Dx/x/cliimage@main
Usage
cliimage -i image.png
Options
| Flag | Description |
|---|---|
-i, --input |
Input image file (required) |
-o, --output |
Output file (default: stdout) |
-w, --width |
Output width in characters |
-h, --height |
Output height in characters |
-t, --threshold |
Luminance threshold (0-255, default: 128) |
-p, --pixelation |
Pixelation mode: half, quarter, all |
-d, --dither |
Apply Floyd-Steinberg dithering |
-b, --noblock |
Use only half blocks |
-r, --invert |
Invert colors |
--scale |
Scale factor (default: 1) |
Examples
# Render image with default settings
cliimage -i photo.jpg
# Render with custom width
cliimage -i photo.jpg -w 100
# Use quarter blocks for higher resolution
cliimage -i photo.jpg -p quarter
# Apply dithering
cliimage -i photo.jpg -d
# Save to file
cliimage -i photo.jpg -o output.txt
Documentation
Source Files
Directories
¶
| Path | Synopsis |
|---|---|
|
internal
|
|
|
blocks
Package blocks provides block types for terminal image rendering.
|
Package blocks provides block types for terminal image rendering. |
|
config
Package config provides CLI configuration and cobra commands.
|
Package config provides CLI configuration and cobra commands. |
|
renderer
Package renderer provides image rendering for terminal output.
|
Package renderer provides image rendering for terminal output. |
Click to show internal directories.
Click to hide internal directories.