mcpField
G
gifgrep

gifgrep

github.com/openclawCreative & media393.3k5.2k installsUpdated today
Repository

About gifgrep

gifgrep is a CLI for searching Tenor and Giphy, previewing results, and downloading GIFs or extracting stills and frame sheets. It serves people preparing GIF assets for review, sharing, or project use.

Key features

  1. 01Search Tenor and Giphy
  2. 02Browse results in a TUI
  3. 03Download GIF results
  4. 04Extract a still frame
  5. 05Create frame-sheet images
  6. 06JSON and field-formatted output

Use cases

  1. 01Find a GIF for a chat or project
  2. 02Review search results in a TUI
  3. 03Save a GIF for local use
  4. 04Create frame sheets for documentation or review

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/openclaw/openclaw --skill gifgrep

After installing, type/gifgrepin Claude Code to confirm it loaded.

Details

From the project README

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)

GIF asset hygiene

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

Environment tweaks

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

Comments

Markdown supported