Motion reel (Demon Clips Studio)
Cada pixel e cada som desses reels é feito em código: Remotion para a imagem,
pipeline/synth.py para o som, Edge TTS ou a própria gravação do usuário para a voz. A build
de referência é "Feito em código": remotion/src/promo/MadeInCode.tsx, pipeline/promo.py,
reels/261120-made-in-code/. Leia-os antes de escrever um novo reel. Copie seus padrões, não sua cópia.
Trabalhe dentro de D:\Claude-Chrome\wearethedemon\studio e siga studio/CLAUDE.md (ambiente, caminho
de renderização, unidade A: para rascunho, pergunte antes de baixar, faça commit apenas quando solicitado, sem atribuição ao Claude).
O que o usuário espera todas as vezes (não o faça pedir)
O usuário é direto e fica frustrado quando algo precisa ser pedido duas vezes. Entregue tudo da primeira vez:
- Locução. Narração em Hindi, cronometrada linha por linha com os beats. Use a voz de IA (Edge TTS
hi-IN-MadhurNeural) a menos que ele tenha gravado a própria no Gravador de Locução. Um reel com apenas música voltou como "sem locução?". - O finalizador anexado. Os arquivos publicáveis são
-ig.mp4(Seguir) e-yt.mp4(Inscrever-se), com os próprios efeitos sonoros do finalizador e uma trilha sonora masterizada em todo o reel e finalizador. - Ambos os scripts. Roman Hinglish e Devanagari, totalizando 4 arquivos:
{roman,deva}-{ig,yt}. - Movimento animado, mas suave. As coisas saltam, vibram, pulsam e ultrapassam. Nada brusco ou apressado: dê tempo aos movimentos grandes (uma passagem de pêndulo leva 1,5 s; 1 s foi "muito rápido e não suave"), e dê a qualquer movimento rápido um rastro de motion blur.
- Visual da casa: Paper Glass Lab. Grade clara, vidro branco, vermelho do canal #E5162D / #B80F22, tinta e branco. Interlúdios noturnos (#0E0E12 mais um brilho vermelho) são permitidos para ritmo, mas o usuário não os aprovou formalmente, então mantenha-os opcionais. Sem amarelo, sem emoji no vídeo, sem números falsos, sem selos de verificação.
- Alegações honestas. Se o reel diz "todo som é código", é. Código na tela é a fonte real deste reel, e um teste o verifica.
- Construa o que foi pedido. Se ele pedir X, não ofereça uma versão mais leve e pergunte novamente.
Fluxo de trabalho
1. Formato e ideia
Se houver um reel de referência, pegue apenas seu formato: estrutura, ritmo e tipos de movimentos. Nunca
seu script, legendas ou designs. Escreva de 5 a 8 beats, uma linha cada: o que se move, que texto aparece, que
som toca. Verifique qualquer fato antes de colocá-lo no texto. Use um cartão "Comente PALAVRA-CHAVE" apenas com um
deliverable real em reward.md. Rascunhe esse arquivo e marque-o como precisando da aprovação do usuário; ele
envia os DMs manualmente.
2. Pasta e texto
Crie reels/<AAMMDD>-<slug>/ com:
copy.yaml:handle,keyword,brand.- Um bloco
roman:e umdeva:para o texto na tela. - Um bloco
voice::id,rate,lines: [{at, text, roman}].texté Devanagari para o TTS, com palavras em inglês escritas como uma voz hi-IN as pronuncia (कोड, क्लॉड, एडिटर, डी एम).romané o que o usuário lê no gravador.
reward.md: RASCUNHO até o usuário aprová-lo.notes.md:- o comando de build e os arquivos a postar;
- uma lista de verificação antes da postagem e uma sugestão de frame de capa;
- texto da postagem: uma legenda IG com no máximo 5 hashtags, um título YT de no máximo 100 caracteres e uma descrição com 3 a 5 hashtags.
3. Planilha de beats primeiro
Coloque os tempos dos beats em um arquivo JSON, remotion/src/promo/<slug>.beats.json, em segundos.
- Compartilhado: a composição e a mixagem Python ambos o leem, o que mantém cada som em seu frame.
- Nomes: nomeie os beats conforme o que acontece (
cut,wall,land[],reveal,stretch,toCard,keyword,brand,fadeOut). - Final: os últimos 0,4 s permanecem calmos e silenciosos, para que o loop de volta ao frame 0 seja limpo.
- Duração: 25-30 s de reel, mais o finalizador de 3,5 s.
4. Composição
Escreva remotion/src/promo/<Name>.tsx e registre-o em Root.tsx, com calculateMetadata pegando
a duração dos beats.
- Schema: um schema zod para cada parte do texto (
script: "roman" | "deva", linhas, cartão, marca,audio,fps). O texto romano é o padrão. - Tempo: em segundos, através de
../motion(seconds,springAt,ramp,wiggle,pulse,loop,stagger) e as molas embrand/tokens.ts(SPRING.ui18/160/0,8,SPRING.stamp11/220/0,7). Nunca contagens de frames, para que qualquer fps funcione. - Kit:
Backdrop,NightBackdrop,FitLine(ajusta uma linha a uma largura),Card,Chip,Stamp,Rich,Phone,CaptionBar,SafeOverlay. - Texto:
- Mantenha-o dentro da zona segura: x 60-950, y 250-1560. Nada que deva ser lido fica abaixo de 34 px.
- Legendas romanas são em CAIXA ALTA Rajdhani; segundas linhas são Poppins 600 itálico em vermelho.
- Devanagari não fica em caixa alta. Precisa de tamanhos máximos maiores (cerca de 148/120 contra 150/128 do
Romano, a pílula 72 contra 64),
lineHeight ≥ 1,25elang="hi".
- Variedade: misture 4-6 movimentos do vocabulário abaixo, em uma ordem diferente a cada reel. O YouTube trata templates repetidos como conteúdo não autêntico.
5. Som e voz
Veja "Som" abaixo. Música e efeitos sonoros vão em um Bus nos tempos dos beats. A música abaixa −9 dB e
os efeitos −5 dB sob a voz. Em seguida, vem o limitador, depois loudnorm para −14 LUFS. Cada linha de voz
termina antes da próxima começar.
6. Módulo do pipeline
pipeline/promo.py está conectado ao único reel Feito-em-código (SLUG, COMPOSITION, BEATS_JSON, sua
music/sfx).
Na primeira vez que você construir um segundo reel, generalize-o em vez de copiar o arquivo:
- Mova as partes compartilhadas (
load_copy,voiceover,soundtrack,_master,render,filmstrip,final) para um módulo que recebe uma configuração de reel: slug, id da composição, caminho dos beats, e as funçõesmusic(b)esfx(b)daquele reel. - Mantenha
promo.pycomo uma configuração enxuta para Feito em código, e dê ao CLI um--reel <slug>. - Faça o mesmo para o gravador:
pipeline/recorder.pyProjectrecebe o slug, epipeline record --reel <slug>funciona, para que o aplicativo Gravador de Locução possa gravar qualquer reel.
Mantenha os testes passando, e diga em seu relatório que fez essa alteração.
7. Revisão do filmstrip antes da renderização completa
Renderize stills dos beats-chave (6 por linha, --filmstrip) em
A:\claude-workspace\screenshots\demon-studio\<slug>\ e examine-os você mesmo. Verifique:
- se o texto é legível e está dentro da zona segura, e se o Devanagari não está muito pequeno;
- por momentos vazios (um cartão parado em branco por 0,6 s parece quebrado, então inicie seu texto em cerca de 0,4 s);
- se as últimas linhas longas não tocam as bordas, e se os efeitos em camadas estão alinhados.
Corrija, re-renderize os stills, depois renderize o vídeo.
8. Renderizar, finalizador, arquivos finais
Construa a mixagem, depois renderize cada script. final() então:
- anexa o finalizador da plataforma:
O.render_outro(platform, script, keyword=..., reward=...), com seu terceiro bullet "Comente PALAVRA-CHAVE: reward"; - une os dois vídeos e masteriza uma trilha sonora em ambos;
- codifica H.264 CRF 18, BT.709 faixa limitada, AAC 320k 48 kHz, +faststart.
9. Verificar, depois relatar
- Formato (
ffprobe): 1080×1920, 30 fps, yuv420p, BT.709, AAC 48 kHz estéreo, duração = reel + finalizador. - Loudness: −14 ±1 LUFS e pico verdadeiro ≤ −1 dBTP em cada arquivo final.
- Áudio presente: verifique RMS por segundo com ffmpeg.
- Frames do finalizador: título, cartão, toque, Seguindo/Inscrito, bullet da palavra-chave.
- Testes:
uv run python -m pytest -qpassa. Adicione testes para o novo reel:- o código na tela é real;
- os beats estão em ordem;
- as props são válidas para ambos os scripts;
- cada linha de voz termina 0,05 s antes da próxima;
- a trilha sonora roda o comprimento total com um último 0,4 s silencioso;
- a palavra-chave tem uma recompensa.
Relate em palavras simples:
- os 4 arquivos para postar, como links;
- o reel beat por beat, como uma lista curta;
- o que você verificou, e o que você não pôde (você não pode ouvir, então eles devem reproduzi-lo);
- decisões abertas: aprovação da recompensa, frame de capa.
Lembre-os de que a pré-visualização do VS Code pode reproduzir esses arquivos silenciosamente ("por que não há áudio?"). VLC, Windows Media Player ou Chrome os reproduzem corretamente.
Vocabulário de animação (código em MadeInCode.tsx)
Um objeto herói conduz o reel (a bola vermelha). Todo o resto reage aonde ele está, o que dá causa e efeito: a bola passa, o texto aparece.
Caminhos
- Pêndulo.
ballAt:x = 540 − SWING·cos(t·TURN),yno círculo da corda (stringY), comTURN = π / passe uma passagem de 1,5 s.PendulumStringtem uma sombra suave e encaixa no pivô após o corte. - Salto.
hop(a, b, u, h)é uma linha reta menos4·h·u·(1−u): uma parábola real com altura de ápiceh. Encadeie saltos descendo uma escada de pontos de pouso. Suavize o assentamento final comEasing.out(Easing.back(1.5)). - Voo em direção a uma parede. Ease-in quad, mais um pequeno arco
sin(u·π). - Deslize.
lensAt: Catmull-Rom através de keyframes, suavizando no primeiro segmento e saindo no último. - Rastro de motion blur.
Trail: amostre os últimos 0,09 s do caminho e desenheceil(length / 5 px)círculos (no máximo 48) sob um SVGfeGaussianBlur, encolhendo e desvanecendo em direção à cauda (0.16·(1−k)^1.4). As cópias se sobrepõem, então lê-se como um cometa, nunca como contas.
Texto
- Wipe que segue o objeto.
SceneSwing/SwingText: cada legenda é uma camada de quadro inteiro recortada comclip-path: inset()no x da bola. A nova legenda aparece atrás da bola, a antiga à frente dela, e a direção alterna a cada passagem. - Carimbo no pouso.
StackLine: a linha surge comspringAt(c, at, SPRING.stamp)exatamente no beat de pouso.
Impactos e vida
- Squash e stretch.
squashAt: por 0,14 s após um pouso,sx += 0,3·sinesy −= 0,26·sin, comtransform-origin: 50% 100%. Um impacto na parede estica do outro lado. - Ondulação. Um anel elíptico plano crescendo a partir do ponto de contato ao longo de 0,45 s.
- Explosão. 14 brilhos e pontos, semeados com
random()para que as renderizações se repitam exatamente. Use-o apenas no único grande momento (a palavra-chave). - Vibração e pulso.
wiggle(c, at, dur, hz, amp)sacode a rotação;pulse(c, at, dur, amount)aumenta a escala. Multiplique os pulsos juntos e adicione um pulso suave a cada segundo no final para que o cartão continue respirando. - Brilho. Uma barra de gradiente branca inclinada cruza a pílula uma vez.
Cenas
- Claro para noturno. A bola arrasta um painel
NightBackdropatravés do papel. Sua borda dianteira é uma linha inclinada (panelEdge/edgeX, inclinação suavizando 0 → 14° → −6°) usada para recortar a camada noturna como um polígono. - De volta ao papel. Corte de volta em um beat forte.
- Zoom-in da câmera. 3-6 % por cena é aceitável, mas nunca em uma cena com uma lupa.
Foco e revelação
- Bola para lente.
lensRadius/Lens: a bola infla em um anel vermelho (mola), enche-se de vidro, cresce uma alça e desliza sobre uma camada de código cinza enquanto o resto escurece. As palavras de revelação então surgem dentro do vidro, e ele se fecha de volta na bola (Easing.in(Easing.back(1.4))). - Ampliando. Dentro do vidro, desenhe a mesma camada dimensionada por
ZOOM(2,1) comtransform-originno centro da lente. Se a camada base se move (um zoom-in da câmera), a cópia ampliada se desvia do alinhamento. - Código na tela. Ele vem de
code-lines.ts: linhas literais do próprio código-fonte deste reel, mantidas em sincronia por um teste, destacadas em cores apenas dentro da lente.
Morfose do CTA
- A forma.
Morphconstrói um retângulo arredondado a partir de três molas: largurasW, alturasH(mais solta, então ela oscila) e cartãosC.w = 60 + 840·sW + 20·sC,h = hPill + 430·sC, e o raio vai de pílula a 52. - A sequência. Bola → pílula com o texto do CTA deslizando para cima → vibração e brilho → cartão. O cartão segura MessageCircle + "comente karo", então uma palavra-chave itálica de 190 px carimbada a partir da escala 1,7 para 1 com uma explosão, depois a linha de postagem.
- O final. Marca
Brand(emblema, wordmark Anton, tag mono), um fade para noturno e um último 0,4 s estático. Uma marca d'água@handlefica no canto superior esquerdo durante todo o vídeo.
Som (pipeline/synth.py, pipeline/audio.py)
S.Bus(seconds) é uma linha do tempo estéreo:
add(clip, at, gain_db, pan)coloca um clipe.mix(other, db)soma dois buses.duck_under(key, depth_db)faz sidechain-duck sob outro bus.fade_out(start, end)epeak().
Leia sempre a partir do JSON de beats. A regra: cada beat visual ganha um som, e movimento rápido
ganha ar. Dê a cada whoosh sua própria seed, e panorâmica sons pequenos ±0,15-0,7.
| Visual | Som | Ganho dB |
|---|---|---|
| Passagem rápida ou voo | whoosh(dur, lo, hi, peak, seed), com pico onde se move mais rápido, panorâmica com a direção | −11 a −16 |
| Extremos de passagem, ticks de UI | tick(freq, dur) | −24 |
| Corte, estalo de corda | snap() + riser(dur) no próximo hit | −13 / −17 |
| Grande impacto (parede, palavra-chave) | impact() | −9 / −10 |
| Pouso | thud(150, 50, 0,4) + pop(900+80·i, 300), crescendo a cada pouso | −8 / −13 |
| Acende, completa | ting(Hz): 1318,5, 1568, 1760, 2093, 2637 | −13 a −15 |
| Inflar, esticar, morfose | boing(f0, f1, dur) | −10 a −14 |
| Revelar, brilho, brilho | shimmer(base, gap) | −13 a −22 |
| Encolher, fechar | zip_down() | −14 |
| Vibração | rattle() | −13 |
Música a 120 BPM, A menor Am F C G, barras de 2 s (uma passagem de 1,5 s = 3 beats, então movimento e música
se encaixam).
padpor barra, mais baixo e mais escuro onde o espectador lê ou olha.- Um arpejo
pluckKarplus-Strong em colcheias, duas oitavas acima. kicknos acentos de movimento e four-on-the-floor na build.hatesubapenas nas cenas noturnas.- Um
padfinal sob o wordmark.
Voz
- Voz de IA: Edge TTS 7.3.1,
hi-IN-MadhurNeurala +8% (hi-IN-SwaraNeuralé a opção feminina). Ela é armazenada em cache embuild/voice/, e apenas o texto do script é enviado. - Voz própria:
voiceover(mode="auto")prefere a gravação do gravador (audio/voice-take.json), depoisaudio/my-voice.*(uma gravação cortada nas pausas porpipeline/ownvoice.py), depois a voz de IA.--voice ai|ownforça uma. - Linhas: cada linha tem 2-6 palavras e começa em seu beat. Meça cada clipe: ele deve terminar
≥ 0,05 s antes da próxima linha, e a última antes de
fadeOut. Encurte as palavras se não. High-pass 80 Hz,
…
[truncado para tradução]