Communitygithub.com

Fluxo de Trabalho de Renderização de Vídeo

Fluxo de trabalho para renderizar uma composição Helios em um arquivo de vídeo. Use quando precisar automatizar a produção de vídeo ou exportar uma animação de alta qualidade.

O que é Fluxo de Trabalho de Renderização de Vídeo?

Esta skill fornece um fluxo de trabalho completo para renderizar composições Helios em arquivos de vídeo (como MP4) usando um ambiente Node.js. Ela oferece uma via rápida com um único comando `npx` e um script personalizável para pipelines complexos que exigem propriedades de entrada, múltiplas faixas de áudio ou callbacks de progresso. A skill descreve os pré-requisitos (como fornecer a URL da composição a partir de um arquivo local ou servidor de desenvolvimento), a criação de um script de renderização com a classe `Renderer` (configurando dimensões, FPS, duração, faixas de áudio e propriedades de entrada), e a execução do script. Ela é compatível com qualquer plataforma que execute Node.js e Helios, como Claude Code, Cursor e Codex, e inclui uma seção de solução de problemas para problemas comuns como timeout, saída preta e falhas de áudio, com dicas sobre como habilitar rastreamento para depuração.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/BintzGavin/helios-skills/tree/HEAD/skills/workflows/render-video

Perguntar na sua IA favorita

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

Documentação

O que Fluxo de Trabalho de Renderização de Vídeo faz?

Renderização é o processo de capturar uma composição quadro a quadro e codificá-la em um arquivo de vídeo (por exemplo, MP4). Isso é feito usando o pacote @helios-project/renderer em um ambiente Node.js.

O caminho rápido: um comando

npx -y @helios-project/cli@latest render composition.html -o output.mp4
  • A duração, fps e tamanho vêm do window.helios da composição. Para defini-los você mesmo, passe --duration, --fps, --width e --height.
  • Uma página que se desenha com window.renderAt(t) precisa de --duration.
  • --audio track.mp3 adiciona uma trilha sonora.
  • Um arquivo HTML simples é renderizado diretamente do disco. Se um empacotador (bundler) precisar construir a composição, execute npm run dev e passe sua URL em vez disso.

Use o script abaixo somente quando precisar de um pipeline personalizado, como propriedades de entrada, várias faixas de áudio ou callbacks de progresso.

1. Pré-requisitos

O renderizador precisa de uma URL para a composição:

  • Um arquivo no disco: file:///path/to/composition.html
  • Um servidor de desenvolvimento: npm run dev, por exemplo, http://localhost:3000/composition.html
  • Qualquer outra URL acessível

2. Criar Script de Renderização

Crie um arquivo chamado render.js (ou render.ts se estiver usando ts-node).

import { Renderer } from '@helios-project/renderer';
import path from 'path';

async function main() {
    // 1. Configuração
    const compositionUrl = 'http://localhost:3000/composition.html';
    const outputPath = path.resolve('output.mp4');

    // 2. Inicializar Renderizador
    const renderer = new Renderer({
        width: 1920,
        height: 1080,
        fps: 30,
        durationInSeconds: 10,
        // frameCount: 300, // Opcional: Substitui durationInSeconds por contagem exata de quadros
        mode: 'canvas', // Use 'dom' se sua animação usar elementos CSS/HTML

        // Configuração de Áudio
        audioTracks: [
            { path: 'background.mp3', volume: 0.5 },
            { path: 'voiceover.wav', offset: 2 }
        ],
        audioCodec: 'aac',

        // Propriedades de Entrada (Conteúdo Dinâmico)
        inputProps: {
            title: "Renderização Personalizada",
            color: "#00ff00"
        }
    });

    console.log(`Iniciando renderização de ${compositionUrl}...`);

    // 3. Executar Renderização
    try {
        await renderer.render(compositionUrl, outputPath, {
            onProgress: (p) => {
                const percent = Math.round(p * 100);
                process.stdout.write(`\rProgresso: ${percent}%`);
            }
        });
        console.log(`\nConcluído! Salvo em ${outputPath}`);
    } catch (err) {
        console.error('\nFalha na renderização:', err);
        process.exit(1);
    }
}

main();

3. Executar Renderização

