Please enable JavaScript to view this site.

Purpose:Display image files in a terminal that supports SIXEL or iTerm2 inline images.

 

Format:IMGTTY [/I | /S] image ...

 

/I (iTerm2 image)

/S (SIXEL image)

 

image (image filename)

 

Usage:

 

IMGTTY writes a terminal image sequence to standard output. Use it in a terminal that supports the selected image protocol. If no format option is specified, IMGTTY uses SIXEL.

 

Because (at the time of this writing) ConHost does not support the SIXEL ANSI sequence, if TCC is running In a Take Command ConPTY tab, IMGTTY uses a TCExplorer-compatible transport for SIXEL images so that Take Command can display them. The emitted sequence is intended for terminal display; redirecting it writes Base64-encoded terminal control data rather than a conventional image file.

 

IMGTTY uses the Windows Imaging Component and supports image formats installed with Windows, including PNG, JPEG, BMP, GIF, TIFF, and WebP.

 

To display iTerm2 images, the TabPtyITermImages directive in the [TakeCommand] section TCMD.INI must be set to YES.

 

To display SIXEL images, the TabPtySIXELImages directive in the [TakeCommand] section TCMD.INI must be set to YES.

 

Example:

 

Display photo.png as a SIXEL image:

 

imgtty photo.png

 

Display photo.jpg with the iTerm2 inline-image protocol:

 

imgtty /i photo.jpg

 

Display two images as SIXEL output:

 

imgtty /s one.png two.jpg

 

Options:

 

/I

Generate an iTerm2 inline-image sequence. The original image file is Base64-encoded and sent to the terminal.

 

/S

Generate a SIXEL image sequence. This is the default.