Reels mit reel-kit
Sie bearbeiten echtes Filmmaterial auf dem Computer des Benutzers. Sie benötigen ein Werkzeug, das Shell-Befehle ausführen und Dateien dort lesen kann (z.B. die Desktop Commander Erweiterung in Claude Desktop oder Claude Code). Ohne ein solches Werkzeug teilen Sie dies dem Benutzer mit und verweisen Sie auf docs/guia-windows.md. Versuchen Sie nicht, dies mit hochgeladenen Dateien in der Chat-Sandbox zu erledigen.
Einrichtung
- Finden Sie den Ordner
reel-kit(fragen Sie den Benutzer einmal, wenn Sie ihn nicht finden können). Führen Sie jeden Befehl von dort aus. - Beim ersten Mal:
npm installundpip install numpy. Überprüfen Sie, obffmpeg -versionundnode -vfunktionieren. - Wählen Sie die Stildatei im Ordner
styles/dieser Fertigkeit aus, die zum Thema passt (yoga.md,aikido.md). Wenn keine passt, beginnen Sie mityoga.mdund besprechen Sie die Unterschiede mit dem Benutzer. Fragen Sie den Benutzer nach den Fakten, die der Reel zeigt (Name, Daten, Ort, URL); erfinden Sie niemals welche.
Arbeitsablauf
- Sehen Sie sich das Filmmaterial an. Für jedes lange Video:
python tools/reel.py sheet <video> --every 10. Lesen Sie die Blattbilder inout/sheets/, um die guten Momente zu finden. Gehen Sie bei einem vielversprechenden Teil feiner vor (--every 2), bevor Sie genaue Zeiten auswählen. - Wählen Sie Clips aus. Schreiben Sie
out/<name>-clips.tsv, tabulatorgetrennt, ein Clip pro Zeile:id<TAB>Quellpfad<TAB>Start<TAB>Ende(Sekunden oder mm:ss). Befolgen Sie die Stildatei hinsichtlich der Clip-Länge und dessen, was jeder Clip enthalten muss. - Schneiden.
python tools/reel.py cut out/<name>-clips.tsv. Jeder Clip wird vertikal 1080x1920 inpublic/clips/; Querformat-Material wird der Bewegung folgend beschnitten (--frame centerfür einen festen zentrierten Ausschnitt,--frame keepzum Skalieren ohne Tracking). Fügen Sie--gpunur hinzu, wenn der PC eine NVIDIA-Karte hat. Der Befehl gibt eine JSON-Zeile pro Clip mit dessen genauer Länge aus. - Beschreiben Sie den Reel. Erstellen Sie
reels/<name>.json(siehe Format unten), indem Sie die Clip-Zeilen aus Schritt 3 einfügen. - Rendern.
python tools/reel.py render <name>schreibtout/<name>.mp4mit für soziale Medien normalisierter Lautstärke. - Überprüfen. Ziehen Sie 3-4 Einzelbilder (
ffmpeg -i out/<name>.mp4 -vf "fps=1/4,scale=360:-2,tile=4x1" -frames:v 1 out/<name>-check.jpg) und sehen Sie sie sich an, bevor Sie dem Benutzer mitteilen, dass es fertig ist. Teilen Sie dem Benutzer den Dateipfad und die Länge mit.
Änderungen, die der Benutzer später wünscht ("entferne den langsamen Teil", "keine Musik"): Bearbeiten Sie die TSV oder das JSON und führen Sie nur die nachfolgenden Schritte aus. Behalten Sie frühere Versionen, indem Sie einen neuen Namen verwenden (<name>-v2), damit der Benutzer zurückgehen kann.
reels/.json
{
"clips": [{ "file": "clips/a1.mp4", "seconds": 6.5 }],
"transition": "fade",
"fadeSeconds": 0.5,
"clipVolume": 0,
"music": { "file": "music/calm.mp3", "volume": 0.5 },
"accent": "#7FA88B",
"intro": [{ "kicker": "Yoga · Murcia", "title": "Clase abierta", "sub": "Sábado 10:00" }],
"outro": { "text": "Reserva tu plaza", "url": "example.com", "image": "poster.jpg", "seconds": 3.5 }
}
- Nur
clipsist erforderlich. Pfade sind relativ zupublic/; legen Sie Musik inpublic/music/und Bilder inpublic/ab. transition:"cut"(harte Schnitte, Standard) oder"fade".clipVolume: 1 behält den Originalton, 0 schaltet ihn stumm. Musik blendet am Ende von selbst aus.intro: Textkarten, jeweils 2,5 s, werden über den ersten Clips eingeblendet.outro: Abschlussbildschirm mit Text, URL und/oder einem Bild (Plakat, Logo).- Verwenden Sie nur Musik, die der Benutzer bereitstellt oder für die er bestätigt, die Rechte zu haben.
Regeln
- Videobearbeitung ist rechenintensiv. Führen Sie jeweils nur einen ffmpeg- oder Render-Job aus; die Werkzeuge laufen bereits mit niedriger Priorität.
- Verwenden Sie
npm run studionur, wenn der Benutzer eine Vorschau sehen und manuelle Anpassungen vornehmen möchte. - Um das Erscheinungsbild selbst zu ändern (Schriftarten, Layout), bearbeiten Sie
src/Reel.tsx; die offizielle Fertigkeit von Remotion (npx skills add remotion-dev/skills) hilft dabei.