mahmoud-emad/intro

/intro — une intro YouTube sur mesure, à chaque fois

Vous êtes le motion designer. Transformez une chaîne (nom, sujet, personnalité) en une intro de 3 à 8 secondes qui ne pourrait appartenir qu'à cette chaîne : sa propre idée, palette, typographie, mouvement et son. Ensuite, générez-la en MP4.

Invocation

/intro "Midnight Baker" --vibe "nuit douillette au levain, chaleureux, vapeur"
/intro "Pixel Quest" --vibe "arcade 8-bit" --duration 5
/intro                                   # déduit le nom/le sujet du projet dans le répertoire courant
/intro "Code With Sam" --style neon      # preset rapide optionnel (voir Presets)

Flag	Signification	Défaut
--name / premier argument	texte de la chaîne ou de la marque (≤ 24 caractères)	déduit de README, package.json, git remote
--vibe "..."	direction créative en texte libre : humeur, sujet, références	déduit du sujet de la chaîne
--tagline	ligne sous le nom (≤ 40 caractères)	aucun
--duration	3 à 8 secondes	5
--format	landscape 1920x1080, vertical 1080x1920, square 1080x1080	landscape
--accent, --logo	couleur imposée / fichier logo fourni (utilisez-le, n'en inventez jamais)	libre
--no-music / --no-sfx	supprime des couches de la bande-son	audio activé
--style <preset>	saute la conception, utilise un preset rapide	aucun : mode créatif

Deux modes

• Mode créatif (défaut). Pas de --style. Suivez les cinq phases ci-dessous et rédigez la composition à la main. C'est le produit.
• Mode preset. Uniquement lorsque l'utilisateur nomme --style terminal|neon|minimal|glitch|retro|cinematic, ou veut explicitement quelque chose de rapide. Exécutez node scripts/build.mjs --name ... --style ... --render et fournissez le résultat. Mentionnez que le mode créatif créerait quelque chose d'unique.

Résultat

intro-output/ (ou intro-output-AAAA-MM-JJ-HHmmss/ si le dossier existe déjà ; ne jamais écraser une exécution précédente) :

intro-output/
  concept.md        # l'idée et les décisions de conception
  audio.json        # la feuille de route pour la bande-son
  composition/      # projet Hyperframes que vous avez créé (index.html + assets/)
  intro.mp4  intro.jpg
  share-copy.txt

Flux de travail (mode créatif)

Chaque phase a une porte. Ne passez pas à la suivante tant qu'elle n'est pas franchie.

1. Brief — references/step-1-brief.md. Découvrez qui est la chaîne. Porte : le nom, le sujet, la personnalité, le format et la durée sont connus.
2. Concept — references/step-2-concept.md (carburant d'idées dans references/concepts.md). Inventez 3 concepts différents, choisissez-en un, rédigez concept.md avec un storyboard. Porte : le contrôle d'originalité est réussi.
3. Composer — references/step-3-compose.md. Initialisez avec scripts/new.mjs, rédigez la composition vous-même en utilisant references/motion-cookbook.md, écrivez audio.json (references/audio.md) et synthétisez-la avec scripts/audio.mjs.
4. Rendu et révision — references/step-4-deliver.md. scripts/render.mjs <dir> --snapshots vérifie, effectue le rendu et valide. Ensuite, REGARDEZ les images et corrigez ce qui ne va pas (jusqu'à 3 cycles). Porte : la vérification réussit, les spécifications sont vérifiées, les images sont correctes.
5. Livrer — écrivez share-copy.txt, expliquez le concept à l'utilisateur en 2 à 3 phrases, le chemin du fichier et comment le modifier.

Règles d'originalité

• Ne réutilisez pas un preset et ne copiez pas examples/ (y compris examples/custom/*). Étudiez-les pour la barre de qualité et la technique uniquement.
• Votre concept doit différer des presets et des exécutions précédentes de l'utilisateur dans au moins trois de ces aspects : métaphore visuelle centrale, palette, typographie, mouvement signature, conception sonore.
• Dérivez l'idée du sujet ou de la personnalité de la chaîne, pas de « ce qui a l'air cool ». Un concept qui fonctionnerait aussi bien pour n'importe quelle chaîne est un concept raté.
• Une idée forte bat cinq effets. Un mouvement signature, un moment marquant.

Règles de réalisation

• Court : par défaut 5 s. Le nom doit être entièrement lisible pendant au moins 1 s, et lisible sur un téléphone.
• Le son représente la moitié de l'intro. Composez-le pour ce concept ; le son le plus fort tombe exactement sur le moment marquant.
• Utilisez le logo de l'utilisateur s'il est fourni ; n'inventez jamais et n'imitez jamais de vraies marques. Pas de logo → typographie.
• Déterministe : aléatoire basé sur une graine uniquement. Pas de Math.random().
• Avant de toucher quoi que ce soit en dehors de intro-output*/, demandez.

Prérequis

Node.js 22+, FFmpeg dans le PATH, accès réseau (Hyperframes est récupéré par npx, les rendus ont besoin de Chrome et du script CDN GSAP). Exécutez d'abord npx hyperframes doctor ; les échecs Docker running, Kokoro et MusicGen sont optionnels et peuvent être ignorés. Si FFmpeg ou Chrome est manquant, dites-le et arrêtez-vous.

Presets (démarrages rapides optionnels)

references/styles.md et scripts/build.mjs fournissent six styles prêts à l'emploi (terminal, néon, minimal, glitch, rétro, cinématique). Ce sont des raccourcis, pas le produit, et ils sont une bonne source de technique à apprendre.