Code film
Um "film" aqui é uma página web que pode desenhar qualquer momento sob demanda (window.renderAt(t)). Um pequeno harness pede cada frame em Chromium headless, na GPU, e o ffmpeg junta os frames e a trilha sonora. Nada é filmado ou gerado como vídeo, então a imagem é exatamente o que o código diz, em qualquer resolução, sempre.
O kit nesta pasta foi testado no "Dial-A-Dev 98" (tema semanal do Builder Wars "Shipped in 1998", novembro de 2026): 44 s, 1920x1080, onze cenas, 1.326 frames renderizados em cerca de 45 s. O código-fonte completo desse filme está em examples/dial-a-dev-98/. O padrão segue github.com/Vincentwei1021/mg-styles-15 (MIT), que também é um bom manual de estilos de motion design.
Iniciar um filme
bash ~/.claude/skills/code-film/new-film.sh ~/Work/<pasta-do-filme> # copia o kit, instala dois pacotes locais
cd ~/Work/<pasta-do-filme>
# som precisa de uma chave ElevenLabs: o usuário salva ELEVENLABS_API_KEY=... em ./.env (nunca peça no chat)
node harness/render.mjs film --stills 0,1,2 # PNG stills -> film/out/stills/
bash tools/build.sh v1 # lista de cues, mix, render, codificação X -> film/out/<nomeDoFilme>_v1.mp4
Mantenha o filme em sua própria pasta, fora de qualquer repositório de produto. Pergunte antes de instalar algo global.
Ordem de trabalho
- Brief. Produto, público, onde será postado, duração, formato (16:9, 9:16, 1:1). Para Builder Wars, chame
get_video_guidee siga suas regras (elas prevalecem sobre este arquivo). - Tratamento. Uma ideia, um gancho no primeiro meio segundo, uma escalada, um momento herói em cerca de 60-75% do tempo de execução e um quadro final composto. Escolha um estilo e anote suas características marcantes como afirmações testáveis.
- Cue sheet primeiro (
film/cues.json). Escreva o roteiro da voz como falas, com durações estimadas. As cenas são atreladas a falas e palavras faladas, nunca a segundos codificados, então uma nova gravação de voz reajusta o tempo de todo o filme. - Stills antes do movimento. Construa a aparência dos dois ou três quadros mais difíceis e veja-os em tamanho real. Não anime um quadro que ainda não seja digno de pôster.
- Cenas. Um módulo por cena (contrato abaixo). Verifique cada uma com stills e pequenas folhas de contato.
- Voz. Faça audições (vozes padrão e três projetadas), grave cada fala com timings de palavra, depois deixe a cue sheet mover os cortes:
node tools/vo.mjs --voice <id>, depois--reuse --tempo 1.12para apertar a leitura. - Efeitos sonoros e música. Liste-os em
audio/sfx.jsoneaudio/music.json, gere comnode tools/sfx.mjs --music. Cada cena declara seus próprios cues sonoros, para que os hits fiquem colados à imagem. - Build (
tools/build.sh), depois leia a folha de contato você mesmo e corrija o que vê. - Júri. Dê a um agente independente
rubric.md, o arquivo e o brief. Ele não fez o filme; ele pontua e retorna correções ordenadas. Aplique-as, refaça o build e só então mostre ao usuário. Duas rodadas se o tempo permitir. - Finalizar e entregar.
tools/finish.shcodifica para X e faz o pôster e a folha de contato. Execute o verificador do próprio destino. O usuário posta; nunca poste por ele.
O contrato da página
window.FILM = { width, height, fps, duration, shots, lines, sfx },window.renderAt = async (t) => {...}, entãowindow.__ready = true.- Cada frame é uma função pura de
t: apenas aleatoriedade com semente, sem clocks, sem transições CSS, sem estado carregado de um frame para o próximo. O harness pode pedir frames em qualquer ordem e em vários navegadores ao mesmo tempo. - Uma cena é
{ name, samples(lt), render(lt, post, renderer), overlay(g, lt), look(lt), sfx: [...] }:renderdesenha HDR linear empost.scene;overlaydesenha supers 2D em uma canvas de 1920x1080 (retorne true se desenhou);samplesé a contagem de amostras de motion blur para aquele momento (3 quando calmo, 12-20 durante movimentos rápidos);lookretorna configurações do post (bloom, flash, tape amount, glitch);sfxlista{ t, s, g, a, len }: tempo local, nome do som, ganho,a: 'peak'para que o momento mais alto do som caia no cue, e um comprimento de corte opcional.
film/js/film.jsmapeia nomes de cenas para factories e desenha qualquer coisa que fique sobre todas as cenas.- Switches de consulta para desenvolvimento de look:
?clean(sem passada de tape),?nocc(sem legendas),?mb=1,?rs=0.5. rendertambém recebe o número da passada e a contagem (render(lt, post, renderer, i, K)), e uma cena pode definirshutter: 0. Sem motion blur, as K passadas são livres para outras coisas: mover a lente para profundidade de campo, a luz principal para sombras suaves e a grade de pixels para antialiasing (orig.jsdo storybook).look()pode retornarpaper: truepara um acabamento limpo (curva de tom com cor verdadeira, grão, vinheta) no lugar da passada de tape.film.jspode exportarloadFonts(qualquer coisa assíncrona que precise terminar antes do primeiro frame),buildCaptionsecaption.
Esta máquina (verificado em 2026-11-11)
- Chromium 155 em
/usr/bin/chromium, RTX 4070 Ti SUPER. WebGL2 de hardware precisa de--use-gl=angle --use-angle=gl-egl(o harness os passa e avisa se cair para software). WebGPU cai para software: use WebGL2. - ffmpeg 9 com libx264 e NVENC; ImageMagick para folhas de contato; sem Blender, sem numpy fora de um venv.
- Render 1080p completo: cerca de 0,03 s por frame com três workers.
Notas do ElevenLabs (verificado em 2026-11-11)
- A chave fica no
.envda pasta do filme. Uma chave pode não teruser_read, então o plano e os créditos restantes podem não ser legíveis; diga isso em vez de adivinhar. - O plano em uso permite no máximo
mp3_44100_128(formatos superiores precisam do plano Creator). O modelo de falaeleven_v4funciona e aceita tags de áudio como[excited]; as tags voltam no alinhamento e são removidas porvo.mjs. - Vozes padrão leem devagar para uma venda agressiva. Uma voz projetada (
eleven.mjs design, depoisvoice-save.mjs, que usa um slot de voz) mais--tempo 1.12deu o ritmo de infomercial. A configuraçãospeedmal mudou o timing. - Os efeitos sonoros variam muito em nível e um voltou silencioso:
mix.mjsnormaliza o pico de cada arquivo, pula os quase silenciosos e avisa. Regere esses com um prompt mais simples ("One loud hand clap" funcionou onde uma claquete descrita voltou silenciosa três vezes). - Uma voz de contador de histórias lê devagar: a voz padrão George media 2,25 palavras por segundo.
--tempo 1.25trouxe para 2,7, um ritmo de fala comum. Decida a duração a partir das falas gravadas, não de uma contagem de palavras. - A música gerada termina antes de sua duração declarada.
mix.mjsencontra onde o nível realmente termina e alinha isso com o final do filme. - Uma voz de personagem (digamos, um mascote de TV infantil) lê no ritmo que sua descrição lhe dá: o mesmo texto levou 31 s com "fala devagar com crianças pequenas" e 24 s com "ritmo animado e rápido". Coloque o ritmo na descrição, projete duas ou três descrições (três prévias cada), meça-as com
tools/audition-stats.mjs(duração, pitch mediano, alcance de pitch) e espere--tempo 1.3por cima. Descreva um tipo; nunca nomeie um personagem ou pessoa real. - Uma voz que o usuário escolheu em uma audição pode soar mais aguda no filme embora meça o mesmo pitch e brilho: o modelo lê falas individuais cerca de 1,3 vezes mais rápido que uma longa passagem de audição, e
--tempopor cima faz a voz soar mais aguda e menor.vo.mjs --reuse --tempo 1.38 --pitch -2a abaixa na mesma velocidade (os timings não mudam, então remixe e reexecutefinish.shno master antigo; sem render). Faça clipes de comparação a 0, -1, -2, -3 semitons para o ouvido do usuário, e verifique novamente o nível do stem de voz depois (mix.vo). voice-save.mjs <id gerado> "<nome>" "<descrição>"salva uma prévia na conta (um slot de voz). Mantenha as gravações do narrador anterior (cp -r audio/vo audio/vo_<nome>) antes de gravar um novo.- Planos gratuitos não são licenciados para posts comerciais. Se o plano for desconhecido, informe o usuário.
O que deu errado, para não acontecer de novo
Imagem e código:
- Estimar quando uma palavra é falada a partir de sua posição no texto está errado em até um segundo ("98" é falado como "ninety-eight"). Use os timings de palavra gravados (
mark(line, word)). - three.js dimensiona texto extrudado maior que o tamanho nominal. Ajuste as palavras a uma largura alvo; nunca confie no número.
- Um espelho plano iluminado por uma luz direcional fica uniformemente branco. Dê a discos e cromados luzes pontuais ou um ambiente variado para que o destaque seja um ponto de luz.
- Discos inclinados sobrepostos se intersectam. Disponha-os em profundidade e limite a inclinação.
- Reflexos de chão desfocados transformam brilhos de fundo em grades de pontos: desligue os brilhos na passada do espelho.
- Tipo bitmap falso-negrito (desenhando o texto duas vezes, com um pixel de diferença) preenche W e M.
ui98.jsengrossa um traço apenas onde a lacuna para o próximo traço permanece aberta. - Um logotipo cuja metade superior é próxima da cor de fundo desaparece. Dê às letras extrudadas uma keyline escura (
outlineemmakeLetters) e mantenha suas paredes laterais próximas do preto. - Ruído de tape é caro de codificar. Renderize sem perdas (
--lossless), depois codifique uma vez com um limite de bitrate.
O que a primeira rodada do júri encontrou em um filme que eu achava que estava pronto (pontuação cerca de 6/10). Verifique estes antes do júri:
- O nome do produto deve estar na tela em cerca de 2 segundos e o frame 0 é a miniatura. Um lower third fixo com o nome, desde o primeiro frame, resolveu ambos.
- Supers e legendas cobriram as melhores piadas. Depois de colocar qualquer super, olhe o que está por baixo dele.
- O texto saiu da área segura após pushes de câmera. Verifique o último frame de cada push, não o primeiro.
- O mesmo flash branco e glitch em todos os cortes soa como um template, assim como um fundo para quatro cenas e cinco estrelas idênticas. Varie-os; guarde o flash grande para um ou dois hits.
- Legendas que parecem boas em 1080p são muito pequenas em um telefone: letras com cerca de 40 px de altura, em sua própria faixa.
- Uma premissa que nunca se paga. O filme diz "a menos que alguém atenda o telefone", então alguém tem que atender.
- Hits sonoros que caem sob uma palavra falada são inaudíveis. Mova o hit para depois da palavra e aumente-o.
O que duas rodadas do júri encontraram no filme do storybook de papel (cerca de 6/10, depois cerca de 7/10). Verifique estes primeiro na próxima vez:
- Telas de produto reais mostradas em tela cheia parecem uma gravação de tela e quebram o mundo. Mantenha-as dentro da cena (um laptop no cenário), como dois grandes recortes com tipo grande, alterados com um wipe no mundo de 16 frames ou mais. Corte qualquer borda para que os lados da tela não tenham costura, e marque dinheiro no jogo como fictício.
- Os números devem concordar entre as cenas. "Falso milionário" seguido por um quadro mostrando $9.100 desfez a fala herói.
- A cena herói ficou parada por 1,4 s. Mantenha algo em movimento em cada pausa (moedas caindo, luzes piscando, uma segunda explosão quando a fala terminar), e enquadre-a aberta desde seu primeiro frame.
- Uma lacuna de voz maior que um segundo com apenas um som de fundo fraco soa como silêncio morto. Encurte-a ou coloque uma piada e um som nela.
- Formas planas com bordas limpas parecem arte vetorial mesmo com grão por cima. Uma linha de corte ligeiramente irregular e um núcleo de papel mais claro ao longo da borda (
piece()nopaper.jsdo storybook) corrigiu isso. Placas devem ser letras recortadas (cutSign), não tipo impresso. - Qualquer coisa que flutue precisa de um suporte visível (uma haste, uma mola, uma aba). Raios de luz devem ser papel opaco.
- Ações-chave eram muito pequenas para um telefone: um giro de moeda, uma coroa mudando de cabeça, um pressionar de botão. Escale a ação e aproxime a câmera para ela.
- Pop-ups passavam uns pelos outros e por páginas virando. A verdadeira geometria de dobra faz com que as dobras voltadas para o leitor se deitem no instante em que uma abertura começa a fechar. Mantenha essas dobras eretas, faça cada pop-up ficar baixo até que sua abertura esteja quase aberta (
riseembook.js), e esconda peças que ficam planas dentro do livro fechado. - Uma página não deve começar a virar antes de sua frase terminar: o
leadde uma cena não deve ser maior que ogapantes dela. - Uma legenda que repete um punchline que a imagem entrega estraga-o.
ccem uma fala pode conter apenas suas palavras iniciais; a legenda então sai quando o resto é falado. - Termine no primeiro frame: o livro fecha em sua capa com o endereço em uma faixa. Também faz um loop limpo.
O que o usuário mudou depois de assistir aquele filme (corte v4):
- Uma piada às custas de outro personagem ("Sam odeia Kim", uma nuvem de tempestade) soou maldosa. Ele pediu que a piada fosse sobre o herói: Sam derrama uma lágrima, então sonha acordado em ser o primeiro ("Dream, Sam, dream."). Mire as piadas no herói.
- Um slogan copiado do produto ("Maior renda mensal vence") fez ele perguntar o que se vence; nada vencia. Verifique cada afirmação no roteiro contra o que o produto realmente faz antes de gravá-lo.
- Uma nuvem de pensamento é mais alta que o quadro: levante a câmera com ela, mantenha a coisa que ela espelha em quadro (o quadro real sob o quadro do sonho), e estoure-a alguns frames antes da página virar para que nada alto monte na folha.
Dividindo o trabalho:
- Construa o look e o motor em uma sessão primeiro (dois ou três quadros que o usuário aprove), e escreva o contrato da cena e um brief para cada cena em arquivos (
SHOTS.md,BRIEFS.md). Depois distribua as cenas para agentes novos, uma ou duas cenas cada, commodel: "opus"e esses arquivos como brief. Não use forks para isso: um fork sempre roda no modelo e esforço da própria sessão e não pode receber um mais barato (no filme de estilos, forks foram 55% do uso). Cada agente é dono apenas de seu próprio arquivo de cena; escreva personagens compartilhados primeiro; carregue módulos de cena um por um para que um arquivo quebrado no meio da edição apague apenas sua própria cena. Distribua correções do júri da mesma forma, para agentes novos com o arquivo da cena e a lista de correções, não retomando os construtores; mantenha arquivos do motor para a sessão principal. - Dê o júri a um agente novo a cada rodada e diga ao segundo para não ler as notas do primeiro.
Processo:
pkill -f <padrão>corresponde ao shell que o está executando. Escreva o padrão como[p]adrão.- Um erro de página deixa o harness esperando. Ele desiste após 45 s e imprime erros de página; não o canalize através de
taildurante a depuração, ou os erros chegam apenas no final
…
[truncado para tradução]