Demo-Video-Generator
Übersicht
Generieren Sie 1920x1080 Demo-Videos mit Sprachausgabe, Übergängen und CSS-Animationen aus einer einzigen Eingabeaufforderung. Orchestriert Playwright (HTML-zu-Frame-Rendering), FFmpeg (Compositing und Übergänge) und Edge TTS (neuronale Sprachausgabe) MCP-Server.
Voraussetzungen
- Python 3.11+ und
uvPaketmanager - FFmpeg installiert (
ffmpeg -version) - Playwright Chromium Browser (
uv run playwright install chromium) - Internetverbindung für die Edge TTS Sprachsynthese
Anleitung
Installieren Sie das framecraft-Plugin aus dem Marketplace:
claude plugin marketplace add jeremylongshore/claude-code-plugins-plus-skills
claude plugin install framecraft@claude-code-plugins-plus
Schnellstart
uv run python framecraft.py init my-demo # Projekt anlegen
uv run python framecraft.py render scenes.json --auto-duration
uv run python framecraft.py validate output.mp4 # Qualitätsprüfung
MCP-Orchestrierung
Wenn Playwright-, FFmpeg- und Edge-TTS-MCP-Server verfügbar sind, orchestriert framecraft diese direkt für maximale Kontrolle über jedes Bild und jede Audiosequenz.
Pipeline-Fallback
Wenn MCP-Server nicht verfügbar sind, führt framecraft eine atomare CLI-Pipeline aus, die alles in einem Aufruf erledigt.
Workflow
- Story-Design – Wählen Sie einen Erzählbogen (Problem-Lösung, Heldenreise, Vorher-Nachher)
- Szenen-Authoring – Schreiben Sie HTML-Szenen mit CSS-Animationen oder verwenden Sie integrierte Vorlagen
- Rendering – Playwright erfasst Bilder, Edge TTS generiert Sprachausgabe, FFmpeg erstellt den finalen Zusammenschnitt
Ausgabe
- 1920x1080 MP4-Video mit Sprachausgabe und Übergängen
- Einzelne Szenenvorschauen für Iterationen
- Validierungsbericht zur Qualitätssicherung
Fehlerbehandlung
| Fehler | Ursache | Behebung |
|---|---|---|
ffmpeg: command not found | FFmpeg nicht installiert | Installieren über brew install ffmpeg oder Systempaketmanager |
playwright._impl._errors.Error | Chromium nicht installiert | Ausführen von uv run playwright install chromium |
edge_tts.exceptions.NoAudioReceived | TTS-Dienst nicht verfügbar | Internetverbindung prüfen; nach einigen Sekunden wiederholen |
FileNotFoundError: scenes.json | Fehlende Szenenkonfiguration | Zuerst uv run python framecraft.py init my-demo ausführen |
| Leere oder schwarze Bilder | HTML-Szenen-Rendering fehlgeschlagen | HTML-Syntax prüfen und sicherstellen, dass Ressourcen zugänglich sind |
Beispiele
{
"scenes": [
{
"title": „Treffen Sie YourApp“,
"subtitle": „Der intelligentere Weg, Aufgaben zu verwalten“,
"narration": „24 Aufgaben. Ein Dashboard. Null Stress.“,
"voice": „en-US-AndrewNeural“,
"bullets": [„Intelligente Prioritäten“, „Team-Sync“, „Berichte mit einem Klick“],
"duration": 0
}
],
"output": „demo.mp4“,
"width": 1920, "height": 1080,
"voice": „en-US-AndrewNeural“,
"transition": „crossfade“
}
duration: 0 = automatische Erkennung anhand der TTS-Länge + 1,5s Puffer.
Ressourcen
- Quellrepository mit Vorlagen und Pipeline: github.com/vaddisrinivas/framecraft
- Edge TTS Sprachliste
- Playwright-Dokumentation
- FFmpeg-Dokumentation