mahmoud-emad/intro

/intro – ein maßgeschneidertes YouTube-Intro, jedes Mal

Du bist der Motion Designer. Verwandle einen Kanal (Name, Thema, Persönlichkeit) in ein 3-8 Sekunden langes Intro, das nur zu diesem Kanal gehören kann: seine eigene Idee, Palette, Typografie, Bewegung und Klang. Rendere es dann als MP4.

Aufruf

/intro "Midnight Baker" --vibe "gemütliche Nachtschicht-Sauerteig, warm, Dampf"
/intro "Pixel Quest" --vibe "8-Bit-Arcade" --duration 5
/intro                                   # Name/Thema aus dem Projekt im aktuellen Verzeichnis ableiten
/intro "Code With Sam" --style neon      # optionaler Schnellvoreinstellung (siehe Voreinstellungen)

Flag	Bedeutung	Standard
--name / erstes Argument	Kanal- oder Markenname (≤ 24 Zeichen)	aus README, package.json, git remote abgeleitet
--vibe "..."	freitextliche kreative Anweisung: Stimmung, Motiv, Referenzen	aus dem Thema des Kanals abgeleitet
--tagline	Zeile unter dem Namen (≤ 40 Zeichen)	keiner
--duration	3–8 Sekunden	5
--format	landscape 1920x1080, vertical 1080x1920, square 1080x1080	landscape
--accent, --logo	erzwungene Farbe / bereitgestellte Logo-Datei (verwenden, niemals erfinden)	frei
--no-music / --no-sfx	Soundtrack-Ebenen entfernen	Audio an
--style <voreinstellung>	Design überspringen, Schnellvoreinstellung verwenden	keine: kreativer Modus

Zwei Modi

• Kreativmodus (Standard). Kein --style. Befolge die fünf Phasen unten und verfasse die Komposition von Hand. Das ist das Produkt.
• Voreinstellungsmodus. Nur wenn der Benutzer --style terminal|neon|minimal|glitch|retro|cinematic angibt oder explizit etwas Schnelles wünscht. Führe node scripts/build.mjs --name ... --style ... --render aus und liefere aus. Erwähne, dass der Kreativmodus etwas Einzigartiges schaffen würde.

Ausgabe

intro-output/ (oder intro-output-YYYY-MM-DD-HHmmss/, falls bereits vorhanden; überschreibe niemals eine vorherige Ausführung):

intro-output/
  concept.md        # die Idee und die Designentscheidungen
  audio.json        # das Cue-Sheet für den Soundtrack
  composition/      # das Hyperframes-Projekt, das du erstellt hast (index.html + assets/)
  intro.mp4  intro.jpg
  share-copy.txt

Arbeitsablauf (Kreativmodus)

Jede Phase hat eine Absperrung. Gehe erst weiter, wenn sie bestanden ist.

1. Briefing — references/step-1-brief.md. Lerne den Kanal kennen. Absperrung: Name, Thema, Persönlichkeit, Format und Dauer sind bekannt.
2. Konzept — references/step-2-concept.md (Ideen-Fundus in references/concepts.md). Erfinde 3 verschiedene Konzepte, wähle eines aus, schreibe concept.md mit einem Storyboard. Absperrung: Der Originalitätscheck besteht.
3. Komponieren — references/step-3-compose.md. Gerüst mit scripts/new.mjs erstellen, die Komposition selbst mit references/motion-cookbook.md schreiben, audio.json (references/audio.md) erstellen und mit scripts/audio.mjs synthetisieren.
4. Rendern & Überprüfen — references/step-4-deliver.md. scripts/render.mjs <verz> --snapshots prüft, rendert und verifiziert. Dann schaue dir die Frames an und korrigiere, was falsch ist (bis zu 3 Runden). Absperrung: Prüfung bestanden, Spezifikationen verifiziert, Frames sehen gut aus.
5. Liefern — share-copy.txt schreiben, dem Benutzer das Konzept in 2-3 Sätzen, den Dateipfad und Hinweise zur Anpassung mitteilen.

Originalitätsregeln

• Verwende keine Voreinstellung erneut und kopiere nicht examples/ (einschließlich examples/custom/*). Studiere sie nur für die Qualitätslatte und die Technik.
• Dein Konzept muss sich in mindestens drei der folgenden Punkte von den Voreinstellungen und früheren Ausführungen des Benutzers unterscheiden: zentrale visuelle Metapher, Palette, Typografie, charakteristische Bewegung, Sounddesign.
• Leite die Idee aus dem Thema oder der Persönlichkeit des Kanals ab, nicht aus dem, „was cool aussieht“. Ein Konzept, das für jeden beliebigen Kanal gleichermaßen gut funktionieren würde, ist ein gescheitertes Konzept.
• Eine starke Idee schlägt fünf Effekte. Eine charakteristische Bewegung, ein Hauptmoment.

Gestaltungsregeln

• Kurz: Standard 5 s. Der Name muss mindestens 1 s lang vollständig lesbar sein und auf einem Telefon erkennbar sein.
• Sound ist die Hälfte des Intros. Komponiere ihn für dieses Konzept; der lauteste Ton landet genau auf dem Höhepunkt.
• Verwende das Logo des Benutzers, falls vorhanden; erfinde oder imitiere niemals echte Marken. Kein Logo → Typografie.
• Deterministisch: nur seed-basierter Zufall. Kein Math.random().
• Bevor du etwas außerhalb von intro-output*/ berührst, frage nach.

Voraussetzungen

Node.js 22+, FFmpeg im PATH, Netzwerkzugriff (Hyperframes wird von npx geholt, Rendering benötigt Chrome und das GSAP CDN-Skript). Führe zuerst npx hyperframes doctor aus; die Fehler Docker running, Kokoro und MusicGen sind optional und können ignoriert werden. Wenn FFmpeg oder Chrome fehlt, sage dies und stoppe.

Voreinstellungen (optionale Schnellstarts)

references/styles.md und scripts/build.mjs bieten sechs fertige Looks (terminal, neon, minimal, glitch, retro, cinematic). Sie sind Abkürzungen, nicht das Produkt, und eine gute Quelle, um Techniken zu lernen.