gifgrep

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 "クエリ"
• 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
• スプライトシート = サンプリングされたフレームを1枚のPNGグリッドにまとめたもの（クイックレビュー、ドキュメント、PR、チャットに最適）
• 調整: --frames（フレーム数）、--cols（グリッド幅）、--padding（余白）

プロバイダ

• --source auto|tenor|giphy
• GIPHY_API_KEY が必要（--source giphy の場合）
• TENOR_API_KEY は省略可（未設定の場合はTenorのデモキーを使用）

出力

• --json で結果の配列を出力（id, title, url, preview_url, tags, width, height）
• --format でパイプに適したフィールドを指定（例: url）

GIFアセットの健全性

• アニメーションGIFのURLを推奨・使用する前に、それが正常に解決され、Content-Type: image/gif であり、実際にアニメーションしている（複数フレームまたはループメタデータがある；例：file、identify、または小さなスクリプトで確認）ことを確認してください。
• アセットと共に帰属情報・ライセンス・ソースURLを記録してください。
• ローカルアセットが必要な場合はホットリンクせず、プロジェクトにダウンロード/コピーし、ローカルファイルを参照してください。

環境設定

• GIFGREP_SOFTWARE_ANIM=1 でソフトウェアアニメーションを強制
• GIFGREP_CELL_ASPECT=0.5 でプレビューのアスペクト比を調整