用途:gifgrep 用于搜索 GIF 提供方(Tenor/Giphy),在 TUI 中浏览、下载结果,并提取静帧或帧网格图,适合快速查看与分享。
主要能力:支持搜索、预览、下载、提取的完整流程;可输出 JSON 或管道友好字段;支持 TUI 交互浏览;可生成单张 PNG 网格图(采样帧),便于评审、文档、PR 或聊天使用。
使用方式: 搜索:gifgrep cats --max 5 输出 URL:gifgrep cats --format url | head -n 5 JSON 查询:gifgrep search --json cats | jq '.[0].url' TUI:gifgrep tui "office handshake" 下载:gifgrep cats --download --max 1 --format url 静帧预览:--thumbs(仅 Kitty/Ghostty,显示静帧) 下载保存到 ~/Downloads,--reveal 在 Finder 中显示最近下载。 提取静帧:gifgrep still ./clip.gif --at 1.5s -o still.png 提取网格:gifgrep sheet ./clip.gif --frames 9 --cols 3 -o sheet.png 网格参数:--frames(数量)、--cols(网格宽度)、--padding(间距)。
提供方:--source auto|tenor|giphy;使用 giphy 需 GIPHY_API_KEY;Tenor 的 TENOR_API_KEY 可选,未设置时使用演示密钥。
输出:--json 打印结果数组(id、title、url、preview_url、tags、width、height);--format 输出可管道字段(如 url)。
环境变量:GIFGREP_SOFTWARE_ANIM=1 强制软件动画;GIFGREP_CELL_ASPECT=0.5 调整预览几何。
限制:静帧预览仅支持 Kitty/Ghostty;Giphy 需要 API 密钥;其余平台、收费与效果信息暂未提供。