Communitygithub.com

Film promo rendu par le code

Réalise une promo, une démo, un film de lancement ou une bande-annonce entièrement en code, avec un vrai son. Une page web dessine chaque image comme une fonction du temps, Chromium headless la rend sur le GPU, et ElevenLabs fournit voix, effets et musique depuis une feuille de cues. Une revue indépendante renvoie le film pour une révision.

Qu'est-ce que Film promo rendu par le code ?

Skill de film fini et réutilisable. L’image est du code, le son vient d’une feuille de cues, le rendu est un passage GPU dans Chromium headless, et une revue séparée fait partie du travail.

Compatible avec✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/rwfresh/all-of-them-video/tree/HEAD/skill/code-film

Demander à votre IA préférée

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

Documentation

Code film

Un film ici est une page web capable de dessiner n'importe quel instant sur demande (window.renderAt(t)). Un petit harnais demande chaque image dans Chromium sans tête, sur le GPU, et ffmpeg assemble les images et la bande sonore. Rien n'est filmé ou généré comme vidéo, donc l'image est exactement ce que le code dit, à n'importe quelle résolution, à chaque fois.

Le kit dans ce dossier a été éprouvé sur « Dial-A-Dev 98 » (thème hebdomadaire Builder Wars « Expédié en 1998 », novembre 2026) : 44 s, 1920x1080, onze plans, 1 326 images rendues en environ 45 s. Le code source complet de ce film se trouve dans examples/dial-a-dev-98/. Le modèle suit github.com/Vincentwei1021/mg-styles-15 (MIT), qui est également une bonne introduction aux styles de motion design.

Démarrer un film

bash ~/.claude/skills/code-film/new-film.sh ~/Work/<dossier-film>     # copie le kit, installe deux paquets locaux
cd ~/Work/<dossier-film>
# le son nécessite une clé ElevenLabs : l'utilisateur enregistre ELEVENLABS_API_KEY=... dans ./.env lui-même (ne jamais la demander dans le chat)
node harness/render.mjs film --stills 0,1,2        # PNG stills -> film/out/stills/
bash tools/build.sh v1                              # liste de repères, mixage, rendu, encodage X -> film/out/<filmName>_v1.mp4

Gardez le film dans son propre dossier, en dehors de tout dépôt de produit. Demandez avant d'installer quoi que ce soit de global.

Ordre de travail

  1. Brief. Produit, public, où il sera posté, durée, format (16:9, 9:16, 1:1). Pour Builder Wars, appelez get_video_guide et suivez ses règles (elles prévalent sur ce fichier).
  2. Traitement. Une idée, un accroche dans la première demi-seconde, une escalade, un moment héroïque à environ 60-75 % du temps d'exécution, et une image de fin composée. Choisissez un style et notez ses caractéristiques distinctives sous forme d'énoncés testables.
  3. Feuille de repères d'abord (film/cues.json). Écrivez le script vocal sous forme de lignes, avec des durées estimées. Les plans sont liés aux lignes et aux mots parlés, jamais à des secondes codées en dur, donc une nouvelle prise vocale retarde tout le film.
  4. Des images fixes avant le mouvement. Construisez l'apparence des deux ou trois images les plus difficiles et regardez-les en pleine taille. N'animez pas une image qui n'est pas encore digne d'une affiche.
  5. Plans. Un module par plan (contrat ci-dessous). Vérifiez chacun avec des images fixes et de petites planches contact.
  6. Voix. Audition (voix disponibles et trois conçues), enregistrez chaque ligne avec les timings des mots, puis laissez la feuille de repères déplacer les coupes : node tools/vo.mjs --voice <id>, puis --reuse --tempo 1.12 pour resserrer la lecture.
  7. Effets sonores et musique. Listez-les dans audio/sfx.json et audio/music.json, générez avec node tools/sfx.mjs --music. Chaque plan déclare ses propres signaux sonores, donc les impacts restent collés à l'image.
  8. Build (tools/build.sh), puis lisez vous-même la planche contact et corrigez ce que vous voyez.
  9. Jury. Donnez à un agent indépendant rubric.md, le fichier et le brief. Il n'a pas réalisé le film ; il note et retourne des corrections ordonnées. Appliquez-les, reconstruisez, et montrez ensuite seulement à l'utilisateur. Deux tours si le temps le permet.
  10. Terminer et remettre. tools/finish.sh encode pour X et fait l'affiche et la planche contact. Exécutez le vérificateur de la destination. L'utilisateur poste ; ne postez jamais pour eux.

