Skills › Content & Creative › Image & AI media
gifgrep
Search GIF providers with CLI/TUI, download results, and extract stills/sheets.
The full skill
—
name: gifgrep
description: Search GIF providers with CLI/TUI, download results, and extract stills/sheets.
homepage: https://gifgrep.com
metadata:
{
"openclaw":
{
"emoji": "🧲",
"requires": { "bins": ["gifgrep"] },
"install":
[
{
"id": "brew",
"kind": "brew",
"formula": "steipete/tap/gifgrep",
"bins": ["gifgrep"],
"label": "Install gifgrep (brew)",
},
{
"id": "go",
"kind": "go",
"module": "github.com/steipete/gifgrep/cmd/gifgrep@latest",
"bins": ["gifgrep"],
"label": "Install gifgrep (go)",
},
],
},
}
—
# 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