Communitygithub.com

BintzGavin/helios-skills

Workflow pour rendre une composition Helios en fichier vidéo. À utiliser pour automatiser la production vidéo ou exporter une animation de haute qualité.

Qu'est-ce que helios-skills ?

Ce skill permet de rendre automatiquement des compositions Helios en fichiers vidéo (MP4) via le package `@helios-project/renderer` dans un environnement Node.js. Il simplifie le processus en proposant une commande unique avec `npx` pour les cas simples, et un script personnalisable pour les pipelines avancés (gestion de pistes audio multiples, props d'entrée, rappels de progression). Le renderer capture la composition image par image en s'appuyant sur les modes `canvas` ou `dom`, et prend en charge les fichiers locaux ou les serveurs de développement. Le skill inclut également un guide de dépannage pour les problèmes courants (timeout, sortie noire, audio).

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Workflow de rendu vidéo

Le rendu est le processus de capture d'une composition image par image et de son encodage en fichier vidéo (par ex. MP4). Cela se fait à l'aide du package @helios-project/renderer dans un environnement Node.js.

Le chemin rapide : une seule commande

npx -y @helios-project/cli@latest render composition.html -o output.mp4
  • La durée, les fps et la taille proviennent de window.helios de la composition. Pour les définir vous-même, passez --duration, --fps, --width et --height.
  • Une page qui se dessine avec window.renderAt(t) a besoin de --duration.
  • --audio track.mp3 ajoute une bande sonore.
  • Un fichier HTML simple est rendu directement depuis le disque. Si un bundler doit construire la composition, exécutez npm run dev et passez son URL à la place.

Utilisez le script ci-dessous uniquement lorsque vous avez besoin d'un pipeline personnalisé, comme des props d'entrée, plusieurs pistes audio ou des rappels de progression.

1. Prérequis

Le renderer a besoin d'une URL pour la composition :

  • Un fichier sur le disque : file:///path/to/composition.html
  • Un serveur de développement : npm run dev, par ex. http://localhost:3000/composition.html
  • Toute autre URL accessible

2. Créer un script de rendu

Créez un fichier nommé render.js (ou render.ts si vous utilisez ts-node).

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

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

    // 2. Initialiser le Renderer
    const renderer = new Renderer({
        width: 1920,
        height: 1080,
        fps: 30,
        durationInSeconds: 10,
        // frameCount: 300, // Optionnel : Remplace durationInSeconds par un nombre exact d'images
        mode: 'canvas', // Utilisez 'dom' si votre animation utilise des éléments CSS/HTML

        // Configuration audio
        audioTracks: [
            { path: 'background.mp3', volume: 0.5 },
            { path: 'voiceover.wav', offset: 2 }
        ],
        audioCodec: 'aac',

        // Props d'entrée (contenu dynamique)
        inputProps: {
            title: "Rendu personnalisé",
            color: "#00ff00"
        }
    });

    console.log(`Début du rendu de ${compositionUrl}...`);

    // 3. Exécuter le rendu
    try {
        await renderer.render(compositionUrl, outputPath, {
            onProgress: (p) => {
                const percent = Math.round(p * 100);
                process.stdout.write(`\rProgression : ${percent}%`);
            }
        });
        console.log(`\nTerminé ! Enregistré dans ${outputPath}`);
    } catch (err) {
        console.error('\nÉchec du rendu :', err);
        process.exit(1);
    }
}

main();

3. Exécuter le rendu

Exécutez le script.

# Si vous utilisez ts-node
npx ts-node render.ts

# Si vous utilisez node (js compilé)
node render.js

Dépannage

« Page timeout » ou « Connection refused »

  • Assurez-vous que le serveur local hébergeant la composition est en cours d'exécution.
  • Vérifiez que l'URL est correcte et accessible dans un navigateur normal.

« Sortie noire » ou « Vidéo vide »

  • Assurez-vous que window.helios est exposé (ou que la page définit window.renderAt(t)).
  • Si vous utilisez mode: 'canvas', assurez-vous de dessiner sur un élément <canvas>.
  • Si vous utilisez mode: 'dom', assurez-vous que les éléments sont visibles.

« Le rendu se bloque »

  • Vérifiez si la composition contient des erreurs dans la console du navigateur.
  • Activez le traçage pour déboguer :
    await renderer.render(url, out, { tracePath: 'trace.zip' });
    

Problèmes audio

  • Assurez-vous que les chemins des fichiers audio sont corrects par rapport à l'endroit où le script est exécuté.
  • Si vous utilisez mode: 'dom' et que vous comptez sur l'audio implicite (par ex. balises <audio>), assurez-vous que les éléments sont présents dans le 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.

Skills associés