gifgrep

gifgrep

• Search → preview → download → extract (still/sheet) for fast review and sharing.

• 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:

  gifgrep tui "query"

• CLI still previews:

  --thumbs

  (Kitty/Ghostty only; still frame)

• --download

  saves to

  ~/Downloads

• --reveal

  shows the last download in Finder

• 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).

• --source auto|tenor|giphy

• GIPHY_API_KEY

  required for

  --source giphy

• TENOR_API_KEY

  optional (Tenor demo key used if unset)

• --json

  prints an array of results (

  id

  ,

  title

  ,

  url

  ,

  preview_url

  ,

  tags

  ,

  width

  ,

  height

  )

• --format

  for pipe-friendly fields (e.g.,

  url

  )

• GIFGREP_SOFTWARE_ANIM=1

  to force software animation

• GIFGREP_CELL_ASPECT=0.5

  to tweak preview geometry