remotion-render-pipeline
Wandelt die Komposition in ein ausgeliefertes MP4 um.
Auslöser
remotion-composition-buildermeldetready: true.- Benutzer sagt „Rendere es“ / „Versende es“ mit einem bekannten Job.
Eingaben
jobIdcomposition– ID, die aufsrc/Root.tsxpasst (z.B.Explainer)outputPath– relativ zuremotion-studio/output/props– vollständige Eingabe-Props (Brand + Storyboard + …) als JSONlinear–{teamId, projectId}für die Ticket-Route
Methode
- Preflight-Typ-Prüfung –
cd remotion-studio && npx tsc --noEmit. Bei Fehler zurück zuremotion-composition-buildermit der Fehlermeldung. - Sprachsynthese –
render/voiceover.tsschreibt pro Szene eine MP3-Datei inpublic/audio/{jobId}/scene-N.mp3(unterpublic/, damitstaticFile()sie auflösen kann). Verwendet Cache-Keysha1(voiceId|style|text). Überspringt die Synthese, fallsELEVENLABS_API_KEYfehlt – die Komposition muss dann dennoch mit reinem Bildschirmtext rendern. - Rendern –
npx tsx render/render.ts --comp={composition} --out={outputPath} --props='{...}' --jobId={jobId}. Mit 600-Sekunden-Timeout; ein Wiederholungsversuch bei Hänger/Absturz. - Validierung – Datei existiert, Dauer ±0,5s der erwarteten, Codec
h264, Auflösung passt zur Komposition, Größe <100 MB. - Auslieferung:
- Upload in den Supabase-Bucket
remotion-renders– signierte URL, 90 Tage Aufbewahrung. - Telegram via
app.server.telegram_video.send_telegram_video()(das gemeinsame Utility). Falls Datei >45 MB, wird der signierte URL-Link statt Inline-Upload gesendet (Telegram-Limit ist 50 MB). - Erstelle ein Linear-Ticket in
{teamId}/{projectId}mit: Render-URL, Quellbrief, BrandConfig-Version (git-SHA vonsrc/brands/{slug}.ts), Kompositionsdateipfad.
- Upload in den Supabase-Bucket
- Status – Schreibe Zusammenfassung nach
.research/renders/{jobId}.json.
Ausgabe
{
"jobId": "ra-nir-explainer-2026-04-28T15-30-00",
"mp4Path": "remotion-studio/output/ra-nir-explainer-2026-04-28T15-30-00.mp4",
"supabaseUrl": "https://<project>.supabase.co/storage/v1/object/sign/remotion-renders/...",
"telegramSent": true,
"linearIssue": "RA-2049",
"validation": { "durationSec": 60.0, "codec": "h264", "resolution": "1920x1080", "sizeMB": 12.4 }
}
Grenzen
- Führe den Render niemals aus, wenn
tsc --noEmitfehlschlägt – verschwendet 2-5 Minuten für ein garantiert schlechtes Ergebnis. - Führe niemals automatisch den Quell-PR (Kompositions- + Markenänderungen) zusammen, bevor die Render-Verifikation bestanden wurde.
- Lade niemals Renders mit eingebranntem
[DRAFT]in den Marken-Bucket hoch – Entwürfe gehen nachremotion-drafts.
Fehler-Eskalation
- Timeout / Hänger → kill, einmal wiederholen → bei zweitem Fehler Linear-Ticket mit
priority: 2erstellen, stderr anhängen. - Validierungsfehler (falsche Dauer/Codec) → Linear mit
priority: 3und Diff gegen Erwartungswert. - Telegram-Fehler → Fallback auf
send_telegram_document()mit.mp4als Anhang.
Wiederverwendet
render/render.tsrender/voiceover.tsapp/server/telegram_video.py(gemeinsames Utility)config/harness/projects.jsonfür die Auflösung von Linear-Team/Projekt
Projektspezifische API-Schlüssel
Dieses Skill wird vom aufrufenden Projekt aus aufgerufen (Synthex, Pi-SEO, RestoreAssist, usw.). Jedes Projekt stellt seine eigenen Schlüssel über sein eigenes .env / .env.local bereit. Das Skill liest niemals Schlüssel aus Pi-Dev-Ops.
Zum Render-Zeitpunkt benötigte oder gewarnte Umgebungsvariablen:
ELEVENLABS_API_KEY– Sprachsynthese. Fehlt er = stummer Render mit reinem Bildschirmtext (Warnung wird protokolliert, Render läuft weiter).TELEGRAM_BOT_TOKEN,TELEGRAM_CHAT_ID– Telegram-Zustellung. Fehlen = Telegram-Schritt wird übersprungen (das MP4 landet dennoch auf der Platte + Supabase, falls konfiguriert).SUPABASE_URL,SUPABASE_SERVICE_ROLE_KEY– signierte URL-Uploads. Fehlen = Supabase-Schritt wird übersprungen.LINEAR_API_KEY– Ticket-Erstellung. Fehlt = Linear-Schritt wird übersprungen.REMOTION_LICENSE_KEY– erforderlich für jeden kommerziellen Render unter Remotions Fair-Source-Lizenz.
Aufrufmuster aus einer Projekt-Shell:
cd ~/Pi-CEO/Synthex
source .env.local # die eigenen Schlüssel des Projekts
cd ~/Pi-Dev-Ops/remotion-studio
npx tsx render/render.ts \
--comp=Explainer \
--out=$OLDPWD/.remotion-renders/synthex-launch.mp4 \
--jobId=synthex-launch-$(date +%s) \
--props='{"brand":"synthex","hookSec":8,"ctaSec":8,"storyboard":[...]}'
Oder Aufruf über die Pi-Dev-Ops Orchestrator-API, die zum Zeitpunkt der Sitzungserstellung die Umgebung des aufrufenden Projekts erbt.
Ausgabe-Konvention: Standardmäßig wird das MP4 in <aufrufendes-projekt>/.remotion-renders/ (gitignoriert) geschrieben – so bleiben die Artefakte jedes Projekts in seinem eigenen Verzeichnis. Mit --out=... überschreibbar.