Search GIF providers and extract stills or sheets with gifgrep

How to use

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

Tune: --frames (count), --cols (grid width), --padding (spacing).

--source auto|tenor|giphy

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

Install gifgrep either via Homebrew (gifgrep) or with go install from the module github.com/steipete/gifgrep/cmd/gifgrep@latest.

TUI: gifgrep tui "query"

CLI still previews: --thumbs (Kitty/Ghostty only; still frame)

Tune: --frames (count), --cols (grid width), --padding (spacing).

Before recommending or using an animated GIF URL, verify it resolves successfully, has Content-Type: image/gif, and is actually animated (multiple frames or loop metadata; e.g. inspect with file, identify, or a small script).

Record attribution/license/source URL alongside the asset.

Do not hotlink when a local asset is needed: download/copy it into the project and reference the local file.