Criador de Vídeo
Produção profissional de vídeos cinematográficos para produtos, serviços, eventos e marcas. Cada saída é um MP4 1920×1080 com narração, legendas sincronizadas, animações ricas e múltiplas transições de cena.
Início Rápido (3 comandos)
# 1. Iniciar projeto
npx --yes [email protected] init meu-video
# 2. Gerar narração
python3 -c "from kokoro_onnx import Kokoro; import soundfile as sf; k=Kokoro('models/kokoro-v1.0.onnx','models/voices-v1.0.bin'); s,r=k.create(open('script.txt').read(),voice='bm_george',speed=0.92,lang='en-gb'); sf.write('narration.wav',s,r)"
# 3. Transcrever para legendas
npx --yes [email protected] transcribe narration.wav --model small.en
# 4. Renderizar
npx --yes [email protected] render
Pipeline de Produção
Sempre siga esta sequência — nunca pule etapas:
1. BRIEF → público, plataforma, duração, tom
2. ROTEIRO → escrever narração (~2.5 pps), gancho primeiro
3. design.md → cores da marca, fontes, energia do movimento
4. NARRAÇÃO → npx hyperframes tts OU python kokoro_onnx diretamente
5. TRANSCRIÇÃO → npx hyperframes transcribe → transcript.json
6. PLANO → declaração do ritmo das cenas antes de qualquer HTML
7. CONSTRUÇÃO → layout primeiro → depois animação GSAP
8. LINT → npx hyperframes lint (0 erros exigidos)
9. VALIDAÇÃO → npx hyperframes validate --no-contrast
10. RENDER → npx hyperframes render
Etapa 1 — Briefing da Produção
Pergunte (ou deduza do contexto):
- Assunto: produto / serviço / evento / marca?
- Público: empresa, desenvolvedor, consumidor, investidor?
- Plataforma: rede social (15s), hero do site (30s), demo de produto (60s), apresentação?
- Tom: autoritário, energético, caloroso, dramático, técnico?
- Ativos: cores da marca, logotipo, capturas de tela, texto existente?
Leia references/brief-templates.md para pontos de partida específicos do público.
Etapa 2 — Escrita do Roteiro
Fórmula de ritmo: 2.5 palavras por segundo em velocidade natural
- 15s → ~37 palavras
- 30s → ~75 palavras
- 60s → ~150 palavras
Estrutura: Gancho → Problema/História → Prova → CTA
Padrões de gancho (nunca use aberturas genéricas):
- Afirmação ousada: "A infraestrutura financeira que impulsiona a engenharia moderna."
- Contraste: "Seus agentes estão implantados. Ninguém está monitorando eles."
- Pergunta: "E se toda a sua equipe — humana e IA — se movesse como uma só?"
- Número impactante: "Quarenta por cento dos projetos de IA corporativos fracassam na governança."
Registro de voz por público:
- Corporativo → declarativo, medido, voz
bm_george - Desenvolvedor → direto, técnico, voz
am_adam - Consumidor → caloroso, orientado a histórias, voz
af_heart - Startup/energia → impactante, rápido, voz
af_sky
Escreva números como palavras no roteiro (TTS lê literalmente): 10x → dez vezes, $2.3T → quase dois ponto três trilhões de dólares.
Leia references/script-patterns.md para exemplos completos de roteiros por tipo de vídeo.
Etapa 3 — Sistema de Design (design.md)
Sempre crie design.md antes de escrever qualquer HTML. Ele define o contrato da marca.
Campos obrigatórios:
colors:
bg: "#0A0A0A" # fundo principal (escuro ou claro)
accent: "#E63946" # cor de ação principal
accent2: "#10b981" # destaque secundário
text: "#FFFFFF"
muted: "#999999"
border: "#141111"
typography:
headline: { fontFamily: "Space Grotesk", fontWeight: 800 }
label: { fontFamily: "Space Mono", fontWeight: 700 }
motion:
energy: high | medium | low
transition: glitch | blur | push | cover
Seletor de estilo visual (leia references/visual-styles.md para tokens YAML completos):
| Estilo | Melhor para | Marca registrada |
|---|---|---|
| Deconstructed | Tech, SaaS, segurança | Linhas de varredura, bordas brutais, Space Grotesk/Mono |
| Maximalist | Lançamentos, anúncios | Tipo gigante preenche o quadro, impactos de cor |
| Velvet Standard | Corporativo, luxo | Espaçamento de letras amplo, espaço generoso |
| Data Drift | IA, ML, fintech | Campos de partículas, futurista fino sem serifa |
| Shadow Cut | Revelações dramáticas, segurança | Quase monocromático + destaque em sangue |
| Folk Frequency | Consumidor, comunidade | Cor ousada, salto, padrão |
Etapa 4 — Geração de Narração
Via npx (preferido quando disponível)
npx --yes [email protected] tts script.txt --voice bm_george --output narration.wav --speed 0.92
Via Python direto (fallback se npx falhar)
# Primeira execução: baixar modelos (~340MB total, em cache)
curl -L -o models/kokoro-v1.0.onnx \
https://github.com/thewh1teagle/kokoro-onnx/releases/download/model-files-v1.0/kokoro-v1.0.onnx
curl -L -o models/voices-v1.0.bin \
https://github.com/thewh1teagle/kokoro-onnx/releases/download/model-files-v1.0/voices-v1.0.bin
# Gerar
python3 << 'EOF'
from kokoro_onnx import Kokoro
import soundfile as sf
k = Kokoro("models/kokoro-v1.0.onnx", "models/voices-v1.0.bin")
text = open("script.txt").read().strip()
samples, rate = k.create(text, voice="bm_george", speed=0.92, lang="en-gb")
sf.write("narration.wav", samples, rate)
print(f"Gerado: {len(samples)/rate:.1f}s")
EOF
Guia de vozes:
| Voz | Personagem | Use para |
|---|---|---|
bm_george | Britânico autoritário masculino | Corporativo, B2B, keynote |
bf_emma | Britânica clara feminina | Tutorial, documentação, premium |
am_michael | Americano confiante masculino | Marketing, promoção, SaaS |
am_adam | Americano neutro masculino | Ferramentas de desenvolvedor, explicadores |
af_heart | Americana calorosa feminina | Consumidor, bem-estar, pessoal |
af_sky | Americana enérgica feminina | Anúncios sociais, lançamentos, estilo de vida |
Instalar dependências (uma vez):
pip install kokoro-onnx soundfile
Etapa 5 — Transcrição (Legendas no Nível da Palavra)
npx --yes [email protected] transcribe narration.wav --model small.en
# → produz transcript.json com timestamps no nível da palavra
Formato de saída:
[
{ "text": "Enterprise", "start": 0.03, "end": 0.82 },
{ "text": "teams", "start": 0.82, "end": 1.18 }
]
Use timestamps para:
- Ancorar transições de cena nos limites das frases faladas
- Conduzir animações de legenda palavra por palavra (aparecer palavra por palavra)
- Sincronizar ênfase visual (linhas de explosão, destaques) com substantivos-chave
Etapa 6 — Planejamento do Ritmo da Cena
Declare o ritmo antes de escrever qualquer HTML. Nomeie o padrão:
SLAM → respirar → CASCATA → GOLPE → CTA (lançamento de produto)
DOR → VISLUMBRE → PROVA → CONVICÇÃO (problema/solução)
GANCHO → HISTÓRIA → PROVA → ESCALA → CTA (pitch corporativo)
PROVOCAÇÃO → REVELAÇÃO → DETALHE → DETALHE → CTA (demonstração de recurso)
Modelo de tempo de cena (30s corporativo):
Cena 1: Problema/Gancho 0–7s (frase 1-2 da narração)
Cena 2: Introdução plataforma 7–10s (frase 3)
Cena 3: Demo de recurso 10–17s (frase 4-5)
Cena 4: Prova/estatísticas 17–21s (frase 6)
Cena 5: Escalar 21–28s (frase 7-8)
Cena 6: CTA 28–32s (frase 9)
Leia references/scene-timing.md para modelos de tempo por duração.
Etapa 7 — Construir a Composição
Estrutura HTML (obrigatória)
<!DOCTYPE html>
<html lang="pt">
<head>
<meta charset="UTF-8"/>
<script src="https://cdn.jsdelivr.net/npm/[email protected]/dist/gsap.min.js"></script>
<style>
body { margin:0; width:1920px; height:1080px; overflow:hidden; background:#0A0A0A; }
.scene { position:absolute; top:0; left:0; width:1920px; height:1080px; overflow:hidden; }
#s1 { z-index:1; background:#0A0A0A; } /* cena 1 — visível por padrão */
#s2 { z-index:2; background:#0A0A0A; opacity:0; } /* todas as outras ocultas */
</style>
</head>
<body>
<div id="root" data-composition-id="main" data-width="1920" data-height="1080"
data-start="0" data-duration="32">
<!-- Áudio (separado do vídeo, sempre) -->
<audio id="vo" data-start="0" data-duration="31.1" data-track-index="10"
data-volume="1" src="narration.wav"></audio>
<!-- Sobreposições de transição (sempre acima de todas as cenas) -->
<div id="ov-r" style="position:absolute;top:0;left:0;width:1920px;height:1080px;z-index:80;background:#E63946;opacity:0;pointer-events:none"></div>
<!-- Cenas -->
<div id="s1" class="scene"><!-- conteúdo --></div>
<div id="s2" class="scene"><!-- conteúdo --></div>
</div>
<script>
window.__timelines = window.__timelines || {};
var tl = gsap.timeline({ paused: true });
// ... animações ...
window.__timelines["main"] = tl;
</script>
</body>
</html>
Layout Antes da Animação (não negociável)
- Construa o estado final de cada cena em CSS puro primeiro
- Contêineres de conteúdo:
display:flex; flex-direction:column; padding:120px 160px; width:100%; height:100%; - Nunca use
position:absolute; top:Npxno conteúdo — apenas em decorativos - Adicione
gsap.fromTo()após o layout ser confirmado - Execute
npx hyperframes inspectpara verificar se não há transbordamento
Regras do GSAP
// SEMPRE use fromTo (não from) dentro das cenas para busca determinística
tl.fromTo("#el", { opacity:0, y:40 }, { opacity:1, y:0, duration:0.5, ease:"back.out(2)" }, 1.2);
// NUNCA use gsap.to() simples para movimento ambiente — deve estar em tl
tl.to("#glow", { scale:1.08, yoyo:true, repeat:4, duration:2, ease:"sine.inOut" }, 0);
// NUNCA repeat:-1 (quebra o mecanismo de captura) — calcule repetições finitas
// Para um batimento de 4s: Math.ceil(4 / 2) = 2 ciclos
tl.to("#pulse", { scale:1.1, yoyo:true, repeat:3, duration:2, ease:"sine.inOut" }, 0);
// Saídas de cena com corte forçado
tl.set("#s1", { opacity:0, visibility:"hidden" }, tempoSaida);
// Sempre registrar
window.__timelines["main"] = tl;
Requisitos de Densidade da Cena
Cada cena DEVE ter:
- Camada de fundo: brilho radial + grade/padrão + texto fantasma + linha de varredura (2–5 elementos)
- Camada de conteúdo: manchete + subtítulo + elemento de suporte (3–5 elementos)
- Destaques de primeiro plano: marcas de canto + linha divisória + etiqueta/emblema (3+ elementos)
- Total: mínimo de 8–10 elementos visuais
Leia references/scene-density.md para listas de verificação de elementos por cena.
Biblioteca de Transições
Leia references/transitions.md para o código completo. Escolhas rápidas:
| Energia | Transição | Padrão de código |
|---|---|---|
| Caos → Clareza | Transição de desfoque | tl.to(old, {filter:"blur(14px)",scale:1.04,opacity:0,duration:0.5}) |
| Avanço | Empurrão vertical | tl.to(old,{y:-1080,duration:0.45,ease:"power3.inOut"}, T) |
| Próximo item | Deslize empurrando esquerda | tl.to(old,{x:-1920,duration:0.45,ease:"power3.inOut"}, T) |
| Corte seco | Mergulho de cor para preto | tl.to("#ov-k",{opacity:1,duration:0.25}) então tl.set(new,{opacity:1}) |
| Grande momento | Blocos de cor escalonados | Bloco vermelho então verde desliza pela tela, troca a cena por baixo |
| Industrial | Glitch | Oscilação de sobreposição RGB, 6 quadros em ±40px, 0.35s |
Sem animações de saída antes das transições, exceto o fade para preto da cena final.
Biblioteca de Técnicas de Animação
1. Campo de Partículas Canvas 2D (ambiente de fundo)
<canvas id="bg-canvas" width="1920" height="1080" style="position:absolute;top:0;left:0;z-index:1"></canvas>
<script>
var c=document.getElementById("bg-canvas"),ctx=c.getContext("2d");
function h(x,y){var n=x*374761393+y*668265263;n=(n^(n>>13))*1274126177;return((n^(n>>16))&0x7fffffff)/0x7fffffff}
var N=120, pts=[];
for(var i=0;i<N;i++) pts.push({bx:h(i,0)*1920,by:h(i,1)*1080,vx:(h(i,3)-0.5)*0.3,vy:(h(i,4)-0.5)*0.2,r:1+h(i,2)*2.5});
var px={t:0};
tl.to(px,{t:DURACAO,duration:DURACAO,ease:"none",onUpdate:function(){
var ti=px.t;
ctx.clearRect(0,0,1920,1080);
// grade
ctx.strokeStyle="rgba(230,57,70,0.04)"; ctx.lineWidth=1;
for(var gx=0;gx<1920;gx+=160){ctx.beginPath();ctx.moveTo(gx,0);ctx.lineTo(gx,1080);ctx.stroke()}
for(var gy=0;gy<1080;gy+=120){ctx.beginPath();ctx.moveTo(0,gy);ctx.lineTo(1920,gy);ctx.stroke()}
// partículas
for(var i=0;i<N;i++){
var p=pts[i],x=(p.bx+p.vx*ti*60)%1920,y=(p.by+p.vy*ti*60)%1080;
if(x<0)x+=1920;if(y<0)y+=1080;
ctx.fillStyle="rgba(230,57,70,"+(0.15+0.1*h(i,Math.floor(ti*6)))+")";
ctx.fillRect(x-p.r/2,y-p.r/2,p.r,p.r);
}
}},0);
</script>
2. Sublinhado Rabiscado SVG
<span style="position:relative;display:inline-block">
frase chave
<svg style="position:absolute;left:0;bottom:-8px;width:100%;height:20px" viewBox="0 0 500 20" preserveAspectRatio="none">
<path id="scr" fill="none" stroke="#E63946" stroke-width="3" stroke-linecap="round"
stroke-dasharray="800" stroke-dashoffset="800"
d="M0,10 Q62,0 125,10 Q187,20 250,10 Q312,0 375,10 Q437,20 500,10"/>
</svg>
</span>
<script>
// após o elemento de caminho existir no DOM:
var p=document.getElementById("scr"), l=p.getTotalLength();
gsap.set(p,{strokeDasharray:l,strokeDashoffset:l});
tl.to("#scr",{strokeDashoffset:0,duration:0.7,ease:"power1.inOut"}, INICIO);
</script>
3. Manchete Cinética Palavra por Palavra (sincronizada com a voz)
<div id="headline">
<span class="w" id="w0">Ship</span>
<span class="w" id="w1">faster.</span>
<span class="w" id="w2">CyberAgent.</span>
</div>
<script>
// timestamps de transcript.json tempos de início das palavras
var times = [0.0, 0.3, 0.7];
var eases = ["back.out(2.5)", "expo.out", "back.out(3)"];
var dirs = [{y:60,rotation:4}, {y:80,scale:0.7}, {scale:0.5,rotation:-5}];
times.forEach(function(t,i){
tl.fromTo("#w"+i,
Object.assign({opacity:0},dirs[i]),
Object.assign({opacity:1,y:0,scale:1,rotation:0,duration:0.45,ease:eases[i]},{}),
t);
});
</script>
4. Linhas de Explosão (revelação de estatística)
<div style="position:relative;display:inline-block">
<div id="stat-num">10×</div>
<div style="position:absolute;top:50%;left:50%;width:0;height:0" id="burst">
<span style="position:absolute;display:block;width:3px;height:52px;background:#E63946;left:-1.5px;top:-52px;transform:rotate(0deg);transform-origin:bottom center;opacity:0"></span>
<span style="position:absolute;display:block;width:3px;height:38px;background:#E63946;left:-1.5px;top:-38px;transform:rotate(36deg);transform-origin:bottom center;opacity:0"></span>
<!-- repita para 8-12 linhas em incrementos de 30-45deg -->
</div>
</div>
5. Tipografia Cinética (aparecer rastreado)
<div id="kt-text" style="visibility:hidden">
<span>Seus</span> <span>dados,</span> <span>sua</span> <span>governança.</span>
</div>
<script>
var words = document.querySelectorAll("#kt-text span");
gsap.set("#kt-text", {visibility:"visible"});
gsap.set(words, {opacity:0, x:20, filter:"blur(8px)"});
words.forEach(function(w,i){
tl.to(w, {opacity:1, x:0, filter:"blur(0px)", duration:0.2, ease:"power1.out"}, 0 + i*0.12);
});
</script>
6. Glide de Destaque com Onda
<div style="position:relative;display:inline-block;overflow:hidden" id="highlight-container">
<span id="highlight-text" style="position:relative;z-index:2">nunca comprometa a segurança</span>
<div id="highlight-wave" style="position:absolute;top:0;left:-100%;width:100%;height:100%;z-index:1;background:linear-gradient(90deg,transparent,rgba(16,185,129,0.3),transparent);transform:skewX(-20deg)"></div>
</div>
<script>
tl.fromTo("#highlight-wave", {left:"-100%"}, {left:"200%", duration:0.8, ease:"power2.inOut"}, 0.5);
</script>
7. Sobreposição de Varredura (granulação de filme)
<div id="scanlines" style="position:absolute;top:0;left:0;width:1920px;height:1080px;z-index:90;pointer-events:none;background:repeating-linear-gradient(0deg,transparent,transparent 2px,rgba(0,0,0,0.08) 2px,rgba(0,0,0,0.08) 4px);opacity:0.15"></div>
8. Cápsula de Citação Flutuante
<div id="quote-box" style="position:absolute;top:300px;right:100px;width:500px;padding:32px 40px;background:rgba(255,255,255,0.02);border-left:4px solid #E63946;backdrop-filter:blur(8px);opacity:0;transform:translateX(60px)">
<div style="font-family:'Space Grotesk';font-size:28px;color:#FFFFFF;line-height:1.4">"A segurança não é um recurso. É um princípio de design."</div>
<div style="font-family:'Space Mono';font-size:16px;color:#E63946;margin-top:20px">— CTO, Plataforma Fortune 500</div>
</div>
<script>
tl.fromTo("#quote-box", {opacity:0,x:60,rotate:2}, {opacity:1,x:0,rotate:0,duration:0.7,ease:"power2.out"}, TEMPO);
</script>
Etapa 8 — Linting
npx --yes [email protected] lint
Regras que são verificadas:
composition/data-startecomposition/data-durationexistemcomposition/data-duration >= composition/data-start + 0.5- Nenhum
<script>inline não encapsulado em funções window.__timelines["main"]é atribuído- Nenhum
gsap.to()solto — apenas declarações dentro de timeline - Nenhum
repeat:-1— deve ser finito - As cenas têm classe
sceneez-indexadequado - Nenhuma imagem externa quebrada (caminhos relativos ao ativo)
audio[src]aponta para um arquivo.wavque existe
Resolução: corrija até 0 erros.
Etapa 9 — Validação
npx --yes [email protected] validate --no-contrast
Etapa 10 — Renderização
npx --yes [email protected] render
# → produz MP4 em dist/video.mp4
Saída
dist/
├── video.mp4 # produto final 1920×1080
├── narration.wav # arquivo de áudio usado
├── transcript.json # legendas no nível da palavra
├── index.html # composição de depuração
└── design.md # sistema de design usado
Dependências: Node.js 18+, Python 3.10+, pip install kokoro-onnx soundfile
Atalho de linha de comando: npx [email protected] <comando>
Todas as referências em: references/ — leia as relevantes para o tipo de vídeo que está sendo produzido.