eyez

README

eyez

Eyez is a powerful CLI tool that lets you view images directly inside your terminal — no GUI required.

It’s designed to work seamlessly with tools like fzf, pipes, and standard Unix workflows, making it perfect for developers who live in the terminal.

Supported Images

• PNG
• JPG
• BMP
• GIF
• WEBP
• SVG

Features

• View images in terminal (supports most modern terminals)
• Supported graphics - (UNICODE, ASCII, KITTY)
• Works beautifully with fzf preview
• Pipe-friendly — integrates into your CLI workflows
• Fast and lightweight
• Simple and minimal interface

Installation

Download and install executable binary from GitHub releases page.

Using homebrew

brew tap tech-thinker/tap
brew update
brew install eyez

Linux Installation

TAG=<tag-name>
curl -sL "https://github.com/tech-thinker/eyez/releases/download/${TAG}/eyez-linux-amd64" -o eyez
chmod +x eyez
sudo mv eyez /usr/bin

MacOS Installation

TAG=<tag-name>
curl -sL "https://github.com/tech-thinker/eyez/releases/download/${TAG}/eyez-darwin-amd64" -o eyez
chmod +x eyez
sudo mv eyez /usr/bin

Windows Installation

$TAG = "<tag-name>"
$url = "https://github.com/tech-thinker/eyez/releases/download/$TAG/eyez-windows-amd64.exe"
$output = "eyez.exe"
Invoke-WebRequest -Uri $url -OutFile $output
.\eyez.exe

Usage

• Preview images as default width (80 char)

eyez <image>

• Preview images as custom width

eyez --width <custom-width> <image>

• Preview images as default width (80 char) with Pipe

cat <image> | eyez
# Or
eyez < <image> | eyez
# Or
cat <image> | eyez --width <custom-width>

• Preview images as default width (80 char) with fzf

fzf --preview="eyez {}"

• Preview images as custom width with fzf

fzf --preview="eyez --width <custom-width> {}"

• See help

eyez --help

Options

Option	Description
-w, --width value	Set output width in characters (default: 80)
-g, --graphics	Rendering mode: unicode, ascii, kitty (default: unicode)
-a, --algo	Image scaling algorithm: catmull-rom, lanczos (default: catmull-rom)
-h, --help	Display help information and exit
-v, --version	Print version information and exit