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

Features

• View images in terminal (supports most modern terminals)
• 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>
curl -sL "https://github.com/tech-thinker/eyez/releases/download/${TAG}/eyez-windows-amd64.exe" -o eyez.exe
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