gifgrep

• 您希望在不离开终端的情况下搜索 Tenor 或 Giphy，并将结果通过管道传递给其他工具。
• 您需要从 GIF 中提取单个静止帧或多帧联系表，以用于文档、PR 或聊天。
• 您更喜欢使用键盘驱动的 TUI 来浏览和选择 GIF，然后再进行下载。
• 您正在编写脚本或自动化 GIF 选择流程，需要结构化的 JSON 输出或适合管道操作的字段格式。

• 您需要从图形桌面应用程序而非终端搜索 GIF 提供商。
• 您的终端不支持内联图像渲染（Kitty/Ghostty），但预览对您的工作流程很重要 — --thumbs 标志在其他终端中无法使用。

运行 gifgrep <query> 即可搜索 Tenor 或 Giphy 并立即获取结果。使用 --format url 可输出纯 URL 以便管道传递，或使用 --json 获取包含 id、title、url、preview_url、tags、width 和 height 字段的结构化数组。

运行 gifgrep tui "query" 以打开完整的终端用户界面，用于交互式浏览、预览和选择 GIF。在 Kitty 和 Ghostty 终端中，可通过 --thumbs 标志启用内联静态预览功能。

添加 --download 参数可将 GIF 直接保存到 ~/Downloads。搭配 --reveal 参数使用，可在保存完成后立即在访达中打开最后下载的文件。

使用 gifgrep still ./clip.gif --at 1.5s -o still.png 从任意本地 GIF 中提取精确时间戳处的单帧图像。输出的 PNG 文件可直接嵌入文档或分享使用。

使用 gifgrep sheet ./clip.gif --frames 9 --cols 3 -o sheet.png 生成一个包含采样帧的单张 PNG 网格图。通过 --frames、--cols 和 --padding 参数调整输出效果——非常适合快速预览、PR 描述以及聊天预览图。

使用 --source auto|tenor|giphy 在不同提供商之间切换。Tenor 开箱即用，内置演示密钥；Giphy 需要提供 GIPHY_API_KEY。auto 模式会自动选择提供商。

运行 gifgrep sheet ./animation.gif --frames 9 --cols 3 -o sheet.png 可生成一个紧凑的帧网格图，并将其直接插入 PR 描述中，让审阅者无需嵌入完整动画文件即可快速获得视觉摘要。

将 gifgrep cats --format url | head -n 5 通过管道传入下游脚本或机器人，以编程方式获取匹配度最高的 GIF URL。配合 --json 和 jq 使用，可实现更精细的字段访问。

运行 gifgrep tui "office handshake" 以可视化方式浏览结果，然后按下按键即可下载所选 GIF——无需浏览器。

使用 gifgrep still ./clip.gif --at 2s -o frame.png 捕捉特定帧，可用于文档、幻灯片或社交媒体发布。