Remotion CLI
Das Werkzeug ist remotion, aus @remotion/cli. Jeder Befehl wird mit npx remotion <command> ausgeführt, und jeder davon bündelt zuerst das Projekt, sodass sich ein Typfehler oder ein schlechter Import eher als Bündelungsfehler und nicht als Render-Fehler äußert.
npx remotion --help und npx remotion <command> --help sind die maßgebliche Quelle für Flags. Flags ändern sich zwischen den Releases; lies die Hilfeausgabe, anstatt einer Liste (auch dieser hier) zu vertrauen. Das Folgende beschreibt die Schleife und die Fehlermodi, keine Flag-Referenz.
Die Schleife
| Phase | Befehl | Grund |
|---|---|---|
| Scaffold | npx create-video@latest --blank | Schreibt passende package.json, remotion.config.ts, tsconfig |
| Typprüfung | npx tsc --noEmit | Das günstigste Hindernis; erfasst Schema-/Prop-Drift vor jedem Render |
| Liste | npx remotion compositions | Bestätigt, dass die id, die du rendern willst, tatsächlich existiert |
| Standbildtest | npx remotion still <id> out/probe.png --frame=<n> | Sekunden, nicht Minuten; das Arbeitstier der Iteration |
| Überprüfung | npx remotion studio | Übergib es dem Benutzer; er scrubbt und bearbeitet Props selbst |
| Rendern | npx remotion render <id> out/video.mp4 | Erst nachdem der Benutzer zugestimmt hat |
| Remote ausliefern | npx remotion bundle → npx remotion lambda render <url> <id> | Verteiltes Rendern; erfordert bereitgestellte AWS-Infrastruktur |
Standbilder testen vor dem Rendern
Ein vollständiger Render einer 45-sekündigen 1080p-Komposition dauert Minuten. Ein Standbild dauert Sekunden und beantwortet die meisten Fragen: Ist der Text im Bild, wurde das Asset geladen, stimmt die Farbe. Teste den Mittelpunkt jeder Szene, schau dir jedes Bild an und rendere erst dann.
npx remotion still launch out/s1.png --frame=45
npx remotion still launch out/s2.png --frame=180
Melde niemals eine Komposition als funktionierend aufgrund eines erfolgreichen Bundles. Sieh dir Pixel an.
Studio ist die Überprüfungsfläche, nicht dein Debugger
npx remotion studio stellt das Projekt mit einer Timeline, einem Props-Editor (gesteuert durch das Zod-Schema) und frame-genauer Sicht bereit. Übergib es dem Benutzer zur Freigabe. Für deine eigene Verifikation bevorzugst du still-Tests: Sie sind skriptbar und du kannst dir die Ausgabe ansehen, ohne den Benutzer bitten zu müssen, zu beschreiben, was er sieht.
Props übergeben
--props akzeptiert einen JSON-String oder einen Pfad zu einer JSON-Datei und überschreibt defaultProps:
npx remotion render launch out/video.mp4 --props='{"productName":"Acme"}'
Ein Prop, das das Zod-Schema der Komposition nicht besteht, führt zu einem lauten Render-Fehler. Das ist der Sinn der Schema-Deklaration, also halte sie genau.
Batch-Rendering
Es gibt keinen Batch-Unterbefehl. Schleife in der Shell über IDs oder Prop-Payloads:
for id in $(npx remotion compositions --quiet); do
npx remotion render "$id" "out/$id.mp4"
done
Für viele Render einer Komposition über einen Datensatz hinweg bevorzuge renderMedia() aus @remotion/renderer in einem Node-Skript: Es bündelt einmal statt einmal pro Render, was die Wanduhrzeit dominiert.
Render-Leistung
--concurrency=<n>setzt parallele Worker. Der Standard ist die Hälfte der CPU-Kerne, gedeckelt bei 8; das Maximum ist die Anzahl der Kerne, und mehr zu verlangen ist ein Fehler, keine Begrenzung. Auf einem Arbeitsspeicher-knappen Gerät senkt es die Zahl, was Crashes behebt, die wie Renderer-Fehler aussehen.--jpeg(anstelle des standardmäßigen PNG-Frame-Formats) ist eine große Beschleunigung, wenn die Komposition keine Transparenz beibehält.npx remotion benchmarkmisst einen echten Render, verwende es also, um eine Änderung der Parallelität oder des Codecs zu rechtfertigen, anstatt zu raten.npx remotion gpumeldet, was der Browser tatsächlich beschleunigen wird. Es lohnt sich, dies zu überprüfen, bevor man einen Shader oder einen schweren Filter für einen langsamen Render verantwortlich macht.
Fehlerdiagnose
| Symptom | Wahrscheinliche Ursache |
|---|---|
| Bündelung schlägt fehl | Ein Typfehler oder ein schlechter Import. Führe npx tsc --noEmit für die lesbare Version des gleichen Fehlers aus. |
| „Keine Komposition mit der ID …“ | Die id in Root.tsx unterscheidet sich von der übergebenen. npx remotion compositions klärt das. |
| Render hängt, dann Zeitüberschreitung | Ein delayRender() ohne passendes continueRender(). Jeder Delay-Handle muss freigegeben werden. |
| Jeder Frame sieht aus wie Frame 0 | Eine CSS-Animation/Transition oder requestAnimationFrame. Der Renderer erhöht die Browser-Uhr nicht. |
| Animation stroboskopiert oder flackert von Frame zu Frame | Unseeded Math.random(). Verwende random(seed) stattdessen. |
| Bewegung funktioniert beim Vorwärts-Scrubben, bricht bei Sprung | Zustandsgesteuerte Animation. Leite stattdessen von useCurrentFrame() ab. |
| Asset 404 nur in einem Lambda- oder gebündelten Render | Ein hartcodierter Pfad anstelle von staticFile(). |
| Versionsfehler, der keinen Sinn ergibt | Nicht übereinstimmende Remotion-Pakete. npx remotion versions meldet die Abweichung. |
| Arbeitsspeicherüberlauf mitten im Render | Parallelität zu hoch für die Maschine. Senke --concurrency. |
Gib die tatsächliche Fehlerausgabe an, wenn du einen Fehler meldest. Paraphrasiere keinen Stacktrace.
Wo die Fähigkeiten des eingestellten HyperFrames CLI geblieben sind
Das alte hyperframes CLI bündelte Autoren-, Medien- und QA-Befehle, die die Remotion-CLI nicht hat. Nichts unten ist ein Remotion-Befehl, versuche also nicht, sie auszuführen:
| Eingestellter Befehl | Wo die Fähigkeit jetzt lebt |
|---|---|
init | npx create-video@latest --blank, dann /hyperframes-core → references/project-structure.md |
lint, check, layout, validate | npx tsc --noEmit plus still-Tests. Der data-*-Vertrag, den diese Tore durchgesetzt haben, ist weg. |
snapshot, compare, grade-compare | npx remotion still bei gewählten Frames; vergleiche die PNGs mit deinen eigenen Werkzeugen. |
preview, play, present | npx remotion studio |
add, catalog | /hyperframes-registry |
capture | /product-launch-video (Seitenaufnahme) und /media-use |
tts, transcribe, remove-background | /media-use |
beats, keyframes | /hyperframes-creative (Beat-Planung), /hyperframes-keyframes |
cloud, publish | npx remotion bundle + remotion lambda / remotion cloudrun, oder eigenes Hosting |
skills, docs, upgrade, doctor | Diese Skills sind in diesem Repo bereitgestellt; npx remotion upgrade und npx remotion versions |
Wenn dich ein Workflow-Skill oder eine Referenzdatei dennoch anweist, npx hyperframes <irgendwas> auszuführen, ist diese Anweisung veraltet. Führe das Remotion-Äquivalent aus der obigen Tabelle aus und sage in deiner Zusammenfassung, dass du auf einen veralteten Zeiger gestoßen bist, damit er behoben werden kann.