Was macht Reel aus Rohmaterial?
Bewährt auf zwei Reels: Linux Day 2 und Linux Day 1 (mit Soundeffekten). library/Reel.tsx ist das Day-1-Reel. Kopiere seine Muster. Erfinde keinen neuen Stil.
Funktioniert auf macOS und auf Linux / Windows WSL. Einrichtung: siehe README.md im Repository.
Harte Regeln
- Jedes Overlay wird von
work/words.txtSekunden getimed. Rätsele niemals eine Zeit. - Verwende nur Komponenten aus
src/(library). Füge eine neue Komponente nur hinzu, wenn keine Library-Komponente zu einem Beat passt. - Halte das Gesicht frei. Sicherheitszonen (1080x1920):
- Obere Tags und Titel: y 90 bis 400.
- Gesicht und Hals: y etwa 450 bis 1350. Hier nichts außer Vollbild-Titelkarten (max. 3 s).
- Alles andere kommt unterhalb des Halses (der ersten Knopf des Hemds): y 1360 bis 1880.
Panelbeginnt beiBELOW_NECK(1360). Verwendefit, um ein hohes Panel so zu skalieren, dass es bei 1880 endet. - Finde die Halslinie für jedes neue Video: nimm einen Frame mit einem y-Gitter und schau nach. Aktualisiere
BELOW_NECKinui.tsx.
- Rendere das vollständige Video nur, wenn der Benutzer im Chat danach fragt. Verwende
scripts/stills.shzur Überprüfung. Ein Hook blockiertremotion renderohneRENDER_OK=1. - Lade nichts herunter (Modelle, Schriftarten, Musik, Soundpacks) ohne den Benutzer zu fragen.
- Lies
reference/known-problems.md, bevor du etwas debugst. - In OpenCode macht das Plugin
~/.config/opencode/plugins/reel-from-rawdieselbe Arbeit wie die Claude-Hooks (Render-Block, Typcheck, Stills-Erinnerung). Öffne die Blattbilder mit dem Read-Tool. Wenn dein Modell keine Bilder sehen kann, bitte den Benutzer, die Blätter zu überprüfen.
Bereichsregeln (genau befolgen)
- Tue nur, worum der Benutzer gebeten hat. Ändere nur die Dateien und Werte, die die Anfrage benötigt.
- Eine Prüfung (Typcheck, Stills-Check, Erinnerung von einem Hook oder Plugin) ist nur eine Prüfung. Behebe nur das, was eine Regel in dieser Datei oder in
reference/style-spec.mdverletzt. Gestalte niemals um, füge keine Komponente oder Szene hinzu, und ändere keinen Text, kein Timing oder keine Lautstärke aufgrund einer Prüfung. - Wenn du denkst, dass etwas anderes geändert werden sollte, teile dem Benutzer dies in einer Zeile mit. Ändere es nicht.
- Bearbeite niemals
~/.claude/skills/reel-from-raw/(dieses Skill), während du an einem Video arbeitest. Bearbeite nur das Videoprojekt. - Eine von dir erstellte Testdatei (z. B.
src/__probe.ts) muss gelöscht werden, bevor du fertig bist.
Arbeitsablauf (neues Video)
Führe jeden Schritt aus. Jedes Skript gibt bei Erfolg OK: aus. Höre bei einem ERROR auf und behebe ihn.
| # | Schritt | Befehl / Aktion |
|---|---|---|
| 1 | Projekt erstellen | bash ~/.claude/skills/reel-from-raw/scripts/new-project.sh <dir> <raw.mp4> (z. B. ~/Coding/motion-videos/<name>). Es kopiert die Bibliothek, die Sounddateien und die Hooks und installiert npm-Pakete (oder klont sie von $REEL_SEED). |
| 2 | Transkribieren | bash ~/.claude/skills/reel-from-raw/scripts/transcribe.sh <dir> hi (verwende en für nur Englisch). Korrigiere dann Fehlhörungen mit reference/glossary.md. |
| 3 | Stille entfernen | python3 ~/.claude/skills/reel-from-raw/scripts/cuts.py <dir>. Verwende --start/--end, um einen Fehlstart oder Ausklang zu entfernen. |
| 4 | Beat-Blatt | Folge reference/beat-sheet-prompt.md. Schreibe work/beats.md. Zeige es dem Benutzer, wenn er den Plan genehmigen möchte. |
| 5 | Bauen | src/Reel.tsx ist das Day-1-Reel. Schreibe es aus dem Beat-Blatt neu. Setze in Root.tsx die id (z. B. LinuxDay3) und den tatsächlichen handle. Lösche Szenenkomponenten, die das Reel nicht verwendet. Behalte die Helfer At und r(). |
| 6 | Typcheck | Automatisch: Ein Hook führt tsc --noEmit nach jeder Bearbeitung aus. Behebe jeden gemeldeten Fehler. |
| 7 | Visuelle Prüfung | bash ~/.claude/skills/reel-from-raw/scripts/stills.sh <dir> auto, dann lies jedes out/stills/sheet*.jpg. Überprüfe auch Beat-Frames: stills.sh <dir> 120,450,.... Prüfe gegen reference/style-spec.md. Behebe und wiederhole. |
| 8 | Soundprüfung | Soundeffekte kommen mit den Komponenten (siehe „Soundeffekte“). Stelle sicher, dass public/sfx/typing.wav und public/sfx/pop.wav existieren. Füge keine Sounds außerhalb der Tabelle hinzu, es sei denn, der Benutzer fordert dies an. |
| 9 | Vorschau | Füge einen launch.json-Eintrag hinzu, der npx remotion studio --no-open --port <free> im Projekt ausführt. Gib dem Benutzer die URL http://localhost:<port>. Der Benutzer hört dort die Sounds. |
| 10 | Rendern (nur auf Anfrage) | RENDER_OK=1 npx remotion render <Id> out/<name>.mp4 --gl=angle (im Hintergrund ausführen, etwa 3-5 Minuten für 90 s). |
Soundeffekte
src/sfx.tsx hält alle Sounds. SFX listet die Sounds auf. <Sfx src at volume frames name> spielt einen Sound at Frames in der aktuellen Sequenz ab.
Schlüssel in SFX | Quelle | Internet benötigt |
|---|---|---|
whoosh, ding, click, switch, whip | @remotion/sfx (Dateien auf remotion.media) | Ja, für Studio und Render |
pop | public/sfx/pop.wav (vom Code erstellt) | Nein |
typing | public/sfx/typing.wav (erstellt von scripts/make-typing-sound.py) | Nein |
Die Bibliothekskomponenten spielen diese Sounds bereits ab. Du fügst sie nicht von Hand hinzu.
| Moment | Datei (im Projekt) | Sound | Lautstärke |
|---|---|---|---|
| Hook-Titel / Sub-Chip | scenes/Intro.tsx (Hook) | whoosh / whip | 0.54 / 0.48 |
| Day-Titelkarte | scenes/Intro.tsx (DayTitle) | whoosh / ding | 0.6 / 0.36 |
| Command-List-Chips | scenes/Intro.tsx (CommandList) | pop pro Chip | 0.36 |
| Command-Tag / Command-Name | scenes/Commands.tsx (CommandTag) | whoosh / switch | 0.54 / 0.48 |
| Notepad-Zeilen | scenes/Commands.tsx (NoteCard) | typing pro Zeile | 0.6 |
| Unteres Panel erscheint | ui.tsx (Panel) | pop | 0.48 |
| Terminal-Befehl getippt | ui.tsx (Terminal) | typing pro Befehlszeile | 0.6 |
| Light Leak | Reel.tsx | whoosh | 0.48 |
| Done-Badge / Follow-Klick | scenes/Outro.tsx (DayDone, FollowCard) | ding / click | 0.48 / 0.72 |
Jedes <Sfx> ohne volume | sfx.tsx (Standard) | - | 0.42 |
Die Lautstärke reicht von 0 (stumm) bis 1 (voll). Halte jeden Sound unter der Stimme.
Häufige Anfragen (genaue Anleitung)
| Benutzer fragt | Tue genau dies |
|---|---|
| „Erhöhe / verringere alle Soundeffekte um N%“ | Multipliziere jedes volume={x} in einer <Sfx-Zeile und den Standardwert in sfx.tsx mit (1 ± N/100). Runde auf 2 Dezimalstellen. Berühre nicht CutVideo.tsx (das ist die Stimme). Führe grep -rn "<Sfx" src vorher und nachher aus und zeige die geänderten Werte. |
| „Ändere nur die Lautstärke des Tastatur-/Tipp-Sounds“ | Ändere nur die Zeilen mit src={SFX.typing} (ui.tsx Terminal und scenes/Commands.tsx NoteCard). |
| „Ändere nur Sound X“ | Finde seine Zeile in der obigen Tabelle. Ändere nur die volume. |
| „Tastatur-Sound ist zu leise / erstelle einen neuen“ | python3 ~/.claude/skills/reel-from-raw/scripts/make-typing-sound.py <project>/public/sfx/typing.wav. Behalte zuerst eine Kopie der alten Datei. Bearbeite die Zahlen im Skript nur, wenn der Benutzer eine andere Stimmung wünscht. |
| „Entferne einen Sound“ | Lösche diese eine <Sfx .../>-Zeile. |
| „Wo kann ich ihn vor dem Rendern hören?“ | Studio (Schritt 9). Drücke Play oder Leertaste. Studio lädt nach jedem gespeicherten Edit neu. |
| „Wie rendere ich selbst?“ | Terminal: cd <project> && npx remotion render <Id> out/<name>.mp4 --gl=angle. Studio-UI: Render-Button (rechtes Ende der Leiste über der Timeline) → Tab Video → Ausgabename festlegen → Video rendern. Fortschritt wird im Tab Jobs angezeigt. Die OpenGL-Einstellung ist bereits angle. |
| „Rendere es“ | Schritt 10, mit RENDER_OK=1. Gib dann den vollständigen Pfad der Ausgabedatei an. |
| „Ändere den Handle“ | Root.tsx defaultProps.handle. |
Wie Timing funktioniert
src/timeline.ts:CUTS(entfernte Rohsekunden),out(sec)ordnet eine Rohsekunde einem Ausgabe-Frame zu.<At from={rawSec} to={rawSec} name="...">zeigt einen Block für diesen gesprochenen Bereich.r(t0, t)gibt eine Frame-Verzögerung innerhalb eines Blocks, für „lass dies erscheinen, wenn das Wort bei t gesagt wird“.CutVideowechselt pro Segment zwischen Zoom 1.0 / 1.14 (Punch-In bei jedem Schnitt). Füge keinen weiteren Zoom hinzu.
Bibliothekskarte
| Datei | Exporte | Verwendung |
|---|---|---|
theme.ts | DISPLAY (Anton), SANS (Inter), MONO, Farben C, extrude() | Alle Texte und Farben. Keine neuen Schriftarten oder Farben. |
sfx.tsx | SFX, Sfx | Soundeffekte (siehe oben) |
ui.tsx | Pop, useIn, useOut, BELOW_NECK, Panel, TermFrame, Terminal | Spring-Einblendung, unteres Panel-Panel, getipptes Terminal |
scenes/Intro.tsx | Hook({title, sub, subAt}), DailyStep({children}), DayTitle({day}), CommandList({commands, line, lineAt}), LightLeak | Eröffnung, Abschnittsübergänge |
scenes/Commands.tsx | CommandTag({n, total, name, nameAt, meaning, meaningAt, color}), FolderPath, FileGrid, MoveSwap, NoteCard | Ein Thema pro Abschnitt: Tag oben, visuelles im Panel |
scenes/Commands.tsx (Day 2, fest codierter Text) | IdCard, OwnerSwap, PhoneApps, Snapshot, TopView, PdfSearch | Füge Props für den Text hinzu, bevor du einen wiederverwendest |
scenes/Outro.tsx | DayDone({day}), NextDay({day, commands, at}), FollowCard({handle}) | Ende (NextDay ist optional) |
Reel.tsx | Reel | Vollständiges Day-1-Reel. Verwende es als Beispiel für die Struktur. |
Behalte Größen, Farben und Animationen bei, wenn du Text änderst.