Skip to content

Navigation Menu

Sign in
Appearance settings

Search code, repositories, users, issues, pull requests...

Provide feedback

We read every piece of feedback, and take your input very seriously.

Saved searches

Use saved searches to filter your results more quickly

Sign up
Appearance settings

danielgatis/imgcat

Repository files navigation

Imgcat

Go Report Card License MIT Go Doc Release

Display images and gifs in your terminal emulator.

Features

  • Animated GIF support
  • Accept media through stdin
  • Transparency

Installation

MacOS

brew install danielgatis/imgcat/imgcat

Linux

First, install snapcraft.

sudo snap install imgcat

Windows

First, install scoop.

scoop bucket add scoop-imgcat https://github.com/danielgatis/scoop-imgcat.git
scoop install scoop-imgcat/imgcat

Download binaries

Alternatively, you can download a pre-built binary here.

Build from source

First, install Go.

Next, fetch and build the binary.

go install github.com/danielgatis/imgcat@latest

or, if you use pre-1.17 Go version, use the go get command:

go get -u github.com/danielgatis/imgcat

Usage

Display a remote image

curl -s http://input.png | imgcat

Display a local image

imgcat path/to/image.png

Options

  • -h, -help: Show help message
  • -interpolation: Set interpolation method (default: lanczos)
    • nearest: Fastest resampling filter, no antialiasing.
    • lanczos: A high-quality resampling filter for photographic images yielding sharp results.
  • -silent: Hide Exit message (default: false).
  • -top-offset: Offset from the top of the terminal to start rendering the image (default 8)
  • -type: Image resize type. Options: fit, resize (default "fit")

Requirements

Your terminal emulator must be support true color and use a monospaced font that includes the lower half block unicode character (▄ U+2584).

License

Copyright (c) 2020-present Daniel Gatis

Licensed under MIT License

Buy me a coffee

Liked some of my work? Buy me a coffee (or more likely a beer)

Buy Me A Coffee

AltStyle によって変換されたページ (->オリジナル) /