Viral Video Edits

O que Viral Video Edits faz?

Um método completo para produzir videoclipes verticais com sincronia de batida e efeitos integrados que parecem videografia de nível S. Construído a partir de um sistema de produção real (campanha promocional de curta duração de um músico independente) e seu feedback acumulado de clientes. A única métrica de sucesso é o desempenho (retenção + compartilhamentos), e cada regra abaixo existe porque sua violação foi observada em campo como falha.

As Leis (não negociáveis; cada uma foi aprendida da maneira difícil)

1. Apenas efeitos integrados. Efeitos são FUNDIDOS DENTRO DOS PLANOS — ancorados à máscara do sujeito, à geometria da cena ou aos próprios pixels do plano. Nunca corte para segmentos de efeito independentes; nunca alterne efeitos de tela cheia com imagens de tela cheia; um elemento composto sem rastreamento parece um adesivo. Leia references/integrated-fx.md antes de adicionar qualquer efeito.
2. Boa aparência supera parâmetros. Se a imagem ou estrutura solicitada prejudicar a qualidade, mude a estrutura e avise. Muitos clipes incompatíveis costurados nas fronteiras das batidas parecem caos, mesmo com um motivo compartilhado.
3. Rico, não contido — e não brega. O registro de trabalho é uma grade RICA e densa (pretos verdadeiros, curva S de contraste, paleta comprometida) + UMA distorção de realidade forte por plano na grade de batidas. Conter-se puramente parece desbotado e chato; aleatoriedades por plano parecem caóticas. Uma linguagem de efeito por corte, escalada com a estrutura da música.
4. Corte no que a música oferece. Corte sincronizado com onset: um corte em cada onset real (mesclados abaixo de 0,13s mantendo o mais forte), pausas quando esparso, rajadas quando cheio — nunca cortes de preenchimento fora da grade, nunca uma predefinição de densidade sobrepondo a música. Para peças focadas em compartilhamento, o polo oposto: um plano contínuo, zero cortes, transformação fotométrica conduzida pelos envelopes da música.
5. Sincronia por construção. Todas as renderizações de FX são geradas contra a mesma janela (--start/--dur) e lista de cortes da edição. Ajuste batidas estimadas para onsets reais detectados (≤60ms). Mudanças de estilo caem no quadro CONTENDO o transitório (piso, não arredondamento).
6. Quase preto + emissivo para todas as imagens processuais. Campos pastel desbotados falham sempre; a luz deve ser esculpida a partir da escuridão.
7. Ganchos passam no teste 5 (olhada/fala/nome/lacuna/atração, ≥4 de 5). Sem poesia, sem "ninguém:", sem comandos de engajamento. Veja references/hooks-and-text.md.
8. Portões de qualidade por plano. Especificação de vibe antes da captação; fontes de nível mais alto primeiro; gate de qualidade por plano + olhada humana no contact sheet; apenas planos aprovados entram nas edições. Verifique licença por arquivo. Veja references/footage-sourcing.md.
9. QA automatizado nunca substitui assistir. Cada entrega recebe um relatório de sonda E olhos no contact sheet e na renderização completa em velocidade normal e em escala de telefone. Veja references/delivery-qa.md.
10. Itere como versões numeradas em infraestrutura estável. Altere apenas a linguagem de efeito entre versões; quando o cliente amar um momento de 2 segundos, faça desse momento a linguagem inteira da próxima versão.

Formato padrão

1080×1920 @ 30fps vertical, libx264 yuv420p +faststart, aac 192k, CRF 17 (finais com pipe de quadro) / 18–19 (finais de segmento). Finais com loop sem costura. Nomes de arquivo versionados em outputs/<projeto>/. Toda edição acompanha contact sheet + arquivo de timeline + relatório de QA.

O Fluxo de Trabalho

Para qualquer coisa não trivial, escreva o plano primeiro (documento de design / storyboard tomada por tomada — references/design-docs.md), e para uma nova campanha execute um piloto: V1 prova a gramática, aprovação desbloqueia o lote.

