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
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.
- 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.
- 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.
- 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:
| Caminho | Conteúdo |
|---|---|
video-analyses/<vídeo>/descriptions/ | as descrições, uma por foco ou pergunta |
video-analyses/<vídeo>/transcript.md | a fala com tempos, quando o vídeo tem legenda |
video-analyses/<vídeo>/index.md | o roteiro que a IA segue no modo local |
video-analyses/<vídeo>/analysis.json | os 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.0.2Publicada em 29 de outubro de 2026Verificar
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.
- 1.0.1Publicada em 21 de outubro de 2026Verificar
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.
- 1.0.0Publicada em 17 de outubro de 2026Verificar
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.
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.