Remotion Software-Engineering Erklärvideo (remotion-software-explainer)
Übersicht
Verwandelt jedes Systemdesign, jede verteilte Architektur, jedes Entwurfsmuster, Datenbank-Interna oder DevOps-Workflow in ein immersives, framesynchronisiertes 1920×1080 30fps MP4 Remotion-Erklärvideo im Single-Pane Log2Base2 Studio Format.
Teile den Bildschirm nie in konkurrierende Side-by-Side-Bereiche oder gestapelte Textkartenwände. Jedes Video verwendet eine einheitliche visuelle Bühne (<SinglePaneStage>):
- Minimale obere Leiste (
44px, inSinglePaneStageintegriert):- Thema-Titel + aktiver Abschnitt-Pill auf der linken Seite; dezenter Schritt-Zähler + dünner Fortschrittsbalken auf der rechten Seite.
- EINE Einheitliche Log2Base2-Bühne (
SinglePaneStage— 100 % Breite):- Fokussiertes Single-Line-Spotlight: Hebt das aktive gesprochene Element (
replicas: 3,ConsistentHash,WAL,CircuitBreaker) in der aktiven Spezifikations-/Contract-Zeile mitborderBottom: "2px solid #FACC15"(niemals horizontales Padding hinzufügen) plus eine kompakte aktive Callout-Pill (term→architectural role) beitriggerFramehervor. - Vollbreite immersive SVG-Leinwand (
viewBox="0 0 1600 680"): Progressive Vektor-Service-Knoten (Client, API Gateway, Load Balancer, Microservices, Message Queue, Cache, DB Shards, K8s Pods), die beim Sprechen erscheinen, verbunden durch animierte gepunktete Pipelines mit reisenden Request-Paketen, Live-Cache-Treffer-/Durchsatzanzeigen und Request-Trace-Spans, die direkt über derselben offenen Leinwand fließen.
- Fokussiertes Single-Line-Spotlight: Hebt das aktive gesprochene Element (
- Minimale untere Untertitelleiste (
VoiceoverCaptionBar—68px):- Sauber zentrierte Karaoke-Wort-für-Wort hervorgehobene Untertitel, gesteuert durch exakte TTS
WordBoundary-Zeitstempel.
- Sauber zentrierte Karaoke-Wort-für-Wort hervorgehobene Untertitel, gesteuert durch exakte TTS
Abhängigkeiten
remotion-best-practices(~/.gemini/skills/remotion/SKILL.md)uv(~/.gemini/config/plugins/science/skills/uv/SKILL.md)
Schnellstart
# 1. Gerüst bauen
uv run python3 \
~/.gemini/config/skills/remotion-software-explainer/scripts/explainer_cli.py \
scaffold \
--project-dir "/pfad/zum/projekt" \
--output "/pfad/zum/projekt/scaffold-status.json"
# 2. Voiceover synthetisieren
uv run --with edge-tts python3 \
~/.gemini/config/skills/remotion-software-explainer/scripts/explainer_cli.py \
synthesize-voiceover \
--project-dir "/pfad/zum/projekt" \
--beats-json "/pfad/zum/projekt/beats.json" \
--voice "de-DE-KillianNeural" \
--rate "+2%" \
--pause-sec 0.40 \
--output "/pfad/zum/projekt/public/voiceover/manifest.json"
# 3. 1080p MP4 rendern
uv run python3 \
~/.gemini/config/skills/remotion-software-explainer/scripts/explainer_cli.py \
render-mp4 \
--project-dir "/pfad/zum/projekt" \
--composition-id "SoftwareExplainer" \
--out-name "SoftwareExplainer.mp4" \
--concurrency 8 \
--output "/pfad/zum/projekt/render-report.json"
Immersives Storytelling & Workflow
- Halte
snippetfokussiert (2–4Zeilen), damit<SinglePaneStage>eine aktive Vertragszeile hervorhebt und Architekturknoten progressiv enthüllt – platziere nie 15 Boxen auf Frame 0. - Setze
"motionStepFrames": 2auf Beats mit reisenden Request-Paketen, Failover-Kaskaden oder Autoscaling-Animationen. - Zeige, erzähle nicht: Animierte Request-Pakete mit Live-Latenz-/Queue-/Trace-Balken direkt innerhalb derselben vollbreiten
1600×680SVG-Leinwand (mit<clipPath>wo nötig), niemals in separaten Split-Screen-Boxen. - Führe immer
npm run lintaus, inspiziere repräsentative Einzelbilder (npx remotion still) mitread_fileund speichere das endgültige.mp4inout/, dem Projektstammverzeichnis und dem Workspace-Stammverzeichnis.