pranav7/video-explainers

Video-Erklärer

Erstelle ein vertontes Erklärvideo im Stil von 3Blue1Brown zu jedem beliebigen Thema. Die Visualisierung erfolgt mit Manim (Community Edition), die Sprachausgabe mit Kokoro-82M, einem lokalen Text-to-Speech-Modell – ohne API-Key. Jede Zeile der Erzählung bestimmt das Timing der dazu passenden Animation.

Die Arbeit besteht aus zwei Teilen:

1. Du schreibst script.md: jede Zeile der Erzählung und was auf dem Bildschirm zu sehen ist, während sie abgespielt wird. Du hast den Kontext, also schreibst du das Skript.
2. Ein Unter-Agent baut das Video aus script.md: Er schreibt die Szenen, rendert sie, prüft das Layout und erstellt den finalen Render.

Der Build benötigt etwa 20 Tool-Aufrufe, und jeder Aufruf sendet den gesamten Kontext erneut. Ein neuer Unter-Agent hat einen kleinen Kontext, daher ist der Build dort günstiger und schneller. Der Unter-Agent läuft auch im Hintergrund, sodass der Benutzer parallel mit dir weiterarbeiten kann.

Der explainer-Befehl erledigt den Rest der Arbeit. Er muss sich im PATH befinden. Für die Einrichtung siehe https://github.com/pranav7/video-explainers. Führe explainer -h für die Befehle aus.

0. Einrichtung (einmal pro Maschine)

Führe explainer doctor aus. Es installiert Homebrew-Pakete, Schriftarten, TinyTeX, eine Python-Umgebung sowie die Icons und testet dann Kokoro und LaTeX. Es kann bedenkenlos erneut ausgeführt werden. Führe es aus, wenn ein Befehl aufgrund einer fehlenden Abhängigkeit fehlschlägt.

1. Planung

• Ort. Wenn es in der Unterhaltung um ein Projekt mit einem eigenen Ordner für Dokumente geht, lege das Video in einem videos/<slug>/-Ordner dort ab. Ansonsten verwende ~/Movies/explainers/<slug>/.
• Zielgruppe und Länge. Frage nur nach, wenn die Anfrage diese nicht klar macht. Standard: ein neugieriger Erwachsener ohne Vorkenntnisse zum Thema, 2 bis 4 Minuten.
• Länge des Skripts. Kokoro spricht etwa 170 Wörter pro Minute, ein 3-minütiges Video hat also etwa 500 Wörter Erzählung. Schreibe ein Kapitel für jeweils 30 bis 45 Sekunden.

Wähle die Form, die zum Thema passt.

Für ein Konzept (einen Algorithmus, eine Idee in Mathe oder Wissenschaft):

1. Beginne mit einer konkreten Frage oder einem Rätsel, nicht mit einer Definition.
2. Baue Intuition auf anhand eines konkreten Beispiels, das der Zuschauer sehen kann.
3. Verallgemeinere und zeige erst dann die Formel. Die Formel benennt das, was sie bereits gesehen haben.
4. Beende mit der Schlüsselidee in einem Bild.

Für eine Situation (einen fehlgeschlagenen Durchlauf, einen Vorfall, ein Design, einen Arbeitsrückstand):

1. Beginne mit dem, was passiert ist, mit den echten Zahlen.
2. Zeige den Mechanismus, der es verursacht hat, Schritt für Schritt.
3. Zeige, was sich ändert: die Behebung, die Entscheidung oder der nächste Schritt.
4. Beende mit einem Bild des gesamten Systems mit der Änderung.

2. script.md schreiben

Schreibe script.md im Video-Verzeichnis in diesem Format:

# Warum die Bestellseite langsam ist

Für Ingenieure im Team. Ungefähr 3 Minuten.

## Farbpalette

| Konzept | Farbe |
| --- | --- |
| Der API-Server | SKY |
| Die Datenbank | VIOLET |
| Langsam, verschwendete Arbeit | CORAL |
| Die Behebung | MINT |

## 1. Haken: Fünfzig Bestellungen, fünfzig Abfragen

