gifgrep

gifgrep

热门

使用命令行/TUI搜索GIF提供商,下载结果,并提取静态帧或拼图。

38万Star
0Fork
更新于 2026/7/26
SKILL.md
readonly只读
name
gifgrep
description

使用命令行/TUI搜索GIF提供商,下载结果,并提取静态帧或拼图。

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
  • GIPHY_API_KEY 对于 --source giphy 是必需的
  • TENOR_API_KEY 可选(如果未设置,则使用Tenor演示密钥)

输出

  • --json 输出结果数组(idtitleurlpreview_urltagswidthheight
  • --format 用于管道友好的字段(例如 url

GIF资产管理

  • 在推荐或使用动画GIF URL之前,请验证其解析成功,具有 Content-Type: image/gif,并且实际上是动画(多帧或循环元数据;例如使用 fileidentify 或小脚本检查)。
  • 记录资产的归属/许可/来源URL。
  • 当需要本地资产时,不要热链接:将其下载/复制到项目中并引用本地文件。

环境调整

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