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.