Gerador de Vídeos de Demonstração
Visão Geral
Gere vídeos de demonstração em 1920x1080 com narração, transições e animações CSS a partir de um único prompt. Orquestra servidores MCP Playwright (renderização de HTML para frames), FFmpeg (composição e transições) e Edge TTS (narração neural).
Pré-requisitos
- Python 3.11+ e gerenciador de pacotes
uv - FFmpeg instalado (
ffmpeg -version) - Navegador Chromium do Playwright (
uv run playwright install chromium) - Conexão com internet para síntese de voz Edge TTS
Instruções
Instale o plugin framecraft a partir do marketplace:
claude plugin marketplace add jeremylongshore/claude-code-plugins-plus-skills
claude plugin install framecraft@claude-code-plugins-plus
Início Rápido
uv run python framecraft.py init my-demo # criar um projeto
uv run python framecraft.py render scenes.json --auto-duration
uv run python framecraft.py validate output.mp4 # verificação de qualidade
Orquestração MCP
Quando os servidores MCP Playwright, FFmpeg e Edge TTS estiverem disponíveis, o framecraft os orquestra diretamente para obter o máximo controle sobre cada frame e segmento de áudio.
Fallback do Pipeline
Quando os servidores MCP não estão disponíveis, o framecraft executa um pipeline CLI atômico que lida com tudo em uma única chamada.
Fluxo de Trabalho
- Design da história -- Escolha um arco narrativo (problema-solução, jornada do herói, antes-depois)
- Criação de cenas -- Escreva cenas HTML com animações CSS ou use modelos embutidos
- Renderização -- Playwright captura os frames, Edge TTS gera a narração, FFmpeg compõe o vídeo final
Saída
- Vídeo MP4 em 1920x1080 com narração e transições
- Pré-visualizações individuais de cenas para iteração
- Relatório de validação para garantia de qualidade
Tratamento de Erros
| Erro | Causa | Solução |
|---|---|---|
ffmpeg: command not found | FFmpeg não instalado | Instale via brew install ffmpeg ou gerenciador de pacotes do sistema |
playwright._impl._errors.Error | Chromium não instalado | Execute uv run playwright install chromium |
edge_tts.exceptions.NoAudioReceived | Serviço TTS indisponível | Verifique a conexão com internet; tente novamente após alguns segundos |
FileNotFoundError: scenes.json | Configuração de cena ausente | Execute uv run python framecraft.py init my-demo primeiro |
| Frames em branco ou pretos | Falha na renderização da cena HTML | Verifique a sintaxe HTML e garanta que os assets estejam acessíveis |
Exemplos
{
"scenes": [
{
"title": "Conheça o YourApp",
"subtitle": "A maneira mais inteligente de gerenciar tarefas",
"narration": "24 tarefas. Um painel. Zero estresse.",
"voice": "en-US-AndrewNeural",
"bullets": ["Prioridades inteligentes", "Sincronização de equipe", "Relatórios com um clique"],
"duration": 0
}
],
"output": "demo.mp4",
"width": 1920, "height": 1080,
"voice": "en-US-AndrewNeural",
"transition": "crossfade"
}
duration: 0 = detecção automática a partir da duração do TTS + buffer de 1,5s.
Recursos
- Repositório fonte com modelos e pipeline: github.com/vaddisrinivas/framecraft
- Lista de vozes Edge TTS
- Documentação do Playwright
- Documentação do FFmpeg