gifgrep

Search Tenor or Giphy and download GIFs with frame sampling.

Updated May 8, 2026

Search Tags:#json output #frame extraction #gif search #tui browsing #gif download #provider api #image sheets

Ready to run

npx skills add https://github.com/freire19/Mythos --skill gifgrep-freire19

💬 Prompt for ChatGPT / Claude Chat▼

Please help me install this Agent Skill.
Skill: gifgrep
Source: https://github.com/freire19/Mythos/tree/main/skills/gifgrep
Command: npx skills add https://github.com/freire19/Mythos --skill gifgrep-freire19

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Finding the right GIFs across providers and turning them into usable still images or sheets is slow and manual, especially when you need previews or consistent outputs for sharing or documentation.

Core Features & Use Cases

Provider search + JSON/format output: Query Tenor or Giphy and pipe results using URL or JSON fields for downstream use.
TUI browsing with previews: Explore results in an interactive TUI and review thumbnails before committing to downloads.
Download and extract stills/sheets: Download GIFs to your filesystem and generate a still frame or a grid “sheet” of sampled frames for quick review and PR/docs.

Quick Start

Run gifgrep cats --download --max 1 --format url to fetch the top matching GIF and output its URL for immediate use.

Frequently Asked Questions about gifgrep

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

FAQPage Schema

How do I search Tenor or Giphy and return JSON output for automated workflows?▼

You can search Tenor or Giphy and return JSON output by querying the provider APIs and piping results using URL or JSON fields, enabling seamless integration into automated workflows.

What's the best way to extract still frames or sheet grids from downloaded GIFs?▼

Extract still frames or sheet grids from downloaded GIFs by downloading the files to your filesystem and applying frame sampling controls to generate deterministic previews for quick review.

Do I need an API key to use Giphy or Tenor provider search?▼

You need a GIPHY_API_KEY to use giphy provider search, while a TENOR_API_KEY is optional; both require a functioning gifgrep installation to query and preview animated media.

Can I preview GIF thumbnails in a terminal interface before downloading?▼

You can preview GIF thumbnails before downloading by using TUI browsing, an interactive mode that lets you explore search results and review thumbnails before committing to downloads.

How do I fetch a single GIF URL from the command line for immediate use?▼

Fetch a single GIF URL from the command line by running a search query with the download flag, max limit of one, and url format, outputting the top matching GIF's URL for immediate use.