---

name: gifgrep description: 通过CLI/TUI搜索GIF提供商，下载结果并提取静态帧/帧序列图。 homepage: https://gifgrep.com metadata: { “openclaw”: { “emoji”: “🧲”, “requires”: { “bins”: [“gifgrep”] }, “install”: [ { “id”: “brew”, “kind”: “brew”, “formula”: “steipete/tap/gifgrep”, “bins”: [“gifgrep”], “label”: “安装 gifgrep (brew)”, }, { “id”: “go”, “kind”: “go”, “module”: “github.com/steipete/gifgrep/cmd/gifgrep@latest”, “bins”: [“gifgrep”], “label”: “安装 gifgrep (go)”, }, ], }, }

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 需要 GIPHY_API_KEY
• TENOR_API_KEY 可选（如果未设置则使用Tenor演示密钥）

输出

• --json 打印结果数组（id, title, url, preview_url, tags, width, height）
• --format 用于管道友好的字段（例如，url）

环境调整

• GIFGREP_SOFTWARE_ANIM=1 强制使用软件动画
• GIFGREP_CELL_ASPECT=0.5 调整预览几何形状