Planejar

Análise de vídeo

Assiste a vídeos do YouTube ou do seu computador, com imagem e som, e entrega uma descrição com tempos do que aparece na tela, do que é dito e de como foi editado.

  • App
  • Claude Code

Instala com o FlyeeClub. Ver o preço

Exemplo do Análise de vídeo respondendo a um pedido na sua IA
Análise de vídeoNa sua IA

Analise este vídeo e me diga o que aparece na tela além do que é falado: https://www.youtube.com/watch?v=…

Só na imagem · 01:42: A balança marca 350 g com a água na tigela; a fala não diz a quantidade. Só na imagem · 04:26: Em close, um dedo aperta a massa para testar o ponto. A fala não explica esse teste. Texto na tela · 07:12: "230 °C · 40 min", sobre a imagem do forno. A fala não diz a temperatura nem o tempo. Medições: Cortes detectados: 41 em 08:05; um plano a cada 11,5 s em média. Incertezas: O rótulo do pote de fermento, em 00:38, está fora de foco e ficou registrado como ilegível.

Salvo em video-analyses/yt-…/descriptions/general.md

O que ele faz

Assiste a vídeos por você, com imagem e som, e entrega uma descrição com tempos: o que aparece na tela, o que é dito, os textos, os cortes e o estilo. Funciona com vídeos do YouTube, de outros sites e com arquivos do seu computador.

O que ele faz

A transcrição de um vídeo só traz o que é falado. Ficam de fora a demonstração na tela, o gráfico que ninguém leu em voz alta, o texto que aparece por dois segundos, a reação de quem está no vídeo, o jeito como foi editado. Este app olha a imagem e entrega uma descrição em que cada ponto tem o seu tempo, com uma seção só para o que a imagem mostra e a fala não diz.

O vídeo pode ser assistido de dois jeitos:

  • Modo local, sem chave. O app baixa o vídeo, tira frames a cada mudança de cena, mede os cortes e os silêncios e monta grades de imagens com o tempo de cada frame. A sua IA olha as grades, lê a fala e escreve a descrição. Usa um pouco do seu plano de IA: algumas imagens por vídeo.
  • Modo Gemini, com uma chave do Google. O Gemini assiste ao vídeo inteiro, com som, e o app escreve a descrição no mesmo formato. Vídeos públicos do YouTube são lidos direto do YouTube, sem baixar nada.

Com a chave configurada, o app usa o Gemini para o YouTube e o modo local para o resto, sozinho. Se o Gemini falhar, ele segue no modo local e avisa.

A descrição tem três focos: geral (o que o vídeo mostra e diz), edição (gancho, ritmo de cortes, enquadramentos, legendas, transições, música) e conteúdo (slides, código, diagramas e o passo a passo de aulas e tutoriais). Depois da descrição, pergunte o que quiser sobre o vídeo: a IA responde citando os tempos e, se precisar, puxa o frame exato.

Outros apps do flyee.club usam este para entender vídeos. O Roteiro para YouTube, por exemplo, usa para ler um vídeo sem legenda e para escrever a narração em cima da sua gravação de tela. Vídeo já analisado não é analisado de novo: a descrição fica guardada no projeto e serve para qualquer app.

O que você precisa

  • Uma IA que leia imagens, como o Claude Code.
  • Para o modo local: o ffmpeg e, para endereços da internet, o yt-dlp. Você não instala nada: a sua IA instala os dois na primeira vez que o app precisar, depois de avisar.
  • Para o modo Gemini (opcional): uma chave da API do Gemini, criada com a sua conta Google. O Google não cobra por ela no uso comum. O passo a passo está logo abaixo.

Na dúvida, peça à IA: "confira o que falta para a análise de vídeo". Ela verifica a máquina e resolve o que faltar.

Como ligar o modo Gemini

A chave nunca passa pelo chat: nem a IA nem o app pedem que você a cole na conversa. Você a salva uma vez no seu computador, e todos os apps do flyee.club que usam a mesma chave a encontram.

  1. Peça à IA: "ligue o modo Gemini da análise de vídeo". Ela mostra o endereço do Google AI Studio, onde você cria a chave com a sua conta Google.
  2. A IA abre uma página no seu navegador. Cole a chave lá e clique em Salvar. Ela fica guardada só neste computador, fora dos seus projetos.
  3. Pronto: o app enxerga a chave na hora, sem reabrir a IA, e a IA confirma que a chave foi encontrada, sem nunca mostrar o valor.

Para ver ou apagar as chaves salvas, peça à IA, por exemplo "quais chaves eu tenho salvas?". Quem prefere variável de ambiente pode definir GEMINI_API_KEY; ela tem prioridade sobre a chave salva.

Colou a chave no chat por engano? Ela ficou no histórico da conversa: apague-a no Google AI Studio e crie outra.

Peça assim

"Analise este vídeo e me diga o que aparece na tela além do que é falado: https://www.youtube.com/watch?v=…"

Outros pedidos:

"Estude a edição deste vídeo de referência: ritmo de cortes, legendas, transições e música."

"Extraia os slides e o código mostrados nesta aula: aulas/modulo-3.mp4"

"No vídeo que você analisou, o que estava escrito na tela por volta de 2 minutos?"

O que ele grava

Tudo fica numa pasta do seu projeto, uma subpasta por vídeo:

CaminhoConteúdo
video-analyses/<vídeo>/descriptions/as descrições, uma por foco ou pergunta
video-analyses/<vídeo>/transcript.mda fala com tempos, quando o vídeo tem legenda
video-analyses/<vídeo>/index.mdo roteiro que a IA segue no modo local
video-analyses/<vídeo>/analysis.jsonos dados medidos: cortes, planos, silêncios, frames
video-analyses/<vídeo>/media/frames e grades de imagens (fora do git)