Le contrat de la page

  • window.FILM = { width, height, fps, duration, shots, lines, sfx }, window.renderAt = async (t) => {...}, puis window.__ready = true.
  • Chaque image est une fonction pure de t : aléatoire ensemencé uniquement, pas d'horloges, pas de transitions CSS, pas d'état reporté d'une image à la suivante. Le harnais peut demander les images dans n'importe quel ordre et sur plusieurs navigateurs à la fois.
  • Un plan est { name, samples(lt), render(lt, post, renderer), overlay(g, lt), look(lt), sfx: [...] } :
    • render dessine du HDR linéaire dans post.scene ; overlay dessine des surimpressions 2D sur un canevas 1920x1080 (retourne true s'il a dessiné) ;
    • samples est le nombre d'échantillons de flou de mouvement pour cet instant (3 quand c'est calme, 12-20 pendant les mouvements rapides) ;
    • look retourne les réglages post (flou, flash, quantité de bande, glitch) ;
    • sfx liste { t, s, g, a, len } : temps local, nom du son, gain, a: 'peak' pour placer le moment le plus fort du son sur le repère, et une longueur de coupure facultative.
  • film/js/film.js mappe les noms de plans aux fabricas et dessine tout ce qui se superpose à chaque plan.
  • Interrupteurs de requête pour le développement du look : ?clean (pas de passage de bande), ?nocc (pas de sous-titres), ?mb=1, ?rs=0.5.
  • render reçoit également le numéro et le nombre de passages (render(lt, post, renderer, i, K)), et un plan peut définir shutter: 0. Sans flou de mouvement, les K passes sont libres pour d'autres choses : déplacer la lentille pour la profondeur de champ, la lumière clé pour les ombres douces, et la grille de pixels pour l'anticrénelage (le rig.js du storybook). look() peut retourner paper: true pour une finition propre (courbe tonale fidèle aux couleurs, grain, vignette) au lieu du passage de bande.
  • film.js peut exporter loadFonts (tout asynchrone qui doit se terminer avant la première image), buildCaptions et caption.

