The Perl Toolchain Summit needs more sponsors. If your company depends on Perl, please support this very important event.

NAME

img2term - Display images in your 256 color terminal (kinda)

SYNOPSIS

img2term [options] [file...]

 Options:
   --help|-h            brief help message
   --scale|-s           scale image by the given ratio
   --x_scale|-x         scale image to x 'pixels' wide
   --no_scale|-n        do not scale the image at all
   --utf8|-u            use utf8 half-blocks for pixels

Image data can be piped to STDIN in place of providing a file.

Images larger than the current terminal in columns will be automatically scaled to fit unless specified.

OPTIONS

--help|-h

Prints a brief help message and exits.

--scale|-s

Scales the provided image by the provided decimal ratio before printing. Superscedes --x_scale.

--x_scale|-x

Scales the provided image width to match the provided integer in 'pixels'. Scales the image height proportionally. Superscedes --no_scale.

--no_scale|-n

Disables automatic scaling of the provided image data.

--utf8|-u

Uses utf8 'half-block' characters to effectlivy double the resolution in the terminal. May not display properly and depends on the font used.

DESCRIPTION

img2term is a part of the Image::Term256Color distribution and acts as a thin wrapper around the module to display image data on 256 color terminals.

EXAMPLES

Display a classy octocat:

    curl http://octodex.github.com/images/class-act.jpg | img2term | less -R