gifgrep

name	gifgrep
description	Search GIF providers (Tenor/Giphy) with CLI/TUI, download results, and extract stills or contact sheets for review and sharing.
license	Sustainable Use License 1.0
metadata	{"domain":"content-media","subdomain":"media-processing","tags":"gif, search, image, tenor, giphy, cli","author":"cpojer <[e-mail]>","lastUpdated":"12026-01-31","provenance":"ported"}

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

• --download saves to ~/Downloads
• --reveal shows 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_KEY required for --source giphy
• TENOR_API_KEY optional (Tenor demo key used if unset)

Output

• --json prints an array of results (id, title, url, preview_url, tags, width, height)
• --format for pipe-friendly fields (e.g., url)

Environment tweaks

• GIFGREP_SOFTWARE_ANIM=1 to force software animation
• GIFGREP_CELL_ASPECT=0.5 to tweak preview geometry