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 可在儲存完成後立即在 Finder 中開啟最後下載的檔案。

使用 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 網址。搭配 --json 與 jq 使用，可存取更細粒度的欄位資料。

執行 gifgrep tui "office handshake" 以視覺化方式瀏覽結果，再按下按鍵下載所選的 GIF——無需開啟瀏覽器。

使用 gifgrep still ./clip.gif --at 2s -o frame.png 擷取特定幀，以便用於文件、簡報投影片或社群貼文。