Skip to content

Guillex387/cli-image

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

17 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

cli-image

A cli tool for preview images with ascii characters. Support colors, adjustable resolution, antialiasing and alpha channel.

Install

You can use the tool on linux and windows, see the release page.

But if you use it on windows and don't work well, install C++ tools for windows.

Captures

github_test plant_test cup_test

Supported Image Formats

Format Decoding
BMP Yes
Farbfeld Yes
GIF Yes
ICO Yes
JPEG Baseline and progressive
OpenEXR Rgb32F, Rgba32F (no dwa compression)
PNG All supported color types
QOI Yes
TGA Yes
TIFF Baseline(no fax support) + LZW + PackBits
WebP Yes

Development

The tool is completely written in Rust and I use the image library to decode the image formats.

Use

$ cli-image --help

A cli tool for preview images with ascii characters

Usage: cli-image [OPTIONS] <FILE>

Arguments:
  <FILE>  The file for preview

Options:
  -m, --max-size <MAX_SIZE>    The max size of the preview in the screen (nº of ascii pixels) [default: 100]
  -c, --color                  Preview image with color (default = false) Note: this feature is only to true color terminals
  -o, --omit-ascii-distortion  Omits the ascii distortion filter (default = false)
  -n, --not-antialiasing       Omits the antialiasing filter (default = false)
  -h, --help                   Print help
  -V, --version                Print version

License

cli-image Copyright (c) 2023 Guillex387. All rights reserved.

Licensed under the Apache-2.0 license.