gifgrep

使用 gifgrep 搜索 GIF 提供商（Tenor/Giphy），在 TUI 中浏览，下载结果，并提取静态帧或网格图。

GIF 抓取（gifgrep 工作流）(GIF-Grab – gifgrep workflow)

• 搜索 → 预览 → 下载 → 提取（静态帧/网格图）以便快速审查和分享。

快速开始 (Quick start)

• 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 + previews)

• TUI: gifgrep tui "query"
• 命令行静态预览 (CLI still previews): --thumbs（仅限 Kitty/Ghostty；静态帧）(Kitty/Ghostty only; still frame)

下载 + 显示 (Download + reveal)

• --download 保存到 ~/Downloads (saves to ~/Downloads)
• --reveal 在 Finder 中显示上次下载的文件 (shows the last download in Finder)

静态帧 + 网格图 (Stills + sheets)

• gifgrep still ./clip.gif --at 1.5s -o still.png
• gifgrep sheet ./clip.gif --frames 9 --cols 3 -o sheet.png
• 网格图 = 采样的帧组成的单个 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|giphy
• GIPHY_API_KEY 需要用于 --source giphy (required for --source giphy)
• TENOR_API_KEY 可选（如果未设置，则使用 Tenor 演示密钥）(optional – Tenor demo key used if unset)

输出 (Output)

• --json 打印结果数组（id、title、url、preview_url、tags、width、height）
• --format 用于管道友好型字段（例如 url）(for pipe-friendly fields – e.g., url)

环境调整 (Environment tweaks)

• GIFGREP_SOFTWARE_ANIM=1 强制使用软件动画 (to force software animation)
• GIFGREP_CELL_ASPECT=0.5 调整预览几何形状 (to tweak preview geometry)