- „Die Bestellseite braucht vier Sekunden, um fünfzig Bestellungen zu laden.“
  - Eine Browserkarte mit „4.1 s“ in Koralle und eine Liste von 50 Bestell-Tags.
- „Der Server fragt die Datenbank einmal pro Bestellung ab.“
  - Eine API-Server-Karte und eine Datenbank-Karte. Pakete reisen zwischen ihnen, eines pro Bestellung.

Jede Kapitelüberschrift ist ## <Nummer>. <Szenenname>: <Kapiteltitel>. Der Builder erstellt eine Szenenklasse für jedes Kapitel. Die Kapiteltitel werden zu Kapitelmarken im Video.

Der Builder kann diese Unterhaltung nicht sehen. Setze jeden Namen, jede Zahl, jede Bezeichnung und jeden Wert, der auf dem Bildschirm erscheinen soll, in das Skript.

Der Erzähltext wird genau so vorgelesen, wie er geschrieben steht:

• Schreibe die gesprochene Form: „x Quadrat“, „zwei pi r“, „P O Nummer“, „v zwei“. Setze kein LaTeX, keine Symbole und keinen Code in die Erzählung.
• Schreibe einen Satz pro Zeile, höchstens zwei. Jede Zeile ist eine visuelle Änderung.
• Wenn Kokoro ein Wort falsch ausspricht, gib seine Phoneme inline an: [Kokoro](/kˈOkəɹO/).
• Die Standardstimme ist af_heart. Wenn dem Benutzer die Stimme wichtig ist, führe explainer voices aus und lasse ihn zuhören (afplay voice-samples/<name>.wav).

Beschreibe unter jeder Zeile das Bild, nicht eine Folie. Nenne die Objekte, was sie zeigen und was sich bewegt. Gib jedem Konzept eine Farbe aus der Palette.

Verwende Palettenfarben aus den Akzentfarben des Baukastens: SKY, MINT, AMBER, CORAL, VIOLET, AQUA, ROSE, PEACH, LIME. Der Baukasten hat auch Neutrale für Dinge, die kein Konzept sind: SUBTLE, FAINT, INK. Der Baukasten enthält Karten, Tags, Tabellen, Code-Fenster, Pipelines, Sequenzdiagramme, Zeitachsen, Bäume, Hervorhebungen, Diagramme, große Zahlen und Lucide-Icons. Beschreibe Bilder, die sie verwenden.

Zeige jede Zahl so, wie sie ist. Bitte nicht um eine Zahl, die von Null hochzählt.

3. Den Build übergeben

Starte den Builder als Unter-Agenten. Wenn deine Anweisungen einen Agententyp oder ein Modell für Build-Arbeiten nennen, verwende diese. Gib ihm diese Eingabeaufforderung:

Baue das Erklärvideo für <Verzeichnis>/script.md. Führe `explainer guide` aus und folge ihm. Melde den Videopfad, die Dauer und jeden Layout-Warnhinweis, den du belassen hast, mit Begründung.

Wenn der Benutzer Untertitel angefordert hat, füge der Eingabeaufforderung „Rendere mit --captions.“ hinzu.

Teile dem Benutzer mit, dass das Video in Arbeit ist, und fahre dann mit anderen Arbeiten fort. Wenn du keinen Unter-Agenten starten kannst, führe explainer guide aus und führe seine Schritte selbst durch.

4. Auslieferung

Wenn der Builder berichtet, öffne <Verzeichnis>/video.mp4 (auf macOS mit open). Teile dem Benutzer mit:

• Den Dateipfad und die Dauer.
• Dass das Video Kapitelmarken enthält.
• Alle Probleme, die der Builder offen gelassen hat.

Frage, was geändert werden soll. Um eine Änderung vorzunehmen, sende sie an denselben Builder, wenn deine Werkzeuge ihm eine Nachricht senden können, da der Builder seinen Kontext behält. Andernfalls starte einen neuen Builder mit der Änderung. Wenn die Änderung die Erzählung betrifft, bearbeite zuerst script.md.