gifgrep

• Você quer pesquisar no Tenor ou Giphy sem sair do terminal e redirecionar os resultados para outras ferramentas.
• Você precisa extrair um único quadro estático ou uma folha de contato com múltiplos quadros de um GIF para uso em documentação, PRs ou chat.
• Você prefere uma TUI orientada por teclado para navegar e selecionar GIFs antes de fazer o download.
• Você está criando scripts ou automatizando a seleção de GIFs e precisa de saída JSON estruturada ou formatação de campos compatível com pipes.

• Você precisa pesquisar provedores de GIF a partir de um aplicativo gráfico de desktop em vez do terminal.
• Seu terminal não suporta renderização de imagens inline (Kitty/Ghostty) e as pré-visualizações ainda são importantes para o seu fluxo de trabalho — a flag --thumbs não funcionará em outros terminais.

Execute gifgrep <query> para pesquisar no Tenor ou Giphy e obter resultados imediatamente. Use --format url para emitir URLs simples para uso com pipe, ou --json para obter um array estruturado com os campos id, title, url, preview_url, tags, width e height.

Execute gifgrep tui "query" para abrir uma interface de terminal completa para navegar, visualizar e selecionar GIFs de forma interativa. Pré-visualizações estáticas inline estão disponíveis nos terminais Kitty e Ghostty por meio da flag --thumbs.

Adicione --download para salvar GIFs diretamente em ~/Downloads. Combine com --reveal para abrir o último arquivo baixado no Finder imediatamente após salvar.

Use gifgrep still ./clip.gif --at 1.5s -o still.png para extrair um único quadro em um timestamp preciso de qualquer GIF local. Gera um PNG pronto para incorporar em documentos ou compartilhar.

Use gifgrep sheet ./clip.gif --frames 9 --cols 3 -o sheet.png para gerar uma grade PNG com frames amostrados em uma única imagem. Ajuste o resultado com --frames, --cols e --padding — ideal para revisões rápidas, descrições de PR e pré-visualizações em chats.

Alterne entre provedores com --source auto|tenor|giphy. O Tenor funciona imediatamente com uma chave de demonstração integrada; o Giphy requer uma GIPHY_API_KEY. O modo auto seleciona um provedor automaticamente.

Execute gifgrep sheet ./animation.gif --frames 9 --cols 3 -o sheet.png para gerar uma grade compacta de frames e insira-a diretamente na descrição do PR, oferecendo aos revisores um resumo visual rápido sem a necessidade de incorporar um arquivo animado completo.

Redirecione gifgrep cats --format url | head -n 5 para scripts ou bots downstream para buscar as URLs dos GIFs mais relevantes de forma programática. Use --json com jq para acesso mais granular aos campos.

Execute gifgrep tui "office handshake" para navegar pelos resultados visualmente e, em seguida, baixe o GIF escolhido com um toque de tecla — sem necessidade de navegador.

Use gifgrep still ./clip.gif --at 2s -o frame.png para capturar um frame específico para usar em documentação, apresentações de slides ou postagens em redes sociais.