Communitygithub.com

Helios Rendering Workflow

Workflow zum Rendern einer Helios-Komposition in eine Videodatei. Verwenden Sie dies, wenn Sie die Videoproduktion automatisieren oder eine hochwertige Animation exportieren möchten.

Was ist Helios Rendering Workflow?

Diese Fähigkeit automatisiert den Prozess des Renderns einer Helios-Komposition in eine Videodatei (z.B. MP4) unter Verwendung des `@helios-project/renderer`-Pakets. Sie bietet eine schnelle Ein-Befehl-Lösung für Standardfälle mit `npx @helios-project/cli render`, bei der Dauer, fps und Größe automatisch aus der Komposition übernommen werden können, aber auch manuell überschrieben werden können. Für komplexere Pipelines steht ein detailliertes Node.js-Skript zur Verfügung, das erweiterte Funktionen wie benutzerdefinierte Eingabeeigenschaften (`inputProps`), mehrere Audiospuren und Fortschritts-Callbacks unterstützt. Die Fähigkeit behandelt Fehlerszenarien wie Timeouts, leere Ausgaben und Audioprobleme und ist für Entwickler gedacht, die Video-Exporte in CI/CD-Pipelines, automatisierte Design-Tools oder andere Workflows integrieren müssen, die eine programmatische Videoproduktion erfordern.

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

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Render-Video-Workflow

Rendering ist der Prozess, bei dem eine Komposition Bild für Bild erfasst und in eine Videodatei (z.B. MP4) kodiert wird. Dies geschieht mit dem Paket @helios-project/renderer in einer Node.js-Umgebung.

Der schnelle Weg: Ein Befehl

npx -y @helios-project/cli@latest render composition.html -o output.mp4
  • Dauer, fps und Größe stammen aus window.helios der Komposition. Wenn Sie diese selbst festlegen möchten, übergeben Sie --duration, --fps, --width und --height.
  • Eine Seite, die sich selbst mit window.renderAt(t) zeichnet, benötigt --duration.
  • --audio track.mp3 fügt einen Soundtrack hinzu.
  • Eine einfache HTML-Datei wird direkt von der Festplatte gerendert. Wenn ein Bundler die Komposition erstellen muss, führen Sie npm run dev aus und übergeben Sie stattdessen die URL.

Verwenden Sie das folgende Skript nur, wenn Sie eine benutzerdefinierte Pipeline benötigen, z.B. Eingabeeigenschaften, mehrere Audiospuren oder Fortschritts-Callbacks.

1. Voraussetzungen

Der Renderer benötigt eine URL für die Komposition:

  • Eine Datei auf der Festplatte: file:///pfad/zu/komposition.html
  • Ein Dev-Server: npm run dev, z.B. http://localhost:3000/komposition.html
  • Jede andere erreichbare URL

2. Render-Skript erstellen

Erstellen Sie eine Datei namens render.js (oder render.ts, wenn Sie ts-node verwenden).

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

async function main() {
    // 1. Konfiguration
    const compositionUrl = 'http://localhost:3000/komposition.html';
    const outputPath = path.resolve('output.mp4');

    // 2. Renderer initialisieren
    const renderer = new Renderer({
        width: 1920,
        height: 1080,
        fps: 30,
        durationInSeconds: 10,
        // frameCount: 300, // Optional: Überschreibt durationInSeconds mit einer exakten Bildanzahl
        mode: 'canvas', // Verwenden Sie 'dom', wenn Ihre Animation CSS/HTML-Elemente verwendet

        // Audio-Konfiguration
        audioTracks: [
            { path: 'hintergrund.mp3', volume: 0.5 },
            { path: 'sprachaufnahme.wav', offset: 2 }
        ],
        audioCodec: 'aac',

        // Eingabeeigenschaften (dynamischer Inhalt)
        inputProps: {
            titel: "Benutzerdefinierter Render",
            farbe: "#00ff00"
        }
    });

    console.log(`Starte Rendern von ${compositionUrl}...`);

    // 3. Render ausführen
    try {
        await renderer.render(compositionUrl, outputPath, {
            onProgress: (p) => {
                const percent = Math.round(p * 100);
                process.stdout.write(`\rFortschritt: ${percent}%`);
            }
        });
        console.log(`\nFertig! Gespeichert unter ${outputPath}`);
    } catch (err) {
        console.error('\nRendering fehlgeschlagen:', err);
        process.exit(1);
    }
}

main();

3. Render ausführen

Führen Sie das Skript aus.

# Wenn ts-node verwendet wird
npx ts-node render.ts

# Wenn node verwendet wird (kompilierte js)
node render.js

Fehlerbehebung

"Page timeout" oder "Connection refused"

  • Stellen Sie sicher, dass der lokale Server, der die Komposition hostet, läuft.
  • Überprüfen Sie, ob die URL korrekt und in einem normalen Browser erreichbar ist.

"Schwarze Ausgabe" oder "Leeres Video"

  • Stellen Sie sicher, dass window.helios verfügbar ist (oder die Seite window.renderAt(t) definiert).
  • Wenn Sie mode: 'canvas' verwenden, stellen Sie sicher, dass Sie auf ein <canvas>-Element zeichnen.
  • Wenn Sie mode: 'dom' verwenden, stellen Sie sicher, dass die Elemente sichtbar sind.

"Rendering hängt"

  • Überprüfen Sie, ob die Komposition Fehler in der Browser-Konsole aufweist.
  • Aktivieren Sie Tracing zum Debuggen:
    await renderer.render(url, out, { tracePath: 'trace.zip' });
    

Audioprobleme

  • Stellen Sie sicher, dass die Pfade zu den Audiodateien relativ zu dem Ort, an dem das Skript ausgeführt wird, korrekt sind.
  • Wenn Sie mode: 'dom' verwenden und sich auf implizite Audioquellen (z.B. <audio>-Tags) verlassen, stellen Sie sicher, dass die Elemente im DOM vorhanden sind.

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.

Verwandte Skills