# gat
Show a picture in the terminal. PNG, JPEG, PDF, SVG and Markdown.
Requires a terminal that speaks the Kitty graphics protocol: kitty, Ghostty,
WezTerm or Konsole.
## Use
```
gat photo.png # open the viewer
gat --print notes.md # draw it where the cursor is and exit
gat --probe # what detection saw of your terminal
```
`--print` also runs when stdout is not a terminal, so pipes and redirects work.
In the viewer:
```
hjkl or arrows pan
g G top, bottom
/ ? search forward, backward
n N next, previous match
} { next, previous heading
tab shift-tab next, previous file
+ - zoom (pictures)
0 reset the view (pictures)
q quit
```
gat draws markdown as a page rather than as styled terminal text: headings at
real sizes, tables, task lists, footnotes, callouts, and code blocks coloured
by language. Search still works, because the page keeps the text it was laid
out from.
## Install
```
cargo install gat
```
## Licence
MIT or Apache-2.0. The bundled Liberation Mono is under SIL OFL 1.1.