Communitygithub.com

site-promo-film

Mostra a um agente como planejar, construir ou editar um "filme promocional do site" para que o resultado concreto seja uma edição finalizada de vídeo. O procedimento percorre Filme promocional do produto, renderizado como código, Studio: o briefing em uma janela, Modo guiado: `?`. Use-o quando uma nova tarefa exigir esse ofício.

O que é site-promo-film?

Este skill capacita um agente de IA (como Claude Code, Cursor ou Codex) a planejar, construir ou editar um filme promocional de produto — desde o briefing até a entrega final — usando código como motor de renderização. Ele se baseia em um mecanismo puramente funcional: uma única página HTML e um canvas onde `seek(t)` desenha o quadro no instante `t` a partir do zero, com Chrome headless capturando subquadros e ffmpeg compondo o vídeo. O resultado é que cada quadro é revisável, cada alteração é barata e o loop é exato. O skill fornece modelos completos (como `promo.html` com molas, câmeras e texto cinético; `reel.html` com seis cenas e transições), um motor compartilhado em `film.js`, partes vetoriais (janelas, dispositivos, cursores), scripts de renderização, narração (`narrate.mjs` com vozes sintéticas ou modelos) e mixagem de áudio. A interface visual é o Studio — uma janela própria com receitas, formatos, looks e som — que escreve um `brief.json` para iniciar o filme. O skill suporta qualquer sistema operacional com Node.js e Chrome instalados, e seu fluxo completo é documentado no SKILL.md, incluindo verificação de cliques e layout, e entrega final organizada.

Funciona com✓Claude Code✓Codex CLI✓Cursor✓Gemini CLI
npx skills add https://github.com/gfazioli/manovella/tree/HEAD/plugins/manovella/skills/site-promo-film

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Filme promocional do produto, renderizado como código

Uma página, um canvas, e seek(t) desenha o quadro no instante t a partir do zero. O Chrome headless captura N subquadros por quadro, o ffmpeg combina e codifica. O filme é uma função; o vídeo é uma amostragem dela — o que torna cada quadro revisável, cada alteração barata e o loop exato.

Estes arquivos acompanham este skill. Copie-os para a pasta de trabalho do filme; não reescreva o motor.