Execute o script.

# Se estiver usando ts-node
npx ts-node render.ts

# Se estiver usando node (js compilado)
node render.js

Solução de Problemas

"Timeout de página" ou "Conexão recusada"

  • Certifique-se de que o servidor local hospedando a composição está em execução.
  • Verifique se a URL está correta e acessível em um navegador comum.

"Saída preta" ou "Vídeo vazio"

  • Certifique-se de que window.helios está exposto (ou a página define window.renderAt(t)).
  • Se estiver usando mode: 'canvas', certifique-se de que está desenhando em um elemento <canvas>.
  • Se estiver usando mode: 'dom', certifique-se de que os elementos estão visíveis.

"Renderização trava"

  • Verifique se a composição tem erros no console do navegador.
  • Ative o rastreamento para depurar:
    await renderer.render(url, out, { tracePath: 'trace.zip' });
    

Problemas de Áudio

  • Certifique-se de que os caminhos dos arquivos de áudio estão corretos em relação ao local onde o script é executado.
  • Se estiver usando mode: 'dom' e contando com áudio implícito (por exemplo, tags <audio>), certifique-se de que os elementos estão presentes no DOM.

Individual skills in this repo

This repo contains 9 individual skills — each has its own dedicated page.

BintzGavin/helios-skills

Make a video, MP4, GIF, animation, music video, short film, explainer, chart animation, product demo, logo reveal or social clip from code. Write one HTML page that draws any frame from its time t, render it frame-exact to MP4 with Helios, check stills and contact sheets, and add a soundtrack. Use whenever the user asks for a video or an animation file.

BintzGavin/helios-skills

>- Story-first motion design philosophy for animated video: motion must earn its place; arc (establish, complicate, resolve); show vs tell; shots as units of thought; quiet vs loud motion; Disney principles with restraint; timing heuristics; composition; grammar by medium (product demos, logos, data viz, explainers); technical commitments (deterministic time, scrubbability, refs); cutting discipline; explicit anti-patterns. Use when planning, storyboarding, critiquing, or implementing programmatic or motion-driven video (Helios, Remotion, explainers, loops, UI capture, logo reveals), or when the user asks for motion direction, pacing, or visual-story structure.

BintzGavin/helios-skills

>- End-to-end production plan template for feeling-first cinematic product promos: brief interrogation, 45s beat structure (cold open through brand), hero-element metaphor, storyboard fidelity ladder, visual system (palette, type, camera, texture), motion mix and easing vocabulary, audio and captions, tooling (animatic through HTML or AE), deliverables matrix, accessibility, review milestones, and compromises to accept or refuse. Use when planning, pitching, storyboarding, or producing polished brand films for any SaaS or consumer product—not category-specific; pair with skills/design/animated-video-philosophy for broader motion principles.

BintzGavin/helios-skills

Patterns for using Helios with Framer Motion. Use when you want to use Framer Motion's physics and transitions but need frame-perfect synchronization with Helios.

BintzGavin/helios-skills

Patterns for using Helios with GSAP (GreenSock). Use when integrating GSAP timelines with the Helios timeline for precise scrubbing and rendering.

BintzGavin/helios-skills

End-to-end guided workflow for creating an explainer or walkthrough video. Extracts brand identity from the repo, generates a measured soundtrack, and produces a narrative-driven motion.dev composition rendered via Helios CLI. Use when making how-it-works, feature walkthrough, or educational videos.

BintzGavin/helios-skills

Motion design framework for programmatic video. Defines anti-slideshow architecture, visual layering, physics-based easing, choreography rules, and quality validation. Reference this skill from any guided video skill.

BintzGavin/helios-skills

End-to-end guided workflow for creating a promotional hype video. Extracts brand identity from the repo, generates beat-synced music, and produces a high-energy motion.dev composition rendered via Helios CLI. Use when making brand-aligned promo or hype videos.

BintzGavin/helios-skills

End-to-end guided workflow for creating a social proof or testimonial video. Extracts brand identity from the repo, generates a warm soundtrack, and produces a trust-building motion.dev composition rendered via Helios CLI. Use when making customer testimonial, review highlight, or social proof videos.

Habilidades Relacionadas