
Gifgrep
- 8 installs
- 33 repo stars
- Updated April 26, 2026
- bighardperson/computer-science-skills-collection
gifgrep is a skill that searches GIF providers via CLI or TUI, downloads results, and extracts still frames or contact sheets.
About
gifgrep is a command-line and TUI tool that searches GIF providers such as Tenor and Giphy, downloads results, and extracts still frames or contact sheets. A developer uses it to find and prep GIF assets quickly for review, documentation, PRs, or chat. It supports JSON output and pipe-friendly fields for scripting.
- Search Tenor/Giphy, preview, and download GIFs from a CLI or TUI
- Extract a still frame or a multi-frame contact sheet from any GIF
- JSON and pipe-friendly output for scripting
Gifgrep by the numbers
- 8 all-time installs (skills.sh)
- Ranked #410 of 550 CLI & Terminal skills by installs in the Skillselion catalog
- Data as of Jul 30, 2026 (Skillselion catalog sync)
gifgrep capabilities & compatibility
Free CLI; GIPHY_API_KEY needed for Giphy, Tenor demo key used if TENOR_API_KEY unset
- Capabilities
- gif download · still extract
- Use cases
- image generation
- Platforms
- macOS
- Pricing
- Bring your own API key
What gifgrep says it does
Use `gifgrep` to search GIF providers (Tenor/Giphy), browse in a TUI, download results, and extract stills or sheets.
Sheets = single PNG grid of sampled frames (great for quick review, docs, PRs, chat).
npx skills add https://github.com/bighardperson/computer-science-skills-collection --skill gifgrepAdd your badge
Show developers this skill is listed on Skillselion. Paste this into your README.
| Installs | 8 |
|---|---|
| repo stars | ★ 33 |
| Last updated | April 26, 2026 |
| Repository | bighardperson/computer-science-skills-collection ↗ |
What it does
Search GIF providers from the terminal and extract stills or sheets to drop into docs, PRs, or chat.
Who is it for?
Grabbing GIFs and extracting stills or sheets from the terminal for docs and chat.
Skip if: Editing or generating original GIF animations.
When should I use this skill?
You need to search, download, or extract frames from GIFs on the command line.
What you get
GIFs are searched, downloaded, and reduced to shareable stills or sheets from one CLI.
- Downloaded GIFs
- Extracted still PNG
- Contact sheet PNG
By the numbers
- 9-frame contact sheet example (--frames 9 --cols 3)
Files
gifgrep
Use gifgrep to search GIF providers (Tenor/Giphy), browse in a TUI, download results, and extract stills or sheets.
GIF-Grab (gifgrep workflow)
- Search > preview > download > extract (still/sheet) for fast review and sharing.
Quick start
gifgrep cats --max 5gifgrep cats --format url | head -n 5gifgrep search --json cats | jq '.[0].url'gifgrep tui "office handshake"gifgrep cats --download --max 1 --format url
TUI + previews
- TUI:
gifgrep tui "query" - CLI still previews:
--thumbs(Kitty/Ghostty only; still frame)
Download + reveal
--downloadsaves to~/Downloads--revealshows the last download in Finder
Stills + sheets
gifgrep still ./clip.gif --at 1.5s -o still.pnggifgrep sheet ./clip.gif --frames 9 --cols 3 -o sheet.png- Sheets = single PNG grid of sampled frames (great for quick review, docs, PRs, chat).
- Tune:
--frames(count),--cols(grid width),--padding(spacing).
Providers
--source auto|tenor|giphyGIPHY_API_KEYrequired for--source giphyTENOR_API_KEYoptional (Tenor demo key used if unset)
Output
--jsonprints an array of results (id,title,url,preview_url,tags,width,height)--formatfor pipe-friendly fields (e.g.,url)
Environment tweaks
GIFGREP_SOFTWARE_ANIM=1to force software animationGIFGREP_CELL_ASPECT=0.5to tweak preview geometry
Related skills
FAQ
Which GIF providers does gifgrep support?
Tenor and Giphy, selectable with --source auto, tenor, or giphy.
Does gifgrep need API keys?
GIPHY_API_KEY is required for Giphy; TENOR_API_KEY is optional since a Tenor demo key is used if unset.