Search GIF providers with CLI/TUI, download results, and extract stills/sheets.
Use gifgrep to search GIF providers (Tenor/Giphy), browse in a TUI, download results, and extract stills or sheets.
GIF-Grab (gifgrep workflow)
Quick start
gifgrep cats --max 5gifgrep cats --format url | head -n 5gifgrep search --json cats | jq '.[0].url'gifgrep tui "office handshake"gifgrep cats --download --max 1 --format urlTUI + previews
gifgrep tui "query"--thumbs (Kitty/Ghostty only; still frame)Download + reveal
--download saves to ~/Downloads--reveal shows the last download in FinderStills + sheets
gifgrep still ./clip.gif --at 1.5s -o still.pnggifgrep sheet ./clip.gif --frames 9 --cols 3 -o sheet.png--frames (count), --cols (grid width), --padding (spacing).Providers
--source auto|tenor|giphyGIPHY_API_KEY required for --source giphyTENOR_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 animationGIFGREP_CELL_ASPECT=0.5 to tweak preview geometry