SuperAPI AI 工具集

gifgrep

通用与其它

查看项目

更新于 10-16 06:56

技能介绍

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。
  • 其他平台、收费、价格等信息暂未提供。