1. Analise a música → grade de batidas, energia/prioridade de corte por batida, seções, frases de 8 batidas. Depois escolha a janela (15–30s) por repetição (refrão), aumento de energia, costura de loop, posicionamento da letra, prior do artista. → references/song-analysis.md
2. Capture e gateie imagens → especificação de vibe, fontes em níveis, gate de qualidade por plano em um mapa de planos, verificações de contrato semântico quando o conceito exigir conteúdo específico. → references/footage-sourcing.md
3. Escreva o pacote de ganchos → teste 5, cinética de segunda linha (linha 1 no quadro 0, linha 2 fundida com batida em 0,8–1,3s ±100ms), pacote A/B no eixo engraçado-calor vs específico-silencioso. → references/hooks-and-text.md
4. Construa o corte → escolha o relógio (CSV de batidas para barras musicais; grade de onsets para corte transitório), escreva o plano de tomadas em batidas, afirme âncoras estruturais (drop em sua barra ±0,02s). Arquitetura: segmento→concat→pós-gráfico (ffmpeg apenas) para edições baseadas em corte; pipe de quadros numpy para FX por pixel; fusão no shader para a integração mais profunda. → references/integrated-fx.md
5. Integre FX → máscaras de pessoas (Apple Vision, gate de qualidade), efeitos ancorados a máscara/cena/pixel, o pipeline comprovado base.mp4→máscaras→tabela de efeitos; elementos processuais renderizados na mesma janela e inseridos através da geometria da cena. → references/integrated-fx.md, references/procedural-renderers.md
6. Grade e camada de artesanato → a receita fílmica exata (halation, ACES, split-tone, grão, vinheta, letterbox), empurrões no centroide da máscara, espinha de escalada, costura de loop. → references/cinematic-grade.md
7. QA e entrega → prova barata dos primeiros 3–5s cedo; sonda + contact sheet + assistir; verificação de coesão (qualquer aparência de adesivo ou corte = revisão); pacote de variantes com manifesto + galeria; registre postagens no loop de experimento. → references/delivery-qa.md

Escolhendo a pista

Pedido	Pista
Faixa emocional/lírica, focada em compartilhamento	Um plano contínuo + transformação fotométrica (rampa de grade, chegada de luz, bloom) conduzida pelos envelopes da música; gancho de afirmação-identidade
Faixa de energia, focada em retenção	Corte rápido sincronizado com onset de um pool profundo de planos com gate (60+ planos), acentos de zoom nos onsets do quartil superior
Vitrine do artista no quadro	Camada de artesanato cinematográfico + um efeito de assinatura ancorado à máscara por plano (flicker de estilo, clones de eco, troca sujeito↔mundo, multiplicidade de batida)
Banger abstrato/visual	Renderizador GLSL processual (túnel/caleidoscópio/estouro), quase preto + emissivo, onsets→bumbo→bloom energia→velocidade; fundir com imagens via entrelaçamento no shader quando houver um sujeito
Peça de título herói/marca	Documento de design primeiro; timeline de movimento em fases; construção TDD; auditoria visual comparativa contra referências

Referências (leia sob demanda)

