/tpicview

View images and play gifs in the terminal

Primary LanguagePythonGNU General Public License v3.0GPL-3.0

tpicview is a simple tool for displaying images in a terminal using ANSI color codes and the ▀ character.

Supports two sample methods (average and point), GIF playback and an FPS override, and a thumbnail view.

Usage

usage: tpicview [-h] [-sc n] [-sp {average,point}] [-f n] [-hf] [-T]
                [file [file ...]]

View images and play gifs in the terminal.

positional arguments:
  file                  Image(s) to display

optional arguments:
  -h, --help            show this help message and exit
  -sc n, --scale n      Scale factor
  -sp {average,point}, --sample {average,point}
                        Sample method
  -f n, --fps n         Max FPS (for gifs)
  -hf, --hide-fps       Don't print FPS (for gifs)
  -T, --thumbnail       Thumbnail display of files

Requirements

Pillow>=5.2.0

Examples

Gif Playback in a terminal

Gif Playback

Original

Original

Average Sample

Average Sample

Point Sample

Point Sample