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
- - INLINECODE1
- INLINECODE2
- INLINECODE3
- INLINECODE4
- INLINECODE5
TUI + previews
- - TUI: INLINECODE6
- CLI still previews:
--thumbs (Kitty/Ghostty only; still frame)
Download + reveal
- -
--download saves to INLINECODE9 - INLINECODE10 shows the last download in Finder
Stills + sheets
- - INLINECODE11
- INLINECODE12
- Sheets = single PNG grid of sampled frames (great for quick review, docs, PRs, chat).
- Tune:
--frames (count), --cols (grid width), --padding (spacing).
Providers
- - INLINECODE16
- INLINECODE17 required for INLINECODE18
- INLINECODE19 optional (Tenor demo key used if unset)
Output
- -
--json prints an array of results (id, title, url, preview_url, tags, width, height) - INLINECODE28 for pipe-friendly fields (e.g.,
url)
Environment tweaks
- -
GIFGREP_SOFTWARE_ANIM=1 to force software animation - INLINECODE31 to tweak preview geometry
gifgrep
使用 gifgrep 搜索 GIF 提供商（Tenor/Giphy），在 TUI 中浏览，下载结果，并提取静态帧或帧图。
GIF-Grab（gifgrep 工作流）
- - 搜索 → 预览 → 下载 → 提取（静态帧/帧图），便于快速查看和分享。
快速开始
- - gifgrep cats --max 5
- gifgrep cats --format url | head -n 5
- gifgrep search --json cats | jq .[0].url
- gifgrep tui office handshake
- gifgrep cats --download --max 1 --format url
TUI + 预览
- - TUI：gifgrep tui query
- CLI 静态帧预览：--thumbs（仅限 Kitty/Ghostty；静态帧）
下载 + 显示
- - --download 保存到 ~/Downloads
- --reveal 在 Finder 中显示最后下载的文件
静态帧 + 帧图
- - gifgrep still ./clip.gif --at 1.5s -o still.png
- gifgrep sheet ./clip.gif --frames 9 --cols 3 -o sheet.png
- 帧图 = 采样帧组成的单个 PNG 网格（非常适合快速查看、文档、PR、聊天）。
- 调整：--frames（数量）、--cols（网格宽度）、--padding（间距）。
提供商
- - --source auto|tenor|giphy
- --source giphy 需要 GIPHYAPIKEY
- TENORAPIKEY 可选（未设置时使用 Tenor 演示密钥）
输出
- - --json 输出结果数组（id、title、url、preview_url、tags、width、height）
- --format 用于管道友好的字段（例如 url）
环境调整
- - GIFGREPSOFTWAREANIM=1 强制使用软件动画
- GIFGREPCELLASPECT=0.5 调整预览几何比例
