gifgrep

Search Tenor and Giphy GIFs, download matches, and extract stills or frame sheets.

Updated Mar 21, 2026
One-click install
npx skills add https://github.com/Polealpha/XINNIAN_PI --skill gifgrep-polealpha
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: gifgrep
Source: https://github.com/Polealpha/XINNIAN_PI/tree/main/app%20windows/vendor/openclaw-runtime/skills/gifgrep
Command: npx skills add https://github.com/Polealpha/XINNIAN_PI --skill gifgrep-polealpha

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires gifgrep.

What problem does it solve?

It eliminates the time-consuming process of searching across GIF providers, previewing candidates, downloading the right assets, and manually extracting still frames for quick review.

Core Features & Use Cases

  • TUI and CLI search: Browse GIF results in a terminal interface for fast visual selection.
  • Provider-backed downloads: Download matching GIFs from supported sources like Tenor and Giphy, with configurable API keys.
  • Stills and sheet extraction: Convert GIFs into single-frame stills or tiled “sheets” for documentation, sharing, or PR review (sampled frames arranged into a PNG grid).

Use case: You need a set of representative frames from several GIFs for a README update or a change review, so you search, download, and generate preview-friendly image assets in one flow.

Quick Start

Run gifgrep cats --download --max 1 --format url to search for GIFs matching “cats”, download the top result, and print its URL.

Frequently Asked Questions about gifgrep

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

FAQPage Schema
How do I extract still images or frame sheets from a GIF in the terminal?▼

You can extract still images or frame sheets from a GIF by using a terminal-based CLI to convert files into single-frame stills or tiled PNG grids for quick review and documentation.

What is the best way to search and download GIFs from Tenor or Giphy via command line?▼

The best way to search and download GIFs from Tenor or Giphy via command line is using a terminal interface that queries provider APIs, allowing you to browse results and download matching assets directly.

Do I need an API key to search for GIFs using a terminal UI?▼

Yes, you need an API key to search for GIFs using a terminal UI, as provider-backed downloads from sources like Tenor and Giphy require configurable API keys set via environment variables or command flags.

How do I generate a tiled PNG preview sheet from a downloaded GIF?▼

You generate a tiled PNG preview sheet from a downloaded GIF by applying post-download frame sampling, which arranges sampled frames into a grid for documentation or PR review.

Can I output GIF search results as JSON for scripting workflows?▼

Yes, you can output GIF search results as JSON for scripting workflows by running the search command with specific format flags, enabling integration into automated terminal-based discovery workflows.