gifgrep

• ターミナルを離れずにTenorやGiphyを検索し、結果を他のツールにパイプしたい場合。
• ドキュメント、PR、チャットで使用するために、GIFから静止フレーム1枚またはマルチフレームのコンタクトシートを取り出す必要がある場合。
• GIFを閲覧・選択してからダウンロードするために、キーボード操作のTUIを好む場合。
• 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をインタラクティブに閲覧・プレビュー・選択できるフルターミナルUIが開きます。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 URLをプログラム的に取得できます。より細かいフィールドアクセスには、--json を jq と組み合わせて使用してください。

gifgrep tui "office handshake" を実行すると、結果をビジュアルで閲覧でき、キーを押すだけで選んだGIFをダウンロードできます — ブラウザは不要です。

gifgrep still ./clip.gif --at 2s -o frame.png を使用して、ドキュメント、スライドデッキ、またはソーシャル投稿に使用する特定のフレームをキャプチャします。