# Local file
% gat ./samples/sample.png
# By URL
% gat https://raw.githubusercontent.com/otiai10/gat/master/samples/sample.png
Platform
Terminal App
How it looks
iTerm2 inline images
iTerm2
Kitty
Ghostty
Sixel
WezTerm Windows Terminal
TrueColor
(any terminals)
Install
go install github.com/otiai10/gat@latest
Options
# Interactive deletion mode
gat -i [imagefile]
# then you'll see it and be asked if you wanna delete it.
# iTerm and Sixel
gat -S 0.5 [imagefile] # Scale of output image
# Only for cell grid mode
gat -c [imagefile] # Use cell grid mode
gat -H 20 [imagefile] # Rows of output
gat -W 40 [imagefile] # Cols of output
gat -b [imagefile] # Print border
gat -t="**" [imagefile] # Text to be printed for each cell
gat -debug [imagefile] # Dump available colors and color for each cell
As a library
import "github.com/otiai10/gat/render"
r := render.GetDefaultRenderer()
r.Render(os.Stdout, img)