/termage

(My first real Golang project) Browse images (including animated GIFs!) in the terminal

Primary LanguageGoMIT LicenseMIT

termage

GitHub go.mod Go version CI CodeQL Go Report Card codecov

GitHub all releases

Browse images in the terminal with support for animated GIFs 🎉

Examples

PNG image

Viewing a PNG image

Animated GIF

Viewing an 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