home / media / gifgrep

gifgrep

101

GIF search CLI and terminal browser for finding Tenor or Giphy results, downloading them, and extracting PNG stills or sheets.

$brew install steipete/tap/gifgrep
Language
Go
Stars
101
Category
Media & Video
Agent
Ready
Agent Compatibility
JSON Output
Agent Skill
MCP Support
AI Analysis

gifgrep is a CLI for searching GIF providers from the terminal, either as pipeable search results or through an inline-preview TUI. It also includes local GIF utilities for downloading matches and turning GIFs into PNG stills or contact sheets.

What It Enables
  • Search Tenor or Giphy for reaction GIFs and emit URLs, markdown, TSV, or JSON for follow-on shell steps.
  • Download matches to ~/Downloads or browse them interactively with inline previews in supported terminals.
  • Extract a single PNG frame or build a contact sheet from a local GIF or remote GIF URL.
Agent Fit
  • Search commands are non-interactive, and --json returns stable fields such as id, title, url, preview_url, tags, width, and height.
  • It composes cleanly in media or publishing workflows, but the richer browsing path depends on a TTY with Kitty, Ghostty, or iTerm2 image support.
  • Best when an agent needs to fetch or transform GIF assets; it is a narrow media primitive, not a broad inspect-or-mutate system CLI.
Caveats
  • Giphy searches require GIPHY_API_KEY; otherwise auto falls back to Tenor and may use Tenor's public demo key.
  • Inline previews are terminal-dependent, and CLI thumbnails are still frames rather than full animation.