Generador de Videos Demo
Resumen
Genera videos demo en 1920x1080 con voiceover, transiciones y animaciones CSS a partir de un solo prompt. Orquesta los servidores MCP de Playwright (renderizado de HTML a frames), FFmpeg (composición y transiciones) y Edge TTS (voiceover neuronal).
Prerrequisitos
- Python 3.11+ y el gestor de paquetes
uv - FFmpeg instalado (
ffmpeg -version) - Navegador Chromium de Playwright (
uv run playwright install chromium) - Conexión a Internet para la síntesis de voz Edge TTS
Instrucciones
Instala el plugin framecraft desde el marketplace:
claude plugin marketplace add jeremylongshore/claude-code-plugins-plus-skills
claude plugin install framecraft@claude-code-plugins-plus
Inicio Rápido
uv run python framecraft.py init my-demo # crear un proyecto
uv run python framecraft.py render scenes.json --auto-duration
uv run python framecraft.py validate output.mp4 # verificación de calidad
Orquestación MCP
Cuando los servidores MCP de Playwright, FFmpeg y Edge TTS están disponibles, framecraft los orquesta directamente para obtener el máximo control sobre cada frame y segmento de audio.
Fallback del Pipeline
Cuando los servidores MCP no están disponibles, framecraft ejecuta un pipeline CLI atómico que maneja todo en una sola llamada.
Flujo de Trabajo
- Diseño de la historia -- Elige un arco narrativo (problema-solución, viaje del héroe, antes-después)
- Autoría de escenas -- Escribe escenas HTML con animaciones CSS, o usa plantillas integradas
- Renderizado -- Playwright captura frames, Edge TTS genera el voiceover, FFmpeg compone
Salida
- Video MP4 en 1920x1080 con voiceover y transiciones
- Vistas previas individuales de escenas para iteración
- Informe de validación para garantía de calidad
Manejo de Errores
| Error | Causa | Solución |
|---|---|---|
ffmpeg: command not found | FFmpeg no instalado | Instala mediante brew install ffmpeg o el gestor de paquetes del sistema |
playwright._impl._errors.Error | Chromium no instalado | Ejecuta uv run playwright install chromium |
edge_tts.exceptions.NoAudioReceived | Servicio TTS no disponible | Verifica la conexión a Internet; reintenta tras unos segundos |
FileNotFoundError: scenes.json | Configuración de escena faltante | Ejecuta primero uv run python framecraft.py init my-demo |
| Frames en blanco o negros | Fallo en renderizado de escena HTML | Revisa la sintaxis HTML y asegúrate de que los recursos sean accesibles |
Ejemplos
{
"scenes": [
{
"title": "Conoce TuApp",
"subtitle": "La forma más inteligente de gestionar tareas",
"narration": "24 tareas. Un tablero. Cero estrés.",
"voice": "en-US-AndrewNeural",
"bullets": ["Prioridades inteligentes", "Sincronización en equipo", "Informes con un clic"],
"duration": 0
}
],
"output": "demo.mp4",
"width": 1920, "height": 1080,
"voice": "en-US-AndrewNeural",
"transition": "crossfade"
}
duration: 0 = detección automática a partir de la longitud del TTS + 1.5s de margen.
Recursos
- Repositorio fuente con plantillas y pipeline: github.com/vaddisrinivas/framecraft
- Lista de voces Edge TTS
- Documentación de Playwright
- Documentación de FFmpeg