Skill Claude Code · render em código aberto

Imagem estática vira filme cinematográfico — sem IA de vídeo

PixFlow recria a qualidade de efeitos do pixflow.net em código aberto: parallax 2.5D real, grain, color grade, vinheta, aberração cromática, bloom, movimentos de câmera e transições. Todo o movimento é construído programaticamente — render determinístico, sem Runway, Kling ou Sora.

# o pipeline (skill pixflow-motion)
movie spec (YAML)
  Depth-Anything-V2  (depth, sem torch)
  WebGL / GLSL       (parallax + efeitos)
  Remotion
  FFmpeg
  MP4

# render
node cli/pixflow-motion.mjs render demo.movie.yaml demo.mp4
O que é

Movimento de verdade, sem alucinação

Geradores de vídeo por IA inventam pixels (e erros). O PixFlow faz o oposto: parte da sua imagem e a move com profundidade real, de forma reproduzível. v1: imagem → filme. v2: o mesmo motor aceita vídeo no lugar da foto.

🌌 Parallax 2.5D real

Gera o depth map de cada imagem (Depth-Anything-V2, via transformers.js, sem torch) e separa as camadas com profundidade.

🎨 Look cinematográfico

Color grade, grão, vinheta, aberração cromática e bloom — 6 looks prontos donos das intensidades.

⚙️ Determinístico e local

WebGL/GLSL → Remotion → FFmpeg → MP4. Mesma entrada, mesmo vídeo. Sem chave de API.

Como funciona

Do spec ao MP4

Você dá imagens + um "roteiro de movimento" (movie spec YAML) — cenas, textos, looks, câmeras, durações — e o motor monta o filme. Câmeras: push-in, pull-out, ken-burns, pan, dolly, orbit, float, handheld, static. Transições: cut, crossfade, dip-to-black.

movie spec (YAML) Depth-Anything-V2 WebGL / GLSL Remotion FFmpeg MP4
Pré-requisitos

O que precisa pra rodar

Testado em Linux aarch64 (NVIDIA GB10 / DGX). Nessa arquitetura a CLI reusa um Chromium do Playwright sozinha — ou defina PIXFLOW_CHROME.

📦 Node + deps

Instala o motor e a CLI pixflow-motion.

cd skill && npm install

🧩 Chromium

Remotion renderiza no Chrome headless. Em aarch64 a CLI resolve sozinha.

# ou: export PIXFLOW_CHROME=/path/chrome

🖼️ Imagens + spec

Você traz as imagens e o movie spec. O render não gera imagem nem roteiro.

# examples/demo.movie.yaml
Guia de uso · passo a passo

Do zero ao filme

Comandos reais da CLI pixflow-motion. O schema completo do movie spec está em skill/SKILL.md.

1

Instale as dependências

Uma vez, dentro da pasta da skill.

cd skill && npm install
2

Cheque o ambiente

Confirma depth, Chromium e FFmpeg antes de renderizar.

node cli/pixflow-motion.mjs check-deps
3

Escreva o movie spec (YAML)

Cenas com imagem, look, camera, duração, transição e caption (kicker/título/corpo).

# scene: { image, look: cinema-dramatico, camera: push_in, dur: 4 }
4

Renderize o MP4

Gera o depth, aplica parallax + look + transições e exporta via Remotion + FFmpeg.

node cli/pixflow-motion.mjs render ../examples/demo.movie.yaml ../examples/demo.mp4
Looks & limites

A biblioteca — e a fronteira honesta

PixFlow é o estágio final de render, não a fábrica inteira. Saber o que ele faz (e o que não faz) é o que evita frustração.

🎨 Looks & câmeras

# 6 looks
cinema-dramatico · sci-fi-cyberpunk · noir-film
retro-vhs · sonho-etereo · acao-epico

# 9 câmeras
push_in · pull_out · ken_burns · pan · dolly
orbit · float · handheld · static

✅ Faz / ❌ não faz

 depth map + parallax 2.5D
 look (grade/grão/vinheta/bloom) + transições
 legenda (fade) + áudio se você apontar
────────────────────────────
 não gera as imagens (você traz)
 não escreve o roteiro/spec
 não tem narração/TTS

Tudo que vem antes (ideia → roteiro → imagens → narração) é o que o videoprodutor orquestra.

Roadmap · ecossistema

MVP funcional, e o que vem

PixFlow é a peça de render em código aberto. Complementa mdd (direção), video-plan-editor (estratégia/beat sheet) e promptprof (refino de prompt).

✅ MVP
Render ponta a pontaDepth + parallax 2.5D + 6 looks + 9 câmeras + 3 transições + legenda + áudio → MP4 determinístico.
⏳ Efeitos
Transições GLSL + overlaysGlitch, whip, zoom-blur, partículas e light leaks em overlay.
⏳ Cor
LUT .cube + beat-syncColor grade por LUT e sincronia de cortes com a trilha.
⏳ Avançado
Segmentação SAM2 + export OTIOCamadas por objeto e interoperação com NLEs.