Cette machine (vérifié le 2026-11-11)

  • Chromium 155 à /usr/bin/chromium, RTX 4070 Ti SUPER. Le WebGL2 matériel nécessite --use-gl=angle --use-angle=gl-egl (le harnais les transmet et avertit s'il tombe en logiciel). WebGPU tombe en logiciel : utilisez WebGL2.
  • ffmpeg 9 avec libx264 et NVENC ; ImageMagick pour les planches contact ; pas de Blender, pas de numpy en dehors d'un venv.
  • Rendu 1080p complet : environ 0,03 s par image avec trois workers.

Notes ElevenLabs (vérifié le 2026-11-11)

  • La clé se trouve dans le .env du dossier du film. Une clé peut manquer user_read, donc le plan et les crédits restants peuvent ne pas être lisibles ; dites-le plutôt que de deviner.
  • Le plan utilisé autorise au maximum mp3_44100_128 (les formats supérieurs nécessitent le plan Creator). Le modèle vocal eleven_v4 fonctionne et accepte les balises audio comme [excited] ; les balises reviennent dans l'alignement et sont supprimées par vo.mjs.
  • Les voix disponibles lisent lentement pour une vente agressive. Une voix conçue (eleven.mjs design, puis voice-save.mjs, qui utilise un emplacement vocal) plus --tempo 1.12 a donné le rythme de l'infopublicité. Le réglage speed changeait à peine le timing.
  • Les effets sonores varient énormément en niveau et l'un d'eux est revenu silencieux : mix.mjs normalise le pic de chaque fichier, saute les fichiers quasi silencieux et le dit. Régénérez-les avec une invite plus simple (« Un gros applaudissement » a fonctionné là où un clap décrit est revenu silencieux trois fois).
  • Une voix de conteur lit lentement : la voix disponible George mesurait 2,25 mots par seconde. --tempo 1.25 l'a amenée à 2,7, un rythme de parole ordinaire. Déterminez la durée à partir des lignes enregistrées, pas d'un décompte de mots.
  • La musique générée se termine avant sa durée indiquée. mix.mjs trouve où le niveau se termine réellement et aligne cela avec la fin du film.
  • Une voix de personnage (par exemple, une mascotte de télévision pour enfants) lit au rythme que sa description lui donne : le même texte a pris 31 s avec « parle lentement aux tout-petits » et 24 s avec « rythme vif et enjoué ». Mettez le rythme dans la description, concevez deux ou trois descriptions (trois aperçus chacune), mesurez-les avec tools/audition-stats.mjs (durée, hauteur médiane, étendue de hauteur) et attendez-vous à --tempo 1.3 en plus. Décrivez un type ; ne nommez jamais un vrai personnage ou une vraie personne.
  • Une voix que l'utilisateur a choisie lors d'une audition peut sembler plus aiguë dans le film bien qu'elle mesure la même hauteur et luminosité : le modèle lit des lignes isolées environ 1,3 fois plus vite qu'un long passage d'audition, et --tempo en plus rend la voix plus aiguë et plus petite. vo.mjs --reuse --tempo 1.38 --pitch -2 l'abaisse à la même vitesse (les timings ne changent pas, donc remixez et réexécutez finish.sh sur l'ancien master ; pas de rendu). Faites des clips de comparaison à 0, -1, -2, -3 demi-tons pour l'oreille de l'utilisateur, et revérifiez le niveau de la piste vocale après (mix.vo).
  • voice-save.mjs <id généré> "<nom>" "<description>" enregistre un aperçu sur le compte (un emplacement vocal). Conservez les prises du narrateur précédent (cp -r audio/vo audio/vo_<nom>) avant d'en enregistrer un nouveau.
  • Les plans gratuits ne sont pas autorisés pour les publications commerciales. Si le plan est inconnu, dites-le à l'utilisateur.

Ce qui a mal tourné, pour que cela ne se reproduise pas

Image et code :

  • Estimer quand un mot est prononcé à partir de sa position dans le texte est faux jusqu'à une seconde (« 98 » est prononcé comme « quatre-vingt-dix-huit »). Utilisez les timings de mots enregistrés (mark(line, word)).
  • three.js dimensionne le texte extrudé plus grand que la taille nominale. Ajustez les mots à une largeur cible ; ne faites jamais confiance au nombre.
  • Un miroir plat éclairé par une lumière directionnelle devient uniformément blanc. Donnez aux disques et au chrome des lumières ponctuelles ou un environnement varié pour que le reflet soit un point chaud.
  • Les disques inclinés qui se chevauchent se croisent. Superposez-les en profondeur et limitez l'inclinaison.
  • Les reflets de sol flous transforment les étincelles d'arrière-plan en grilles de points : désactivez les étincelles dans le passage du miroir.
  • Le texte bitmap faux-gras (dessiner le texte deux fois, à un pixel d'écart) remplit les W et les M. ui98.js épaissit un trait seulement là où l'espace avec le trait suivant reste ouvert.
  • Un logo dont la moitié supérieure est proche de la couleur d'arrière-plan disparaît. Donnez aux lettres extrudées un contour foncé (outline dans makeLetters) et gardez leurs parois latérales proches du noir.
  • Le bruit de bande est coûteux à encoder. Rendez en lossless (--lossless), puis encodez une fois avec un plafond de débit.

Ce que le premier tour du jury a trouvé sur un film que je pensais terminé (score d'environ 6/10). Vérifiez cela avant le jury :

  • Le nom du produit doit être à l'écran vers 2 secondes environ et l'image 0 est la vignette. Un tiers inférieur permanent avec le nom, dès la première image, a résolu les deux.
  • Les surimpressions et les sous-titres couvraient les meilleures blagues. Après avoir placé une surimpression, regardez ce qu'il y a en dessous.
  • Le texte sortait de la zone de sécurité après les zooms avant. Vérifiez la dernière image de chaque zoom, pas la première.
  • Le même flash blanc et glitch sur chaque coupe ressemble à un modèle, tout comme un arrière-plan pour quatre plans et cinq starbursts identiques. Variez-les ; gardez le grand flash pour un ou deux impacts.
  • Les sous-titres qui semblent corrects en 1080p sont trop petits sur un téléphone : lettres d'environ 40 px de haut, dans leur propre bande.
  • Une prémisse qui ne paie jamais. Le film dit « à moins que quelqu'un ne décroche le téléphone », donc quelqu'un doit le faire.
  • Les impacts sonores qui atterrissent sous un mot parlé sont inaudibles. Déplacez l'impact après le mot et augmentez-le.

Ce que deux tours de jury ont trouvé sur le film du storybook en papier (environ 6/10, puis environ 7/10). Vérifiez cela en premier la prochaine fois :

  • Les captures d'écran réelles du produit affichées en plein écran ressemblent à un enregistrement d'écran et brisent le monde. Gardez-les à l'intérieur de la scène (un ordinateur portable dans le décor), comme deux grands recadrages avec du gros texte, changés avec un fondu enchaîné dans le monde de 16 images ou plus. Recadrez toute bordure pour que les côtés de l'écran n'aient pas de jointure, et étiquetez l'argent du jeu comme fictif.
  • Les chiffres doivent concorder entre les plans. « Millionnaire fictif » suivi d'un tableau montrant 9 100 $ a ruiné la réplique principale.
  • Le plan principal est resté immobile pendant 1,4 s. Gardez quelque chose en mouvement à travers chaque tenue (pièces qui tombent, lumières qui clignotent, une deuxième rafale lorsque la ligne se termine), et encadrez-la large dès sa première image.
  • Un vide vocal de plus d'une seconde avec seulement un fond faible ressemble à un silence d'antenne. Raccourcissez-le ou mettez-y une blague et un son.
  • Les formes plates avec des bords nets ressemblent à des illustrations vectorielles même avec du grain dessus. Un trait de coupe légèrement errant et un noyau de papier plus clair le long du bord (piece() dans le paper.js du storybook) ont résolu cela. Les panneaux doivent être des lettres découpées (cutSign), pas du texte imprimé.
  • Tout ce qui flotte a besoin d'un support visible (une tige, un ressort, une languette). Les faisceaux lumineux doivent être en papier opaque.
  • Les actions clés étaient trop petites pour un téléphone : un lancer de pièce, un changement de tête de couronne, une pression sur un bouton. Mettez l'action à l'échelle et poussez la caméra pour cela.
  • Les pop-ups se traversaient mutuellement et traversaient les pages qui tournent. La véritable géométrie de pliage fait que les plis côté lecteur se couchent en arrière dès qu'une double page commence à se fermer. Gardez ces plis debout, faites en sorte que chaque pop-up reste bas jusqu'à ce que sa double page soit presque ouverte (rise dans book.js), et cachez les pièces qui se trouvent à plat à l'intérieur du livre fermé.
  • Une page ne doit pas commencer à tourner avant la fin de sa phrase : le lead d'un plan ne doit pas être plus long que le gap avant lui.
  • Un sous-titre qui répète une chute que l'image délivre la gâche. cc sur une ligne peut contenir juste ses premiers mots ; le sous-titre part ensuite lorsque le reste est prononcé.
  • Terminez sur la première image : le livre se ferme sur sa couverture avec l'adresse sur un ruban. Il boucle également proprement.

Ce que l'utilisateur a changé après avoir regardé ce film (coupe v4) :

  • Une blague aux dépens d'un autre personnage (« Sam déteste Kim », un nuage d'orage) semblait méchante. Il a demandé que la blague soit sur le héros : Sam verse une larme, puis rêvasse d'être premier (« Rêve, Sam, rêve. »). Visez les blagues sur le héros.
  • Un slogan copié du produit (« Le revenu mensuel le plus élevé gagne ») lui a fait demander ce qui était gagné ; rien ne l'était. Vérifiez chaque affirmation du script par rapport à ce que le produit fait réellement avant de l'enregistrer.
  • Un nuage de pensée est plus haut que le cadre : levez la caméra avec lui, gardez ce qu'il reflète dans le cadre (le vrai tableau sous le tableau de rêve), et faites-le éclater quelques images avant que la page ne tourne pour que rien de haut ne chevauche la feuille.

Répartition du travail :

  • Construisez d'abord le look et le moteur en une session (deux ou trois images que l'utilisateur approuve), et écrivez le contrat de plan et un brief pour chaque plan dans des fichiers (SHOTS.md, BRIEFS.md). Ensuite, distribuez les plans à de nouveaux agents, un ou deux plans chacun, avec model: "opus" et ces fichiers comme brief. N'utilisez pas de forks pour cela : un fork fonctionne toujours sur le modèle et l'effort de la session et ne peut pas recevoir un moins cher (sur le film de styles, les forks représentaient 55 % de l'utilisation). Chaque agent ne possède que son propre fichier de plan ; écrivez d'abord les personnages partagés ; chargez les modules de plan un par un pour qu'un fichier cassé en cours d'édition ne fasse disparaître que son propre plan. Distribuez les corrections du jury de la même manière, à de nouveaux agents avec le fichier de plan et la liste de corrections, pas en reprenant les constructeurs ; gardez les fichiers du moteur pour la session principale.
  • Confiez le jury à un nouvel agent à chaque tour et dites au second de ne pas lire les notes du premier.

Processus :

  • pkill -f <motif> correspond au shell qui l'exécute. Écrivez le motif comme [p]attern.
  • Une erreur de page laisse le harnais en attente. Il abandonne après 45 s et imprime les erreurs de page ; ne le pipez pas via tail pendant le débogage, ou les erreurs n'arrivent qu'à la fin.

Skills associés