ArquivoO que é
template/promo.htmlO motor mais uma demo de 8 segundos: molas de forma fechada, trilhas de soma de molas, uma câmera, auxiliares de texto (figuras tabulares, giros), manchetes, um cursor real, uma cadeia de morfose de um objeto e um compositor WebGL para 3D real. Abre e renderiza como está.
template/reel.htmlUm filme longo em uma linha do tempo: seis cenas, seis formatos (tipo cinético, um navegador, uma grade bento com foco rack, um terminal, um fluxo 3D tipo cover-flow de dispositivos, um cartão final), cinco transições, um visual por cena, capítulos. ~56 s, não é um loop. O catálogo da §2 em execução.
template/film.jsO motor que as páginas compartilham: o palco (jitter subpixel por subquadro, para que nada pisque ou trema em movimentos lentos), FILM.draw para rasters, molas e câmeras, a linha do tempo (cenas, capítulos, checkpoints e vinte e quatro transições: dezesseis no canvas 2D, oito como shaders de fragmento em um contexto WebGL2) e efeitos (profundidade de campo, tipo knockout, digitação). Documentado no topo.
template/parts.jsPartes vetoriais: uma janela macOS, um navegador, um terminal, um iPhone, um iPad, um MacBook, um iMac, teclas, um interruptor, um anel, um botão, o ponteiro. Cada uma retorna o retângulo onde seu conteúdo vai.
template/parts.htmlTodas as partes em uma folha 16:10, uma página como as outras: PAGE=parts.html node render.mjs stills parts 0 cria o PNG a partir do qual docs/parts.jpg é convertido (sips -s format jpeg -s formatOptions 92).
template/fx.jsO visual, carregado pela página: um fundo (sólido, gradiente, campo ou imagem; luz suave da marca; pontos, grade ou linhas em paralaxe; um chão em perspectiva; um holofote), um acabamento (vinheta, grão) e os efeitos que dependem dele (vidro fosco, ondulações de clique, manchetes com puxada de foco). Vinte e três predefinições e photo, todos os campos substituíveis, documentado no topo do arquivo. Compartilhado com release-film.
template/type.jsManchetes e tipo cinético (§3): TYPE.draw(ctx, t, spec) em treze estilos — rise, focus, settle, track, wipe, cascade, weight, split, flap, type, swap, odometer, decode — com uma marca de ênfase, um ritmo e TYPE.load para as faces de uma família. Uma função pura de t, como o resto.
template/fonts/Vinte famílias de código aberto (latin + latin-ext woff2, cada uma com seu OFL.txt) e fonts.json, suas faces. Um filme copia apenas o que usa para src/fonts/; scripts/fonts.mjs add busca outra.
scripts/render.mjsstills <dir> t…, sheet <dir> (os checkpoints da linha do tempo), looks <dir> <t>, loopcheck, video <out> [workers]. Lê tamanho, fps, duração e capítulos da página; trepida a cada subquadro; renderiza em chunks retomáveis; FROM/TO, PREVIEW=1, RESUME=1, KEEP=1, AUDIO=, SHUTTER=; a extensão escolhe o formato (.mp4, .mov ProRes, .webm, .gif; HEVC=1; ALPHA=1 para um .mov ou .webm transparente); verifica a trilha antes da renderização e o arquivo depois; falha em uma captura cuja página perdeu um contexto WebGL e em uma segunda renderização de um corte enquanto uma está em execução. Documentado no topo.
scripts/narrate.mjsA história de um filme (story.json: uma frase por etapa, de um tutorial ou um promo que fala) em uma voz, um relógio e legendas: voice/*.aiff, narration.wav (o AUDIO do filme), narration.js (o tempo de cada etapa, para a página) e captions.srt / .vtt. O say do Mac, ou --from uma pasta com suas próprias gravações. "human": "natural" varia as pausas como uma pessoa; os sons de um modelo ([chuckle]) são mantidos fora das legendas. Documentado no topo.
scripts/voice.mjsA mesma história contada por um modelo de voz que roda no Mac ("mlx" em story.json: Chatterbox para uma lição, Orpheus para um promo, Kokoro para um rascunho rápido ou um filme em italiano), mais próximo de uma pessoa que say: ele diz cada etapa (voice-mlx.py, via mlx-audio), ritma e nivela, então chama narrate.mjs. Uma tomada é uma semente; "tone" (calm, warm, bright) é quão livremente o modelo lê, "human" varia o ritmo de cada linha dentro de 3 % e permite que uma linha faça um som ([chuckle], [sigh]: a grafia de cada modelo, ou omitido). --audition compara tomadas, --recordings para nas gravações, --setup cria o Python e busca os modelos uma vez em cada Mac (voice-constraints.txt fixa o que ele instala) e diz se aquele Mac repete as tomadas gravadas aqui. Documentado no topo.
scripts/mix.mjsUma voz e uma faixa musical em uma trilha sonora, para AUDIO=: ambas medidas (EBU R128), a música --under LU abaixo da voz enquanto ela fala, --lift dB acima entre as linhas, abaixo antes de cada linha começar; imprime o resultado, medido no resultado. Documentado no topo.
scripts/contact.mjsUma folha de contato legendada de uma pasta de stills ou looks (legendas de labels.json nela); --size WxH a torna exatamente desse tamanho (--font, --gap, --pad; stills nunca cortados; um .jpg é escrito como JPEG); --dark para uma folha escura. --compare A=<dir> B=<dir> [C=<dir>] <out.png>: duas ou três pastas lado a lado, uma coluna legendada cada e uma linha por still que compartilham, para uma escolha A/B em uma imagem.
scripts/beats.mjsA batida de uma trilha sonora, a partir de suas amostras: o tempo, se ela se mantém, cada batida, os compassos, as seções, e o bpm e AUDIO_AT para dar à página; --out beats.js para uma página que segue uma trilha que deriva (FILM.beats). render.mjs o importa para medir as batidas da página contra as da trilha. --selftest.
scripts/clickcheck.mjsCada clique é visto: para cada um dos CLICKS da página, quão rápido o ponto clicado se move na tela e quão longe o cursor viaja antes do pressionamento e durante ele. Sai com 1 em um clique que ninguém verá (release-film §3b), 2 em uma página sem cursor.
scripts/layoutcheck.mjsCada manchete está no quadro, separada e legível: em cada checkpoint, cada manchete que TYPE.draw desenha, contra a área segura, as outras manchetes e o fundo ao redor (os limites estão em seu cabeçalho). Sai com 1 em uma manchete que falha, 2 em uma página que não desenha nenhuma através de TYPE.draw.
scripts/deliver.mjsO último passo (§8): os vídeos finalizados e suas capas saem da pasta de trabalho para uma pasta própria; uma vez que o filme está pronto, trash joga a pasta de trabalho fora após verificar que sua fonte está segura no kit. --selftest.
scripts/fonts.mjsAs fontes do kit: add "<Family>" [axes] do Google Fonts com sua licença, check, list.

Ao lado deles, studio/ (o Studio, abaixo), guide.md (o modo guiado, abaixo) e README.md (o catálogo em imagens e exemplos de solicitações para cada momento de um filme).

Configuração: uma pasta de trabalho, ~/Downloads/<nome>-work/ (~/Downloads é a raiz de trabalho a menos que workRoot no arquivo de configurações, abaixo, diga o contrário), com a página e estes arquivos em seu src/, e npm i playwright-core lá. Ele dirige o Chrome instalado através de channel: 'chrome', então nada mais é baixado. <nome> é <produto>-<oque> (acme-promo, acme-2.4-whats-new), e nomeia a pasta de entrega e cada arquivo entregue também (§8).

Studio: o briefing em uma janela

O caminho visual. Um assistente em uma janela própria: receitas, formatos, visuais, imagens do Mac, tipo e movimento mostrados em movimento no motor real, na cor e proporção do produto, o som (as faixas da biblioteca de música reproduzidas, a voz de um modelo ouvida dizendo uma linha antes de ser escolhida), e cada escolha escrita em um brief.json. Nada é instalado e nada renderiza. /manovella:studio também o abre.

  • Quando: invocado com studio, ou com nada enquanto nada na conversa diz qual filme fazer. Um usuário que já disse o que quer em palavras vai direto para §0.
  • Execute node <diretório deste skill>/studio/studio.mjs da área de trabalho, em segundo plano (seus repositórios irmãos são os produtos oferecidos), e diga em uma linha que a janela está aberta. Ele sai sozinho, imprimindo uma linha, e a saída acorda você: BRIEF <caminho>, ou CANCELLED, CLOSED, TIMEOUT (diga isso e pare). A janela é o próprio aplicativo do Studio onde este Mac o construiu (~/Applications/Manovella.app, seu nome, versão e ícone no Dock), senão uma janela do aplicativo Chrome; MANOVELLA_WINDOW=chrome mantém Chrome. Sem nenhum deles, abre o navegador padrão; --no-open imprime a URL, para uma sessão cuja tela está em outro lugar.
  • A biblioteca de música é opcional: uma pasta com a música dos filmes do usuário, mantida onde ele quiser (uma unidade sincronizada, uma pasta de projeto). É para onde MANOVELLA_MUSIC aponta para uma execução, senão musicLibrary em ~/Library/Application Support/manovella/settings.json (~/.config/manovella/settings.json fora do macOS; um ~ inicial é expandido); musicLibraryIgnore no mesmo arquivo lista nomes de pastas nela para pular, e deliverToLibrary (true ou false, padrão false) diz se filmes finalizados também vão para ela. Nada é auto-detectado. Um arquivo mais antigo com brandLibrary e brandLibraryIgnore é lido como musicLibrary e musicLibraryIgnore com deliverToLibrary ativado, o que fazia antes, e é reescrito com as novas chaves na primeira alteração feita nas Configurações do Studio. O mesmo arquivo aceita projectFolders (onde o Studio procura por produtos), pictureFolders (suas imagens de fundo; não definido: ~/Pictures) e workRoot (onde <nome>-work e, a menos que o filme seja entregue na biblioteca ou o projeto tenha uma instrução, <nome>/ vão; não definido: ~/Downloads); a janela de Configurações do Studio (a engrenagem ao lado do logotipo, ou ⌘, no Manovella.app) escreve todos eles, e deliver.mjs lê workRoot também. Nada mais no código lê as chaves da biblioteca: para um filme feito sem o Studio, este parágrafo é a instrução para mim.
    • O Studio oferece todo arquivo de áudio (mp3, m4a, aac, wav, aiff, flac, ogg) no nível superior da biblioteca e em cada pasta nela, diretamente ou na pasta audio/ dessa pasta; pastas com ponto e os nomes em musicLibraryIgnore são pulados. Uma pasta por marca é opcional e agrupa suas faixas; a pasta com o nome do produto é listada primeiro ("deste produto"). Um arquivo de notas opcional ao lado das faixas (...notes.txt ou .md: um parágrafo por faixa, começando com o nome do arquivo da faixa: o que é, seu clima, onde se encaixa) diz para que cada uma serve, e o Studio o mostra.
    • Filmes finalizados: com deliverToLibrary ativado e uma biblioteca definida, <biblioteca>/<Marca>/video/<nome>/ (§8); senão onde as próprias instruções do projeto mantêm a mídia finalizada, senão <nome>/ na raiz de trabalho (~/Downloads/<nome>/ por padrão).
    • Uma nova faixa que foi feita (abaixo) é salva na biblioteca, na pasta do produto quando a biblioteca mantém uma por marca, com seu parágrafo no arquivo de notas dessa pasta, quando uma biblioteca existe; senão, vai apenas para src/audio/ do filme. Uma pasta em um provedor de arquivos (Google Drive, iCloud Drive, Dropbox) pode manter seus arquivos "sem dados" até serem abertos, então abra ou copie um arquivo antes de medi-lo. Arquivos que uma biblioteca mantém são copiados, nunca movidos para fora dela.
  • brief <caminho>, como argumento ou de uma linha BRIEF: leia o briefing; ele responde a §0.
    • formats: [] é minha escolha de três. Para um promo ou um filme em capítulos, um, dois ou três nomeados são os formatos dos storyboards, nessa ordem, e eu escolho o resto, cada um diferente; de um release e de um tutorial, um formato é deles (whatsnew, tutorial), nunca preenchido. look: null é a folha de visuais (§4).

    • frame: em que o produto é mostrado, qualquer que seja o formato; null é o próprio formato (um navegador para um walkthrough, um terminal para uma linha de comando, uma janela Mac para um tutorial), minha escolha.

      • window: o aplicativo em sua janela macOS (PARTS.window).
      • macbook: um MacBook de frente, a janela do aplicativo ou o navegador do site em sua tela (PARTS.laptop, PARTS.notch desenhado por último).
      • imac: um iMac de frente, em seu suporte, a janela do aplicativo ou o navegador do site em sua área de trabalho (PARTS.desktop: seu retângulo é o corpo, 547 : 375, e o suporte é desenhado sob ele; color é uma das sete da Apple, ou o acento da marca para a mais próxima delas). Sem notch: a câmera está no bisel branco.
      • iphone, ipad: o dispositivo (PARTS.phone com PARTS.island desenhado por último; PARTS.tablet, deitado ou em pé por seu retângulo, a câmera em sua borda longa), o layout do próprio produto nele (§1), e cada clique é um toque: um disco suave que pressiona, com a ondulação do visual, nunca PARTS.ARROW; um tutorial diz tap.
      • browser: o produto como uma página em PARTS.browser, seu endereço real no campo.
      • terminal: PARTS.terminal, digitado com FILM.typed.
      • bare (o Apenas a UI do Studio): a UI do produto sozinha, um painel flutuante com cantos arredondados e uma sombra, sem janela cromada e sem dispositivo ao redor. O produto ainda está na tela: um filme sem nenhum é o formato Tipo cinético, não este.

      O quadro se mantém para cada cena que mostra o produto, em cada storyboard: um tutorial de um aplicativo iPhone é contado em um iPhone do primeiro passo ao último. Um formato que é ele mesmo uma superfície se adapta a ele: Browser walkthrough com iphone é o site no telefone naquela largura; Terminal com macbook ou imac é a janela do terminal na área de trabalho do Mac. Dispositivos em 3D é o único formato que mostra vários: o dispositivo escolhido lidera o cover-flow (o primeiro cartão a enfrentar a câmera, e aquele para o qual ele retorna), e os outros o seguem. Onde o quadro e um formato não se combinam, a escolha é minha (Stack do visual, com a cena no quadro sob a coisa).

      • A tela de um dispositivo é responsiva: o site do produto é renderizado na largura do dispositivo e em sua altura, no navegador do dispositivo. Um tutorial de site diz role para uma página que não cabe; um tutorial de aplicativo não precisa.
      • Um dispositivo em plano de fundo, no visual, nunca leva o quadro: é o visual daquela cena, não uma tela. Uma moldura de dispositivo (o iMac como uma estação de trabalho) é o quadro: o produto ainda está em uma janela no iMac.
  • productScreen: "…": uma imagem que mostra o produto no final de uma história que não tem, no momento certo, um quadro de um site que não existe. O Studio a abre para uma captura de tela (tudo que contém o produto: o aplicativo e um pouco ao redor, ou um site em um navegador largo o suficiente para que o texto da página não quebre). O caminho para a imagem é src/<product>.png, ou src/<product>/ se houver várias (para um corte que alterna entre dispositivos). O produto em ação (§1) é como o filme mostra essa imagem, ou nenhuma. null é a captura de tela em branco src/empty-product.png.
  • voice: null (voz), actor: null (humano, gravado), music: null (música, de src/audio/ na pasta de trabalho), musicGain: 0: faixa, voz e humano são nenhum, e a música não é alterada; eles dizem à §2 (§6 para vozes e ator, §7 para música) o que escolher.
    • voice e actor são strings do formato no Studio: uma voz de texto para fala ("mac" para say, "mlx:orc…" para um modelo mlx-audio) ou um ator de uma sessão de gravação ("actor:Noelle" das gravações de narração do kit, src/narration/actor-<nome>/run-<data>/). O Studio as oferece, e ouvir uma linha antes de escolher.
    • music é o nome de um arquivo na biblioteca, ou o nome de uma faixa que será feita no Studio (gerada pelo reel.mjs do kit-music). O Studio a reproduz e, feita, a coloca em src/audio/. O nome de uma faixa gerada é uma string curta: "minimal-acoustic".
    • opus (falso) prefere opus para a faixa de áudio final. A página lê AUDIO_FORMAT; em seu cabeçalho (o padrão do motor é AAC).
  • dub: null: uma linha de tempo de dublagem para um segundo áudio em outra língua, ou nulo. §6 para todas as instruções de dublagem.
  • deliverTo: para onde deliver.mjs (§8) entrega: nulo para entregar na pasta do projeto ou na pasta de trabalho padrão, ou um caminho absoluto. O Studio oferece a pasta de entrega no passo final.
  • projectRoot: onde ir para ler/escrever o código-fonte; nulo para o caminho do repositório do produto. O Studio pode ser invocado de um espaço de trabalho/área de projeto: uma pasta que mantém o filme e o projeto lado a lado.

O briefing é minha lista de materiais. §0 para a sessão de trabalho de planejamento.

Modo guiado: ?

Um prompt de diálogo que faz perguntas uma de cada vez, onde balas de marcador são respostas de um toque e itens de ação (itálico) são quando eu falo o que fazer, ou o agente pergunta e faz. Cada vez que ? é dito, eu começo do início.

  • Planejar: leia o briefing e cite a duração, os formatos, os looks, o quadro, a voz e a música.
  • Fazer storyboards: escreva os storyboards do formato que é um walkthrough. Numere cada passo e descreva o que acontece: cliques, rolagens, digitação, entrada de cena, saída de cena e transições. Salve como src/storyboards/<formato>.md e me mostre.
  • Fazer o filme: §1. Mencione a pasta de trabalho, me mostre o produto (abra a página, tire uma captura de tela que caiba), e me pergunte: "Qual é a aparência do produto?" Responda e continue construindo.
  • Editar: altere a velocidade de uma transição na página. Re-renderize ainda que a alteração seja pequena. §5.
  • Preparar vozes: §6, narração. §7 para música, se ainda não foi escolhida.
  • Entregar: §8.
  • Encerrar: limpeza.

Essas são minhas instruções. O agente pergunta ? e eu respondo, uma pergunta de cada vez, até que uma resposta seja "acabou" ou que o agente prossiga sozinho.


§0 Planejamento

  • A partir do briefing, usando a folha de visuais (src/looks.jpg, que o Studio faz — veja §4 para fazê-lo manualmente), diga a duração final e confirme os formatos.
  • Para um corte com cliques: clickcheck.
  • Para um corte com tipo: layoutcheck.
  • Para um tutorial: escreva o script (src/script.md: cena, o que mostrar, o que dizer, efeito/transição, duração padrão do efeito em segundos para pré-visualização) e cada cena em storyboards do formato do tutorial como src/storyboards/<formato>.md: passo numerado, descrição do que acontece e o que o narrador diz; duração por cena.

Transforme o briefing em storyboards. Termine §1.

§1 A página

A página é FILM.film em uma página que estende o motor. Ela define t de 0 (quadro 0) a DURATION em segundos e largura/altura (W, H, 16:9 da página, ou a proporção do formato), a RESOLUTION (1x = padrão 1920×1080 até a largura da página, e 1,5x e 2x são para retina; $W \times RESOLUTION$ é a largura de render real). FPS (24 ou 30), DURATION e CHAPTERS renderizam a linha do tempo. CLICKS são para clickcheck e para o cursor.

<!-- src/promo.html -->
<!DOCTYPE html><html><head><meta charset="utf-8">
<link rel="stylesheet" href="fonts/fonts.css">
<script src="../film.js"></script>
<script src="../fx.js"></script>
<script src="../parts.js"></script>
<script src="../type.js"></script>
<script>
FILM.film = {
  name: "Acme v2.4",
  W: 1920, H: 1080, RESOLUTION: 1.5,
  FPS: 30, DURATION: 12, CHAPTERS: [0, 8],
  LOOK: "preset-name",
  AUDIO: "narration.wav",
  CLICKS: [
    {t: 2.0, at: [960, 540], hold: 0.7}
  ],
  draw: (ctx, t, SCENE) => {
    // SCENE é a cena em que t está
    // Desenhe o quadro
  }
};
</script></head><body></body></html>

Dentro de draw, use SEEK(t) para obter a cena, capítulo e progresso local; KNOB(t, specs) para animar (molas, keyframes); EASE(t) para interpolação linear; LOOK para o visual, texto, tipografia, partes do Mac. FILM.typed(ctx, t, "texto", x, y) desenha texto digitado. FILM.cursor(ctx, t, x, y) desenha o cursor na posição. FILM.click(ctx, t, x, y, hold) até para o cursor e desenha um clique.

Construa a página. Renderize o filme: §2.

§2 Renderização de still

cd <work>
PAGE=src/promo.html node <kért>/scripts/render.mjs stills frames 0 4

Isso renderiza stills nos segundos 0 a 4, um por segundo. Pule para o tempo do clique para testar:

PAGE=src/promo.html node <kért>/scripts/render.mjs stills frames 1.9 2.6 0.1

still <dir> <t> faz um único quadro. sheet <dir> faz um por checkpoint. Abra-os na pasta frames/. §5 para remoção de stills parciais.

§3 para tipo cinético.

§3 Tipo cinético

Manchetes animadas, animação de texto e texto digitado usando TYPE.draw(ctx, t, spec).

// Exemplo de tipo rise
TYPE.draw(ctx, t, {
  text: "Acme v2.4",
  style: "rise",
  family: "Inter",
  weight: 700,
  size: 64,
  align: "center",
  color: "#fff",
  x: 960, y: 540,
  pace: [0, 1],     // intervalo em que a animação acontece
  emphasis: null     // ou { char: "2", color: "#ff6" }
});

Estilos (treze): rise, focus, settle, track, wipe, cascade, weight, split, flap, type, swap, odometer, decode. Cada um anima de forma diferente. type desenha letra por letra (como digitação). swap troca palavras. decode anima letras individualmente.

§4 para visuais e efeitos.

§4 Visuais e efeitos

O motor tem 23 predefinições de visual e a predefinição photo (que carrega uma imagem). Visuais são definidos em fx.js e selecionados por nome:

FILM.film.LOOK = "flat-clean";  // fundo sólido claro
// ou:
FILM.film.LOOK = "gradient-warm";
// ou:
FILM.film.LOOK = "field-soft";  // fundo de campo suave

Cada visual pode ser personalizado substituindo campos em fx.js, ou copiando uma predefinição:

FILM.film.LOOK = {
  backdrop: { type: "gradient", colors: ["#1a1a2e", "#16213e"], angle: 45 },
  finish: { vignette: 0.3, grain: 0.05 },
  effects: { glass: true, ripple: true }
};

Faça a folha de visuais: para ver os visuais, renderize um still de cada um em um tempo representativo (0,5 segundos após uma entrada) e faça uma folha(

PAGE=src/promo.html LOOK=flat-clean node <kért>/scripts/render.mjs stills looks/flat-clean 0.5

Então node <kért>/scripts/contact.mjs looks/*.png looks-sheet.jpg.

§5 para captura de vídeo.

§5 Captura de vídeo

cd <work>
PAGE=src/promo.html node <kért>/scripts/render.mjs video out.mp4 4

Isso renderiza um vídeo mp4 usando 4 workers. Opções:

  • FROM=2 TO=8 para renderizar apenas os segundos 2 a 8.
  • PREVIEW=1 para resolução mais baixa e mais rápida.
  • RESUME=1 para continuar uma renderização interrompida.
  • KEEP=1 para manter os stills após a renderização.
  • AUDIO=narration.wav para incluir áudio.
  • SHUTTER=180 para ângulo de obturador (padrão: 180°).
  • HEVC=1 para codec H.265.
  • ALPHA=1 para canal alfa (transparente, .mov ou .webm).

Formatos de saída: .mp4 (H.264), .mov (ProRes), .webm, .gif.

Quando o vídeo estiver pronto, mostre-o ao usuário. Se precisar de edição, altere a página e re-renderize apenas a seção alterada. Sempre que renderizar, verifique se o vídeo parece bom.

§6 para narração.

§6 Narração

cd <work>
node <kért>/scripts/narrate.mjs src/story.json src/narration/  # gera aiff/
nnode <kért>/scripts/voice.mjs src/story.json  # ou: usa modelo mlx
node <kért>/scripts/narrate.mjs src/story.json src/narration/ --from src/voice/  # se gravado

O story.json contém cada passo do roteiro como um objeto:

[
  {"text": "Bem-vindo ao Acme v2.4.", "time": 0},
  {"text": "Agora com suporte a sincronização em nuvem.", "time": 3.5}
]

Isso gera narration.wav, narration.js e legendas .srt/.vtt.

§7 para música.

§7 Música

Se a música foi escolhida no briefing, copie o arquivo para src/audio/ e defina AUDIO na página para o caminho do áudio mixado.

Para mixar:

node <kért>/scripts/mix.mjs src/narration/narration.wav src/audio/music.mp3 out/soundtrack.wav --under 6 --lift 2

Isso ajusta a música para ficar 6 LU abaixo da voz enquanto ela fala, com 2 dB de aumento entre as linhas. Use o resultado como AUDIO.

§8 para entrega.

§8 Entrega

cd <work>
node <kért>/scripts/deliver.mjs <name> out/final.mp4 out/cover.jpg

Isso move out/final.mp4 e out/cover.jpg para a pasta de entrega (biblioteca de música, pasta do projeto ou ~/Downloads/<name>/). Então:

trash <work>  # remove a pasta de trabalho

Verifique se o vídeo está bom. Se sim, entregue.

Individual skills in this repo

This repo contains 1 individual skill — each has its own dedicated page.

Habilidades Relacionadas