• references/song-analysis.md — fórmulas de análise, pontuação de janela viral, grade de onsets, matemática de batidas, seguidores de envelope. Leia ao iniciar qualquer música nova ou depurar sincronia.
• references/integrated-fx.md — A doutrina central do ofício: regras de ancoragem, modos de falha, pipeline de máscara, três arquiteturas de construção, pegadinhas de composição (screen-blend em RGB!), vocabulário de FX para sujeito. Leia antes de qualquer trabalho com FX.
• references/procedural-renderers.md — esqueleto moderngl, biblioteca GLSL padrão, finalização de cor padrão, lei de quase preto, fusão portal-tecido, pista TouchDesigner. Leia ao renderizar visuais processuais.
• references/cinematic-grade.md — a receita exata de grade, linguagem de câmera, espinha de escalada e os estudos de caso de iteração (dreamcatcher v1→v5, with-u v4→v7, o arco portal). Leia quando a edição precisar parecer cinema, ou antes de iterar uma versão.
• references/hooks-and-text.md — teste 5, formato de contêiner, cinética de texto, método de torneio, referências de campo, loop de otimização. Leia ao escrever qualquer texto em vídeo ou escolher entre abordagens criativas.
• references/footage-sourcing.md — especificações de vibe, níveis de fonte, limites exatos de gate, licenciamento, contratos semânticos, contratos de par de máscaras. Leia antes de capturar ou admitir qualquer imagem.
• references/delivery-qa.md — configurações de codificação, entregáveis, passagem de QA, formato de veredito, pacote de publicação. Leia antes de considerar algo finalizado.
• references/design-docs.md — folha de ideias → storyboard → documento de design → padrões de plano. Leia ao planejar uma nova produção ou campanha.

Scripts incluídos (executáveis, não apenas descritos)

Estas são implementações funcionais dos motores principais — recorra a elas antes de escrever novos do zero. Todos são ferramentas CLI simples; execute --help ou leia a docstring no topo de cada arquivo.

• scripts/choose_viral_window.py — seleção de janela viral (song-analysis.md §2). --audio music.wav [--transcript whisper.json] [--tiktok-start SEG] [--durations 15,22,30] --out DIR.
• scripts/scan_shot_quality.py — o gate de qualidade de imagem no nível do plano (footage-sourcing.md). --root caminho/para/imagens [--min-shot 1.2] [--jobs 3] → escreve shot_map.json. Precisa de opencv-python, scenedetect, pytesseract.
• scripts/build_onset_cut.py — o motor de corte v2 sincronizado com onset (song-analysis.md §3, integrated-fx.md arquitetura A). --config job.json [--shot-map shot_map.json]; veja a docstring para o esquema do job.
• scripts/matte/generate_local_person_matte.swift — máscara de pessoa por quadro via Apple Vision (integrated-fx.md). Compile com swiftc generate_local_person_matte.swift -O -framework AVFoundation -framework Vision -framework CoreImage -framework ImageIO -o mattegen (macOS 14+), depois execute mattegen source.mp4 proposal_dir/.
• scripts/matte/media_contract.py — a implementação do gate de qualidade de máscara (validate_matte_statistics, matte_statistics, probe_media, validate_sync) — os limites exatos de integrated-fx.md como código, não apenas prosa.
• scripts/procedural/ — 10 renderizadores moderngl/GLSL independentes (render_color_tunnel.py, render_glass_bloom.py, render_mandala.py, render_fractal_neon.py, render_shader_pack.py, render_neon_cathedral.py, render_dream_portal.py, render_hyper_space_jump.py, render_hyper_kaleido.py, render_portal_weave.py) mais footage_fx.py (FX de quadro inteiro em imagens reais) e subject_fx.py (amostrador de FX ancorado à máscara) — veja procedural-renderers.md. Cada um aceita --audio --start --dur --out [--fps 30 --w 1080 --h 1920]; vários também suportam --still para verificações rápidas de direção de arte. Precisa de moderngl, librosa, numpy, Pillow.

Song-analysis (script/analyze_song_for_editing.py, o produtor de batidas/seções/energia) não está incluído aqui — use o script equivalente já incluído no skill complementar song-edit-analysis (mesmo kit), ou reimplemente a partir de song-analysis.md §1.

Trabalhando no repositório original

Se este skill estiver executando dentro do workspace de produção original do qual foi extraído, prefira as cópias desses scripts nesse repositório (podem ter acumulado correções) além de sua infraestrutura de lote/captação (geradores de job, construtores de galeria, o loop de postagem-experimento) em vez das versões incluídas aqui. Em outros lugares — que é o caso comum para este skill público — os scripts/ incluídos são as implementações completas; os documentos de referência contêm todas as constantes essenciais necessárias para estendê-los ou reimplementá-los.