O vídeo baixado é apagado ao final; ele só fica se você pedir para manter.

Sem a chave

Tudo funciona no modo local: descrição, os três focos, perguntas, frames extras e as medições de cortes e silêncios. A chave do Gemini acrescenta a análise do vídeo inteiro com som (música e efeitos, não só a fala), a leitura de vídeos públicos do YouTube sem baixar e economiza o seu plano de IA. Também serve de saída quando o YouTube recusa o download.

Com a chave: limites e privacidade

  • O Google limita o uso de cada chave: os pedidos por minuto e, no uso comum, as horas de vídeo do YouTube por dia. Quando o limite acaba, o app avisa e segue no modo local.
  • Pelo endereço, o Gemini só lê vídeos públicos do YouTube. Vídeos não listados são baixados e enviados.
  • Um arquivo do seu computador só vai para o Google com a sua autorização. A IA pergunta antes. O Google apaga o arquivo enviado em até 48 horas. Arquivos grandes são reduzidos para 720p antes do envio.
  • A chave fica só no seu computador, salva pelo flyee fora dos projetos (ou na variável de ambiente, se você preferir); o app nunca a grava nem a mostra.

Cuidados

  • Use as análises para estudar e se inspirar; não republique o conteúdo de terceiros.
  • Baixar vídeos do YouTube pode contrariar os Termos de Serviço do YouTube. Prefira analisar vídeos que você tem direito de usar, ou o modo Gemini, que lê o vídeo público direto do YouTube.
  • Às vezes o YouTube recusa downloads automáticos. A sua IA atualiza o yt-dlp, o que costuma resolver; senão, use o modo Gemini ou o arquivo do vídeo.

O que há de novo

  • 1.0.0: primeira versão. Modo local e modo Gemini, focos geral, edição e conteúdo, perguntas sobre o vídeo, frames extras sob demanda e uso por outros apps.

Antes de instalar

O que ele acessa e o que pede

Declarado pelo próprio app na versão atual, com o motivo de cada permissão.

Permissões

  • Rodar comandos node .flyee/modules/video-analysis/scripts/video.mjsO script do app prepara o vídeo, chama o Gemini quando há chave e grava a análise.
  • Rodar comandos ffmpeg, ffprobeLê o vídeo, mede cortes e silêncios e extrai os frames e as grades de imagens.
  • Rodar comandos yt-dlpBaixa o vídeo, os dados e a legenda quando você passa um endereço da internet.
  • Acessar a rede youtube.com, googlevideo.com e o site do vídeo que você indicarBusca o vídeo, os dados e a legenda do endereço que você passar.
  • Acessar a rede generativelanguage.googleapis.comSó com a chave do Gemini: pede a análise e, com a sua autorização, envia um arquivo local.
  • Ler arquivos os arquivos de vídeo e de instruções que você indicarLê o vídeo do seu computador que você pediu para analisar e uma legenda .srt ou .vtt ao lado dele.
  • Ler arquivos ~/.flyee/keys.json (só a chave GEMINI_API_KEY)Lê a chave do Gemini que você salvou na página que a sua IA abriu no navegador, quando ela existe.
  • Escrever arquivos ./video-analyses/Grava as descrições, a transcrição, os dados medidos, os frames e as grades de cada vídeo.
  • Ler variáveis de ambiente GEMINI_API_KEYLê a chave do Gemini da variável de ambiente, se você preferir defini-la assim; ela tem prioridade sobre a salva no flyee. Nunca é pedida no chat, gravada ou mostrada.

Chaves que você fornece

  • Chave da API do Gemini opcionalOpcional. O Gemini assiste ao vídeo inteiro, com som, e lê vídeos públicos do YouTube sem baixar. Sem a chave, a sua IA analisa os frames que o app extrai.

Versões

Cada versão, com o que mudou

A mais nova primeiro. Cada uma tem uma página pública de verificação.

  1. 1.0.2
    Publicada em 29 de outubro de 2026

    Um ffmpeg, ffprobe ou yt-dlp travado não deixa mais a sua IA esperando sem fim. Cada um tem agora um tempo limite folgado, que cresce com a duração do vídeo (o download tem o mais longo); passado esse tempo, o programa é encerrado com tudo o que abriu e a sua IA recebe o erro com o que fazer. Uma legenda que trava fica de fora e a análise segue, e uma grade de frames que trava ao escrever os rótulos sai sem eles.

    Verificar
  2. 1.0.1
    Publicada em 21 de outubro de 2026

    Quando outro app precisa da Análise de vídeo e ela ainda não está no projeto, a sua IA diz numa frase que vai instalá-la e instala na hora, sem pedir confirmação.

    Verificar
  3. 1.0.0
    Publicada em 17 de outubro de 2026

    Primeira versão: descrição com tempos de vídeos do YouTube, de outros sites e de arquivos locais; modo local sem chave (frames por mudança de cena, cortes, silêncios, grades e transcrição pela legenda) e modo Gemini com chave; focos geral, edição e conteúdo; perguntas sobre o vídeo; frames extras sob demanda; interface para outros apps.

    Verificar

Guias

Guias curtos, colados no app

Cada versão do app traz o próprio guia escrito, com o passo a passo e exemplos. Os guias e os vídeos ficam no painel, para quem tem acesso ao app.

  • Guia de usoPortuguês · Inglês · texto com o passo a passo
  • Guia abrir o capôPortuguês · Inglês · texto com o passo a passo · avançado

Instale Análise de vídeo na IA que você já usa

Entre na lista de espera e avisamos quando a loja abrir.