/usr/bin/jp2a

jp2a 1.3.3
Copyright 2006-2016 Christian Stigen Larsen
and 2020-2024 Christoph Raitzig
Distributed under the GNU General Public License (GPL) v2.

Usage: jp2a [ options ] [ file(s) | URL(s) ]

Convert files or URLs from JPEG/PNG/WebP format to ASCII.

OPTIONS
  -                 Read images from standard input.
      --blue=N.N    Set RGB to grayscale conversion weight, default is 0.1145
  -b, --border      Print a border around the output image.
      --chars=...   Select character palette used to paint the image.
                    Leftmost character corresponds to black pixel, right-
                    most to white.  Minimum two characters must be specified.
      --clear       Clears screen before drawing each output image.
      --colors      Use true colors or, if true color is not supported, ANSI
                    in output.
      --color-depth=N   Use a specific color-depth for terminal output. Valid
                        values are: 4 (for ANSI), 8 (for 256 color palette)
                        and 24 (for truecolor or 24-bit color).
  -d, --debug       Print additional debug information.
      --edge-threshold=N.N   Image gradient above which to shade lines and edges with directional glyphs (such as -/|\).
      --edges-only  Only draw edges - make sure you use it with the edge-threshold option so edges are drawn.
      --fill        When used with --color and/or --htmlls or --xhtml, color
                    each character's background.
  -x, --flipx       Flip image in X direction.
  -y, --flipy       Flip image in Y direction.
  -f, --term-fit    Use the largest image dimension that fits in your terminal
                    display with correct aspect ratio.
      --term-height Use terminal display height.
      --term-width  Use terminal display width.
  -z, --term-zoom   Use terminal display dimension for output.
  -c, --term-center Center image in terminal.
      --grayscale   Convert image to grayscale when using --htmlls or --xhtml
                    or --colors
      --green=N.N   Set RGB to grayscale conversion weight, default is 0.5866
      --height=N    Set output height, calculate width from aspect ratio.
  -h, --help        Print program help.
      --htmlls      Produce HTML (Living Standard) output.
      --html        Produce strict XHTML 1.0 output (will produce HTML output
                    from version 2.0.0 onward).
      --xhtml       Produce strict XHTML 1.0 output.
      --html-fill   Same as --fill (will be phased out).
      --html-fontsize=N   Set fontsize to N pt, default is 4.
      --html-no-bold      Do not use bold characters with HTML output
      --html-raw    Output raw HTML codes, i.e. without the <head> section etc.
                    (Will use <br> for version 2.0.0 and above.)
      --html-title=...  Set HTML output title
  -i, --invert      Invert output image.  Use if your display has a dark
                    background.
      --background=dark   These are just mnemonics whether to use --invert
      --background=light  or not.  If your console has light characters on
                    a dark background, use --background=dark.
      --output=...  Write output to file.
      --red=N.N     Set RGB to grayscale conversion weight, default 0.2989f.
      --size=WxH    Set output width and height.
  -v, --verbose     Verbose output.
  -V, --version     Print program version.
      --width=N     Set output width, calculate height from ratio.

  The default mode is `jp2a --term-fit --background=dark'.
  See the man-page for jp2a for more detailed help text.

Project homepage on https://github.com/Talinx/jp2a
Report bugs to <chris-r@posteo.net>