Editor de Vídeo AI

Renderizar, exportar, corrigir

Execute de dentro de projects/<name>/. Os arquivos finais aprovados também são copiados para exports/ na raiz do workspace.

Folha de referência

npx hyperframes render . -o renders/video.mp4                         # padrão
npx hyperframes render . --fps 60 -o renders/video-60fps.mp4
npx hyperframes render . --resolution 4k -o renders/video-4k.mp4       # aspecto deve corresponder; retrato → retrato-4k
npx hyperframes render . --resolution 4k --fps 120 -o renders/video-4k-120.mp4
npx hyperframes render . --fps 24 -o renders/video-24fps.mp4
npx hyperframes render . --format mov -o renders/video.mov             # ProRes
npx hyperframes render . --format png-sequence -o renders/frames
npx hyperframes render . --crf 23 -o renders/smaller.mp4               # arquivo menor

• Quando gráficos são sobrepostos à filmagem do usuário, mantenha a taxa de quadros da filmagem, a menos que o usuário peça o contrário.
• Referência de tempos em um notebook i3 de 4 núcleos com ~12 GB de RAM (PCs mais rápidos são mais rápidos): 6 s de gráficos simples em 1080p ≈ 24 s; 3:20 de filmagem 1080x1920 + Paper Cut ≈ 1,5 h (~1,1 fps: filter: drop-shadow força captura de tela, e a captura rápida só funciona no macOS). Avise o usuário antes de renderizações longas e renderize apenas uma vez ao final.
• Alavancas de velocidade: --workers 3 (cada Chrome ~256 MB; padrão auto escolheu 1 aqui — teste primeiro em um clipe curto), --quality draft para renderizações de revisão, ou um clipe mais curto. Se uma renderização ficar sem memória ou exceder o tempo limite, adicione --low-memory-mode e/ou --protocol-timeout 600000.
• Mudanças apenas de áudio nunca precisam de re-renderização: node tools/sfx.mjs projects/<n> --mix in.mp4 out.mp4 (fluxo de vídeo copiado).
• Itere com npx hyperframes snapshot (rápido) e renderize apenas quando os quadros estiverem corretos.

Exportação transparente (PROMPT 14)

MOV/PNG só são transparentes se o fundo for transparente.

1. Remova o fundo e qualquer filmagem para que apenas o(s) cartão(ões) permaneça(m); tudo ao redor transparente.
2. Cartões com efeito fosco perdem o desfoque sem nada atrás → mude para cartões sólidos para sobreposições.
3. Exporte renders/card.mov (ProRes 4444 com canal alfa, --format mov) e uma sequência PNG em renders/card-png (--format png-sequence).
4. Capture um snapshot sobre um tabuleiro de xadrez para verificar se apenas o cartão está visível. (--format webm é outra opção transparente.)

Quando algo parece errado

Sintoma	Correção
Fonte errada / fallback simples	Use o arquivo em fonts/ via @font-face; nunca uma URL de fonte web. lint sinaliza font_family_without_font_face.
Texto cortado em celulares	Mantenha todo o texto dentro dos 80% centrais da largura.
Um cartão cobre as legendas	Mova todos os cartões acima do terço inferior.
Um cartão está um pouco adiantado / atrasado	O reconhecimento de fala pode ter ~1 s de erro. Reajuste o tempo para a palavra exata falada (verifique o áudio ao redor).
Arquivo enorme	Renderize novamente com --crf 23 (estilos granulados especialmente).
Renderização silenciosa	Cada <audio> precisa de um id; o <video> não deve estar muted e precisa de data-has-audio="true".
Se o usuário descrever o problema em palavras simples, traduza para um destes ou para um botão em mg-styles.