gifgrep

Search GIF providers, download results, and extract stills or contact sheets.

Updated Mar 30, 2026
One-click install
npx skills add https://github.com/srgaba/open-claw --skill gifgrep-srgaba
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: gifgrep
Source: https://github.com/srgaba/open-claw/tree/main/project/skills/gifgrep
Command: npx skills add https://github.com/srgaba/open-claw --skill gifgrep-srgaba

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Finding, downloading, and reviewing GIFs from providers like Tenor and Giphy normally requires manual browsing and separate tools for frame extraction. This Skill wraps the gifgrep CLI/TUI so you can search, preview, download, and extract stills or frame sheets in one workflow. ## Core Features & Use Cases - GIF Search & TUI Browsing: Query Tenor or Giphy from the CLI or an interactive TUI, with JSON and pipe-friendly output formats. - Download & Reveal: Save selected GIFs to ~/Downloads and reveal them in Finder with a single flag. - Still & Sheet Extraction: Extract a single frame at a timestamp or generate a PNG grid of sampled frames for quick review in docs, PRs, or chat. - Use Case: You need a reaction GIF for a pull request. Search for it, download the top result, and generate a 9-frame contact sheet to confirm it loops well before sharing. ## Quick Start Use gifgrep to search for "office handshake" GIFs, download the top result, and extract a 9-frame sheet as a PNG.

Frequently Asked Questions about gifgrep

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search and download GIFs from the command line?

Run gifgrep with a query and the --download flag, for example gifgrep cats --download --max 1. Results are saved to ~/Downloads, and --reveal opens the last download in Finder.

How to extract a still frame from a GIF file?

Use gifgrep still with the --at flag to pick a timestamp, such as gifgrep still ./clip.gif --at 1.5s -o still.png. For an overview, gifgrep sheet generates a PNG grid of sampled frames with configurable --frames, --cols, and --padding.

Does gifgrep support both Tenor and Giphy?

Yes, select the provider with --source auto, tenor, or giphy. Giphy requires a GIPHY_API_KEY environment variable, while Tenor works with a demo key if TENOR_API_KEY is unset.

Can I get GIF search results as JSON for scripting?

Yes, use gifgrep search --json to print an array of results containing id, title, url, preview_url, tags, width, and height. The --format flag also outputs pipe-friendly single fields like url.

Why are gifgrep TUI previews not showing images?

Inline still previews via --thumbs only work in Kitty or Ghostty terminals. In other terminals, set GIFGREP_SOFTWARE_ANIM=1 to force software animation or adjust GIFGREP_CELL_ASPECT for preview geometry.