talinx/jp2a

By talinx

Updated 10 days ago

Converts jpg/png/webp images to ASCII

Image
Developer Tools

669

jp2a

jp2a is a simple JPEG/PNG/WebP to ASCII converter.

The source is available at https://github.com/Talinx/jp2a.

These docker images are automatically generated from this repository.

Example

docker run -t --rm talinx/jp2a http://jp2a.sourceforge.net/jp2a.jpg
MMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM
MMMMMMKocoXMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMNOxlccloxXMMMMMMMMMMMMMMMMMMMMMMMMMMMMM
MMMMMX     XMMMMMMMMMMMMMMMMMMMMMMMMMMXc.          .dWMMMMMMMMMMMMMMMMMMMMMMMMMM
MMMMMWo...oWMMMMMMMMMMMMMMMMMMMMMMMMMMx              ;MMMMMMMMMMMMMMMMMMMMMMMMMM
MMMMMOoooooOMMMXooooodWKdlccld0WMMMMMMx ;xKWWNO.      OMMMMMMW0kdlccclokXMMMMMMM
MMMMM:     :MMMO      .         cXMMMMXNMMMMMMM0      0MMMMx.            .OMMMMM
MMMMM:     :MMMO       .;;.      .0MMMMMMMMMMMMx     ;MMMMM,  'cdkkx,      KMMMM
MMMMM:     :MMMO      XMMMM0.     .WMMMMMMMMMMK.    ,NMMMMMoxNMMMMWKd      kMMMM
MMMMM:     :MMMO      WMMMMMl      KMMMMMMMMWd     dWMMMMMMMMXkl,.         kMMMM
MMMMM:     :MMMO      WMMMMW,      NMMMMMMMk.    ,XMMMMMMMMx.    'o0X      kMMMM
MMMMM:     :MMMO      ckKKk'      dMMMMMMO.      ,,,,,,,XM0     .WMMK      xMNMM
MMMMM:     :MMMO                .xMMMMMO'               KMX      .;'         ;MM
MMMMM;     :MMMO      l,.   ..:kWMMMMWo.................XMMKc..  ..;dk'   .':kMM
MMMMX.     :MMMO      WMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM
MMW;       kMMMO      WMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM
MMMx     .OMMMMO      WMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM
MMMMx,:o0WMMMMMXccccclWMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM
MMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMMM

How to run

docker run -t --rm -e COLORTERM="$COLORTERM" -v "$(pwd)":/app talinx/jp2a [options] <filenames or URLs>

Local images

The simplest way to run jp2a is:

docker run -t --rm talinx/jp2a <URLs>

This only works with URLs and not files on your machine. In order to display images on your machine with jp2a, they have to be available inside the container. For example, to make all files in your working directory available inside the container:

docker run -t --rm -v "$(pwd)":/app talinx/jp2a [options] <filenames or URLs>

Color

jp2a can use different kinds of color codes when using --colors. jp2a decides which one to use based on the capabilities of your terminal. In order to let jp2a inside the container know what your terminal supports, set the COLORTERM environment variable, e.g.:

docker run -t --rm -e COLORTERM="$COLORTERM" -v "$(pwd)":/app talinx/jp2a --colors [options] <filenames or URLs>

Alternatively you can specify the color depth manually, e.g. for 24-bit truecolor:

docker run -t --rm -v "$(pwd)":/app talinx/jp2a --colors --color-depth=24 [options] <filenames or URLs>

Help

Use --help to see all options that jp2a supports:

docker run -t --rm talinx/jp2a --help

You can also consult a man page online, e.g. https://man.archlinux.org/man/jp2a.1.

Docker Pull Command

docker pull talinx/jp2a