Communitygithub.com

logo-popups

Faça logotipos (Claude, Codex, ChatGPT, Grok, Gemini, Cursor e qualquer outro) saltarem da ponta do dedo do apresentador quando ele aponta, em sincronia com a palavra que diz. Rastreamento de mão segue o dedo, logotipos não cobrem o rosto, áudio original é mantido.

O que é logo-popups?

Esta skill permite que um agente de IA, como Claude Code, Cursor ou Codex, adicione automaticamente logotipos de marcas que saltam da ponta do dedo de um apresentador em um vídeo. Ela é útil para criadores de conteúdo de tecnologia que querem destacar visualmente as ferramentas ou empresas mencionadas em seus vídeos, sem precisar de habilidades de edição complexas. A skill suporta análise de vídeo para rastrear movimentos das mãos e identificar quando o apresentador aponta, além de transcrever palavras para sincronizar com a menção de marcas populares como Claude, Codex, ChatGPT, Grok, Gemini e Cursor. O fluxo envolve a execução de scripts Python (`scripts/track.py` e `scripts/words.py`) para detectar gestos e palavras, geração de um plano JSON, verificação rápida com imagens estáticas e renderização final em MP4 com áudio original preservado. Os logotipos são organizados em presets, mas podem ser personalizados com ícones do site lobehub.com ou imagens próprias. Regras importantes garantem que os logotipos não cubram o rosto do apresentador e que cada gesto de apontar gere apenas um pop-up.

Funciona com✓Claude Code✓Codex CLI✓Cursor✓Gemini CLI
npx skills add https://github.com/sknitd/logo-popups/tree/HEAD

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Logotipos pop-up: logotipos que saltam do seu dedo apontador

O usuário geralmente não é técnico. Mantenha as respostas curtas, faça o trabalho para ele, nunca peça para executar comandos.

Todos os caminhos são relativos à pasta desta skill (a pasta onde este SKILL.md está). Use seu caminho absoluto nos comandos. PY abaixo significa .venv/bin/python nesta pasta (.venv\Scripts\python.exe no Windows).

1. Primeira execução: configuração (uma vez)

Execute bash scripts/setup.sh. Ele imprime READY quando termina (1 a 3 minutos na primeira vez).

  • NEED_FFMPEG: instale-o (Mac: brew install ffmpeg, Windows: winget install ffmpeg), depois execute a configuração novamente.
  • NEED_PYTHON: instale Python 3.12 (Mac: brew install [email protected], Windows: winget install Python.Python.3.12), depois execute a configuração novamente.

2. Encontre o apontar e as palavras

Execute ambos no vídeo:

  • PY scripts/track.py <video>: rastreia as mãos, salva <video>.hands.json e imprime janelas de apontar (horários em que um dedo está levantado).
  • PY scripts/words.py <video>: imprime quando cada palavra é dita.

Combine cada janela com a marca que o apresentador nomeia nela ou perto dela. O Whisper frequentemente ouve errado nomes de marcas: "cloud" geralmente é Claude, "codecs" Codex, "croc"/"grok" Grok, "chat GPT" ChatGPT, "Gemini", "cursor" Cursor. Se o usuário já lhe disse quais logotipos, use-os na ordem em que apontou. Se nenhuma palavra nomear uma marca e o usuário não disse, faça uma pergunta curta: quais logotipos, em que ordem.

3. Escreva o plano

Salve-o ao lado do vídeo como <nome-do-video>_logos.json:

{"pops": [
  {"logo": "claude", "inicio": 1.12, "fim": 1.85},
  {"logo": "codex",  "inicio": 2.10, "fim": 3.05},
  {"logo": "grok",   "inicio": 3.45, "fim": 4.50}
]}
  • inicio: uma batida após a mão se estabilizar (o início da janela), ou na palavra, o que for posterior. fim: quando o dedo abaixa ou o próximo apontar começa. 0,7 a 1,2 s cada fica melhor; nunca sobreponha dois pops.
  • logo: um nome de preset (abaixo), qualquer nome de ícone de lobehub.com/icons (por exemplo, notion, figma, vercel; tenta <nome>-color primeiro), ou um caminho para PNG/SVG fornecido pelo usuário.

Opções por pop (todas opcionais):

chaveo quepadrão
labeltexto na pílula abaixo do ícone; "" escondenome da marca
bgcor do ladrilho (hex)preset, senão branco
fgcor para logotipos SVG de uma corbranco em ladrilhos escuros, preto em claros
accentcor do anel poppreset, senão cor do logo
sizelargura do ladrilho como fração da largura do vídeo0.24
logo_scaletamanho do logotipo dentro do ladrilho0.66
gapquão longe além da ponta do dedo o ícone fica (em tamanhos de ladrilho)0.85
nudgedeslocamento extra [x, y] como fração da largura[0, 0]
avoid_facedeslizar para cima se cobrir o rostotrue
burstanel e faíscas no poptrue

Presets: claude, anthropic, codex, openai, chatgpt, grok, gemini, cursor, perplexity, deepseek, copilot, mistral, meta.

4. Verifique, depois renderize

  1. Imagens paradas primeiro (rápido): PY scripts/render.py <plano.json> <video> <pasta>/check.png --still 1.5,2.6,4.0, um momento no meio de cada pop. Olhe para o PNG você mesmo. Corrija qualquer coisa que cubra o rosto, seja cortada na borda, ou fique longe do dedo (gap, nudge, size, timing).
  2. Renderize: PY scripts/render.py <plano.json> <video> <nome-do-video>_logos.mp4. Saída: H.264 MP4, 1080 de largura, mesma taxa de quadros, áudio original.
  3. Diga a eles onde está o arquivo e para assisti-lo antes de postar.

Regras

  • Nunca cubra o rosto. A esquiva de rosto está ativada por padrão; mesmo assim, verifique as imagens paradas.
  • Um logotipo por apontada. Se eles apontarem duas vezes para uma marca, use dois pops.
  • Logotipos são marcas registradas de seus proprietários; isto é para comentários e análises. Não adicione logotipos que o apresentador não mencione, a menos que o usuário peça.

Habilidades Relacionadas