Générateur de Vidéos de Démonstration
Aperçu Général
Générez des vidéos de démonstration 1920x1080 avec voix off, transitions et animations CSS à partir d'une seule instruction. Orchestre les serveurs MCP Playwright (rendu HTML en frames), FFmpeg (compositing et transitions) et Edge TTS (voix off neuronale).
Prérequis
- Python 3.11+ et le gestionnaire de paquets
uv - FFmpeg installé (
ffmpeg -version) - Navigateur Chromium pour Playwright (
uv run playwright install chromium) - Connexion Internet pour la synthèse vocale Edge TTS
Instructions
Installez le plugin framecraft depuis le marketplace :
claude plugin marketplace add jeremylongshore/claude-code-plugins-plus-skills
claude plugin install framecraft@claude-code-plugins-plus
Démarrage Rapide
uv run python framecraft.py init my-demo # créer un projet
uv run python framecraft.py render scenes.json --auto-duration
uv run python framecraft.py validate output.mp4 # contrôle qualité
Orchestration MCP
Lorsque les serveurs MCP Playwright, FFmpeg et Edge TTS sont disponibles, framecraft les orchestre directement pour un contrôle maximal sur chaque frame et segment audio.
Pipeline de Secours
Lorsque les serveurs MCP ne sont pas disponibles, framecraft exécute un pipeline CLI atomique qui gère tout en un seul appel.
Flux de Travail
- Conception du scénario — Choisissez une trame narrative (problème-solution, voyage du héros, avant-après)
- Rédaction des scènes — Écrivez des scènes HTML avec animations CSS, ou utilisez des modèles intégrés
- Rendu — Playwright capture les frames, Edge TTS génère la voix off, FFmpeg composite le tout
Sortie
- Vidéo MP4 1920x1080 avec voix off et transitions
- Prévisualisations individuelles des scènes pour itération
- Rapport de validation pour assurance qualité
Gestion des Erreurs
| Erreur | Cause | Correctif |
|---|---|---|
ffmpeg: command not found | FFmpeg non installé | Installez via brew install ffmpeg ou le gestionnaire de paquets système |
playwright._impl._errors.Error | Chromium non installé | Exécutez uv run playwright install chromium |
edge_tts.exceptions.NoAudioReceived | Service TTS indisponible | Vérifiez la connexion Internet ; réessayez après quelques secondes |
FileNotFoundError: scenes.json | Configuration de scènes manquante | Exécutez d'abord uv run python framecraft.py init my-demo |
| Frames blanches ou noires | Échec du rendu de la scène HTML | Vérifiez la syntaxe HTML et assurez-vous que les ressources sont accessibles |
Exemples
{
"scenes": [
{
"title": "Découvrez YourApp",
"subtitle": "La manière plus intelligente de gérer les tâches",
"narration": "24 tâches. Un tableau de bord. Zéro stress.",
"voice": "en-US-AndrewNeural",
"bullets": ["Priorités intelligentes", "Synchronisation d'équipe", "Rapports en un clic"],
"duration": 0
}
],
"output": "demo.mp4",
"width": 1920, "height": 1080,
"voice": "en-US-AndrewNeural",
"transition": "crossfade"
}
duration: 0 = détection automatique depuis la durée TTS + tampon de 1,5 seconde.
Ressources
- Dépôt source avec modèles et pipeline : github.com/vaddisrinivas/framecraft
- Liste des voix Edge TTS
- Documentation Playwright
- Documentation FFmpeg