CLI do HyperFrames
npm install -g hyperframes # ou use npx
Comandos
init
npx hyperframes init <nome> [--template blank|product|explainer|slideshow] [--fps 30] [--width 1920] [--height 1080]
lint
npx hyperframes lint [arquivo] [--fix] [--strict] [--json]
Verifica: atributos data-hf-* válidos, formatos de tempo, clipes sobrepostos, durações ausentes, assets inacessíveis e limites de comprimento de TTS.
preview
npx hyperframes preview [arquivo] [--port 3000] [--open] [--scene <nome>] [--time <t>]
Servidor de desenvolvimento ao vivo com scrubber, seletor de cenas e recarregamento automático.
render
export HEYGEN_API_KEY=sua_chave
npx hyperframes render [arquivo] [--out output.mp4] [--format mp4|webm|gif] [--quality 85] [--scene <nome>]
doctor
npx hyperframes doctor
Verifica Node ≥ 18, chave de API, rede, caminhos de assets e sintaxe de configuração.
hyperframes.config.json
{
"version": 1,
"entry": "index.html",
"output": "./output.mp4",
"canvas": { "width": 1920, "height": 1080, "fps": 30 },
"render": { "quality": 85, "format": "mp4" },
"tts": { "defaultVoice": "en-US-neural-f1", "speed": 1.0 },
"assets": { "baseUrl": "./assets" }
}
Variáveis de Ambiente
| Variável | Descrição |
|---|---|
HEYGEN_API_KEY | obrigatória para render |
HEYGEN_REGION | us (padrão) ou eu |
HF_LOG_LEVEL | debug, info, warn, error |
Loop de Desenvolvimento
npx hyperframes init meu-video --template product
cd meu-video
# edite index.html
npx hyperframes lint
npx hyperframes preview --open
npx hyperframes render --out output.mp4