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.
| Arquivo | O que é |
|---|---|
template/promo.html | O 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.html | Um 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.js | O 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.js | Partes 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.html | Todas 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.js | O 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.js | Manchetes 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.mjs | stills <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.mjs | A 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.mjs | A 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.mjs | Uma 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.mjs | Uma 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.mjs | A 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.mjs | Cada 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.mjs | Cada 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.mjs | O ú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.mjs | As 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.mjsda á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>, ouCANCELLED,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=chromemantém Chrome. Sem nenhum deles, abre o navegador padrão;--no-openimprime 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_MUSICaponta para uma execução, senãomusicLibraryem~/Library/Application Support/manovella/settings.json(~/.config/manovella/settings.jsonfora do macOS; um~inicial é expandido);musicLibraryIgnoreno mesmo arquivo lista nomes de pastas nela para pular, edeliverToLibrary(true ou false, padrão false) diz se filmes finalizados também vão para ela. Nada é auto-detectado. Um arquivo mais antigo combrandLibraryebrandLibraryIgnoreé lido comomusicLibraryemusicLibraryIgnorecomdeliverToLibraryativado, o que fazia antes, e é reescrito com as novas chaves na primeira alteração feita nas Configurações do Studio. O mesmo arquivo aceitaprojectFolders(onde o Studio procura por produtos),pictureFolders(suas imagens de fundo; não definido:~/Pictures) eworkRoot(onde<nome>-worke, 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 ⌘, noManovella.app) escreve todos eles, edeliver.mjslêworkRoottambé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 emmusicLibraryIgnoresã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.txtou.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
deliverToLibraryativado 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.
- 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
brief <caminho>, como argumento ou de uma linhaBRIEF: 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.notchdesenhado 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.phonecomPARTS.islanddesenhado 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, nuncaPARTS.ARROW; um tutorial diz tap.browser: o produto como uma página emPARTS.browser, seu endereço real no campo.terminal:PARTS.terminal, digitado comFILM.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 commacbookouimacé 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, ousrc/<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 brancosrc/empty-product.png.voice: null(voz),actor: null(humano, gravado),music: null(música, desrc/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.voiceeactorsão strings do formato no Studio: uma voz de texto para fala ("mac"parasay,"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 peloreel.mjsdo kit-music). O Studio a reproduz e, feita, a coloca emsrc/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 ondedeliver.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>.mde 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 comosrc/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=8para renderizar apenas os segundos 2 a 8.PREVIEW=1para resolução mais baixa e mais rápida.RESUME=1para continuar uma renderização interrompida.KEEP=1para manter os stills após a renderização.AUDIO=narration.wavpara incluir áudio.SHUTTER=180para ângulo de obturador (padrão: 180°).HEVC=1para codec H.265.ALPHA=1para 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.