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 "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
• --source giphy には GIPHY_API_KEY が必要です
• 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 でプレビューの形状を調整します