Remotion → CapCut
remotion-to-capcut konvertiert eine Remotion-Komposition in einen echten CapCut-Entwurf, sodass der Benutzer das, was du in Code erstellt hast, von Hand weiterbearbeiten kann. Derzeit nur Windows + CapCut Desktop.
Export
Führe den Befehl aus dem Remotion-Projektordner aus:
npx github:OybekWeb1/remotion-to-capcut doctor
Behebe zuerst alles, was mit ✗ markiert ist (CapCut muss installiert und einmal geöffnet worden sein; Python 3.8+ muss im PATH sein).
npx github:OybekWeb1/remotion-to-capcut list
npx github:OybekWeb1/remotion-to-capcut <CompositionId> --name "<Name in CapCut>"
- Dauert etwa 1 Minute pro 6 Sekunden Video. Bei langen Videos im Hintergrund ausführen.
- CapCut muss geschlossen sein, während der Entwurf geschrieben wird. Wenn es geöffnet ist, wartet das Tool (
--wait <Sekunden>, Standard 600); bitte den Benutzer, CapCut zu schließen — beende es niemals selbst (der Benutzer könnte ungespeicherte Arbeit haben). Bei Zeitüberschreitung erneut mit--skip-captureausführen, sobald CapCut geschlossen ist; das wiederverwendet die Aufnahme und dauert nur Sekunden. - Wenn es fertig ist, lies
out/capcut/<CompositionId>/summary.txtund teile dem Benutzer mit, was zu nativen Texten und Clips wurde. Dann: CapCut öffnen → Projekte → der Entwurfsname. - Um einen Ausschnitt zu iterieren:
--frames 0-299. Composition-Props:--props props.json.
Remotion-Code schreiben, der sich gut konvertieren lässt
Der Konverter untersucht das gerenderte DOM Bild für Bild. Was er in bearbeitbare CapCut-Elemente umwandeln kann:
| In Remotion | In CapCut |
|---|---|
Text in normalen DOM-Elementen (<div>, <span>, <h1>…) | Native Textebene: Schriftart, Größe, Farbe, Verlauf, Schatten, Kontur, Zeichen-/Zeilenabstand |
transform (translate / scale / rotate) und opacity auf Text oder Filmmaterial | Position / Skalierung / Rotation / Deckkraft-Keyframes |
<OffthreadVideo> / <Video> mit einer Datei aus public/ | Der Rohclip, auf die Länge der Remotion-Trimmung zugeschnitten, mit Geschwindigkeit |
<Audio> aus public/ | Separate Audioclips mit Lautstärkekurve |
| Alles andere (Karten, Formen, Logos, Bilder, SVG, Lichtlecks) | Eine transparente „Grafik (Alpha)“-Videospur über dem Filmmaterial |
Faustregeln:
- Halte Text als echten Text. Kein Text in SVG, Canvas oder Bildern. Ein Textblock pro Element; Style-Runs darin (
<span>mit anderer Farbe/Schriftstärke) sind in Ordnung. - Verwende Google Fonts (
@remotion/google-fonts). Die passende TTF wird automatisch heruntergeladen; andere Schriftarten fallen auf CapCuts Standardschriftart zurück. - Animiere mit transform + opacity. Weichzeichner-Einblendungen, Clip-Path-Enthüllungen und Buchstaben-für-Buchstaben-Effekte gibt es nicht als CapCut-Keyframes: Der Text wird sich nur bewegen/einblenden. Zählende Zahlen zeigen ihren Endwert.
- Filmmaterial und Audio müssen lokale Dateien in
public/sein, referenziert mitstaticFile(). Remote-URLs werden nicht unterstützt. - Verschwimme Filmmaterial nicht mit CSS, wenn der Benutzer es austauschen können soll: Clips mit
filter: blur()über 1,5px bleiben in der Grafikebene eingebrannt. - Lege das Hintergrundfilmmaterial als eine lückenlose Sequenz ab (CapCuts Hauptspur ist magnetisch); zusätzliche Clips kommen auf obere Spuren.
- Um etwas absichtlich als Pixel zu behalten (z.B. einen komplexen animierten Titel), umschließe es mit:
<div data-capcut="bake">…</div>.
Dem Benutzer die Grenzen mitteilen
- Grafiken sind eine flache Ebene: Wenn der Benutzer einen Text verlängert, wächst die Karte dahinter nicht mit.
- Übergangsbilder und unscharfe Hintergründe sind in die Grafikebene eingebrannt.
- Die Textmetriken wurden auf CapCut 9.7 kalibriert; andere Versionen können einige Pixel abweichen.
- Das CapCut-Entwurfsformat ist undokumentiert; ein CapCut-Update kann dies beschädigen.