22770e6e88
Co-authored-by: Cameron Pfiffer <cameron@pfiffer.org> Co-authored-by: Caren Thomas <carenthomas@gmail.com> Co-authored-by: Charles Packer <packercharles@gmail.com> Co-authored-by: Sarah Wooders <sarahwooders@gmail.com>
1.8 KiB
1.8 KiB
name, description, homepage, metadata
| name | description | homepage | metadata | |||||||||||||||||||||||||||||||||||
|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|---|
| gifgrep | Search GIF providers with CLI/TUI, download results, and extract stills/sheets. | https://gifgrep.com |
|
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