termage

Browse images in the terminal with support for animated GIFs 🎉

Examples

PNG image

Animated GIF

Installation

The following commands simplify installing from the latest release.

Linux/MacOS

curl https://raw.githubusercontent.com/spenserblack/termage/HEAD/install.sh | bash

PowerShell

Invoke-WebRequest "https://raw.githubusercontent.com/spenserblack/termage/HEAD/install.ps1" | Invoke-Expression

Usage

Help

termage --help

Browse all images in a directory

Starting from first image in directory

termage path/to/dir/

Starting from a specific image

termage path/to/dir/image

Browse a specific subset of images

termage path/to/image1 path/to/image2 # ...

Controls

• n: Next image
• N: Previous image
• z: Increase zoom by 10 percentiles
• Z: Decrease zoom by 10 percentiles
• f: Fit to screen
• h: Scroll left one pixel
• H: Scroll left 10%
• j: Scroll down one pixel
• J: Scroll down 10%
• k: Scroll up one pixel
• K: Scroll up 10%
• l: Scroll right one pixel
• L: Scroll right 10%
• Esc: Exit application

Supported Formats

• PNG
• JPEG
• GIF