Communitygithub.com

HyperFrames CLI (johnnyjclin/video-producer)

Ferramenta de linha de comando HyperFrames — hyperframes init, lint, validate, preview, render, transcribe, tts, doctor, browser, info, upgrade, compositions, docs, benchmark. Use ao iniciar um projeto, verificar ou validar composições, visualizar no estúdio, renderizar para vídeo, transcrever áudio, gerar TTS ou diagnosticar o ambiente HyperFrames.

O que é video-producer)?

O HyperFrames CLI é uma ferramenta de linha de comando abrangente para o ecossistema HyperFrames, que gerencia todo o pipeline de produção de vídeo baseado em navegador — desde a criação do projeto até a renderização final. Suporta inicialização de projetos com modelos, linting estático e validação dinâmica em navegador real (incluindo auditoria de contraste WCAG), visualização com recarga automática, renderização para MP4 ou WebM com várias opções de qualidade e FPS, transcrição de áudio/vídeo via Whisper, e geração de texto para fala (TTS). Ferramentas de diagnóstico como `doctor` e `browser` ajudam a resolver problemas de ambiente (Chrome, FFmpeg, Node.js). Recomendado para desenvolvedores que desejam criar vídeos programaticamente com composições HTML, garantindo qualidade visual e acessibilidade antes da renderização.

Funciona com✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/johnnyjclin/video-producer/tree/HEAD/.claude/skills/hyperframes-cli

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

HyperFrames CLI

Tudo é executado através de npx hyperframes. Requer Node.js >= 22 e FFmpeg.

Fluxo de trabalho

  1. Inicializar — npx hyperframes init my-video
  2. Escrever — crie a composição HTML (veja a skill hyperframes)
  3. Lint — npx hyperframes lint (verificações estáticas)
  4. Validar — npx hyperframes validate (verificações dinâmicas no navegador + auditoria de contraste)
  5. Visualizar — npx hyperframes preview
  6. Renderizar — npx hyperframes render

O lint detecta problemas estáticos (data-composition-id ausente, faixas sobrepostas, timelines não registradas). A validação detecta problemas de execução/visuais ao buscar em momentos específicos da composição pausada em um navegador real (contraste, overlays quebrados, assets ausentes). Execute ambos antes de renderizar.

Validação

npx hyperframes validate                 # validação completa (estática + contraste + contrato)
npx hyperframes validate --no-contrast   # ignorar auditoria de contraste WCAG em iterações rápidas
npx hyperframes validate --json          # saída legível por máquina

A validação busca em vários timestamps da composição pausada, captura a tela da página, amostra pixels atrás de cada elemento de texto para calcular taxas de contraste WCAG e verifica contratos em tempo de execução (registro de window.__timelines, presença de class="clip", atributos data-* válidos). Execute antes de cada renderização — é rápida e detecta problemas que o lint não vê.

Inicialização

npx hyperframes init my-video                        # assistente interativo
npx hyperframes init my-video --example warm-grain   # escolher um exemplo
npx hyperframes init my-video --video clip.mp4        # com arquivo de vídeo
npx hyperframes init my-video --audio track.mp3       # com arquivo de áudio
npx hyperframes init my-video --non-interactive       # ignorar prompts (CI/agentes)

Modelos: blank, warm-grain, play-mode, swiss-grid, vignelli, decision-tree, kinetic-type, product-promo, nyt-graph.

init cria a estrutura de arquivos correta, copia mídia, transcreve áudio com Whisper e instala skills de IA. Use em vez de criar arquivos manualmente.

Linting

npx hyperframes lint                  # diretório atual
npx hyperframes lint ./my-project     # projeto específico
npx hyperframes lint --verbose        # descobertas de nível informativo
npx hyperframes lint --json           # saída legível por máquina

Verifica index.html e todos os arquivos em compositions/. Relata erros (devem ser corrigidos), avisos (devem ser corrigidos) e informações (com --verbose).

Visualização

npx hyperframes preview                   # servir diretório atual
npx hyperframes preview --port 4567       # porta personalizada (padrão 3002)

Recarrega automaticamente com alterações nos arquivos. Abre o estúdio no navegador automaticamente.

Renderização

npx hyperframes render                                # MP4 padrão
npx hyperframes render --output final.mp4             # saída nomeada
npx hyperframes render --quality draft                # iteração rápida
npx hyperframes render --fps 60 --quality high        # entrega final
npx hyperframes render --format webm                  # WebM transparente
npx hyperframes render --docker                       # saída idêntica byte a byte
FlagOpçõesPadrãoNotas
--outputcaminhorenders/nome_timestamp.mp4Caminho de saída
--fps24, 30, 603060fps dobra o tempo de renderização
--qualitydraft, standard, highstandarddraft para iterar
--formatmp4, webmmp4WebM suporta transparência
--workers1-8 ou autoautoCada um inicia um Chrome
--dockerflagdesligadoSaída reproduzível
--gpuflagdesligadoCodificação acelerada por GPU
--strictflagdesligadoFalhar em erros de lint
--strict-allflagdesligadoFalhar em erros E avisos

Orientação de qualidade: draft enquanto itera, standard para revisão, high para entrega final.

Transcrição

npx hyperframes transcribe audio.mp3
npx hyperframes transcribe video.mp4 --model medium.en --language en
npx hyperframes transcribe subtitles.srt   # importar existente
npx hyperframes transcribe subtitles.vtt
npx hyperframes transcribe openai-response.json

Texto para Fala

npx hyperframes tts "Texto aqui" --voice af_nova --output narration.wav
npx hyperframes tts script.txt --voice bf_emma
npx hyperframes tts --list  # mostrar todas as vozes

Diagnóstico

npx hyperframes doctor       # verificar ambiente (Chrome, FFmpeg, Node, memória)
npx hyperframes browser      # gerenciar Chrome integrado
npx hyperframes info         # versão e detalhes do ambiente
npx hyperframes upgrade      # verificar atualizações

Execute doctor primeiro se a renderização falhar. Problemas comuns: FFmpeg ausente, Chrome ausente, pouca memória.

Outros

npx hyperframes compositions   # listar composições no projeto
npx hyperframes docs           # abrir documentação
npx hyperframes benchmark .    # benchmark de desempenho de renderização

Habilidades Relacionadas