gifgrep 是一个面向 GIF 素材检索与处理的命令行工具,提供 CLI 与 TUI 两种交互方式,可搜索 Tenor/Giphy 等 GIF 提供商,浏览、下载结果,并从 GIF 中提取静帧或帧网格图。
用途
- 搜索 GIF 提供商(Tenor/Giphy)。
- 在 TUI 中浏览搜索结果。
- 下载 GIF 结果。
- 从 GIF 中提取静帧(still)或帧网格图(sheet)。
主要能力
- 搜索:使用 gifgrep 加查询词进行搜索,例如 gifgrep cats --max 5。
- 输出格式:支持 --json 输出结果数组(包含 id、title、url、preview_url、tags、width、height),也支持 --format 输出便于管道处理的字段(如 url)。
- 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 网格图,可调整 --frames(帧数)、--cols(网格宽度)、--padding(间距)。
使用方式
- 快速开始示例: 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
- 提供商选择:--source auto|tenor|giphy。使用 --source giphy 需要 GIPHY_API_KEY;TENOR_API_KEY 可选,未设置时使用 Tenor 演示密钥。
- 环境变量调整:GIFGREP_SOFTWARE_ANIM=1 强制软件动画;GIFGREP_CELL_ASPECT=0.5 调整预览几何。
适用场景
- 快速检索并下载 GIF 用于分享或素材收集。
- 将 GIF 转换为静帧或帧网格图,便于快速审阅、写入文档、PR 或聊天。
限制
- --thumbs 静帧预览仅支持 Kitty/Ghostty 终端。
- 使用 Giphy 作为来源时必须提供 GIPHY_API_KEY。
- 其他平台、收费、价格等信息暂未提供。