gifgrep
Use gifgrep to search GIF providers (Tenor/Giphy), browse in a TUI, download results, and extract stills or sheets.
GIF-Grab (gifgrep workflow)
- •Search → preview → download → extract (still/sheet) for fast review and sharing.
Quick start
- •
gifgrep cats --max 5 - •
gifgrep cats --format url | head -n 5 - •
gifgrep search --json cats | jq '.[0].url' - •
gifgrep tui "office handshake" - •
gifgrep cats --download --max 1 --format url
TUI + previews
- •TUI:
gifgrep tui "query" - •CLI still previews:
--thumbs(Kitty/Ghostty only; still frame)
Download + reveal
- •
--downloadsaves to~/Downloads - •
--revealshows the last download in Finder
Stills + sheets
- •
gifgrep still ./clip.gif --at 1.5s -o still.png - •
gifgrep sheet ./clip.gif --frames 9 --cols 3 -o sheet.png - •Sheets = single PNG grid of sampled frames (great for quick review, docs, PRs, chat).
- •Tune:
--frames(count),--cols(grid width),--padding(spacing).
Providers
- •
--source auto|tenor|giphy - •
GIPHY_API_KEYrequired for--source giphy - •
TENOR_API_KEYoptional (Tenor demo key used if unset)
Output
- •
--jsonprints an array of results (id,title,url,preview_url,tags,width,height) - •
--formatfor pipe-friendly fields (e.g.,url)
Environment tweaks
- •
GIFGREP_SOFTWARE_ANIM=1to force software animation - •
GIFGREP_CELL_ASPECT=0.5to tweak preview geometry