gifgrep

O que gifgrep faz?

Use gifgrep para pesquisar provedores de GIF (Tenor/Giphy), navegar em uma interface TUI, baixar resultados e extrair quadros ou folhas.

GIF-Grab (fluxo de trabalho gifgrep)

• Pesquisar -> visualizar -> baixar -> extrair (quadro/folha) para revisão e compartilhamento rápidos.

Início rápido

• 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 + pré-visualizações

• TUI: gifgrep tui "consulta"
• Pré-visualizações de quadros no terminal: --thumbs (apenas Kitty/Ghostty; quadro estático)

Baixar + revelar

• --download salva em ~/Downloads
• --reveal mostra o último download no Finder

Quadros + folhas

• gifgrep still ./clip.gif --at 1.5s -o still.png
• gifgrep sheet ./clip.gif --frames 9 --cols 3 -o sheet.png
• Folhas = grade PNG única de quadros amostrados (ótimo para revisão rápida, documentação, PRs, bate-papo).
• Ajuste: --frames (quantidade), --cols (largura da grade), --padding (espaçamento).

Provedores

• --source auto|tenor|giphy
• GIPHY_API_KEY necessário para --source giphy
• TENOR_API_KEY opcional (chave demo do Tenor usada caso não definida)

Saída

• --json imprime um array de resultados (id, title, url, preview_url, tags, width, height)
• --format para campos amigáveis a pipes (ex.: url)

Higiene de ativos GIF

• Antes de recomendar ou usar uma URL de GIF animado, verifique se ela resolve corretamente, tem Content-Type: image/gif e é realmente animada (vários quadros ou metadados de loop; por exemplo, inspecione com file, identify ou um pequeno script).
• Registre o link de atribuição/licença/fonte junto ao ativo.
• Não faça hotlink quando um ativo local for necessário: baixe/copie-o para o projeto e referencie o arquivo local.

Ajustes de ambiente

• GIFGREP_SOFTWARE_ANIM=1 para forçar animação por software
• GIFGREP_CELL_ASPECT=0.5 para ajustar a geometria da pré-visualização