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.