img2ascii

A high-performance C++ tool that converts images to colorful ASCII art with various rendering options.

Build

git clone https://github.com/neox1de/img2ascii && cd img2ascii
mkdir build && cd build
cmake ..
make

Usage

./build/ascii-view-cpp <image-path> [OPTIONS]

Options

→ USAGE
  ./build/ascii-view-cpp <image-path> [OPTIONS]

→ POSITIONAL ARGUMENTS
  <image-path>              Path to input image file

→ DISPLAY OPTIONS
  --maxwidth <width>        Output width in characters
                              [default: auto-detect or 64]

  --maxheight <height>      Output height in characters
                              [default: auto-detect or 48]

  --ratio <ratio>           Character aspect ratio (height/width)
                              [default: 2]

→ RENDERING OPTIONS
  --threshold <value>       Edge detection sensitivity (0.0 - 4.0)
                              [default: 4 (disabled)]
                              Lower values = more edge detail

  --dense                   Use a denser ASCII set with dithering

→ EXAMPLES
  ./build/ascii-view-cpp photo.jpg
  ./build/ascii-view-cpp image.png --maxwidth 120 --threshold 2.5
  ./build/ascii-view-cpp art.jpg --dense --maxwidth 80 --maxheight 40