Quando Usar
Use esta skill quando:
- Criando vídeos programáticos a partir de código (não vídeo generativo de IA)
- Construindo conteúdo de vídeo baseado em dados (gráficos, estatísticas, vídeos personalizados)
- Produzindo vídeos em lote a partir de modelos + dados
- Criando conteúdo animado para redes sociais (TikTok, Reels, Shorts)
- Construindo vídeos de produto/explicativos com controle preciso
Início Rápido
1. Criar um Novo Projeto
python3 Skills/remotion/scripts/remotion_cli.py new my-video --template blank
cd Sites/my-video
2. Escreva Sua Composição
Edite src/Composition.tsx - este é o seu vídeo definido como componentes React.
3. Pré-visualize no Studio
python3 Skills/remotion/scripts/remotion_cli.py studio my-video
4. Renderize para MP4
python3 Skills/remotion/scripts/remotion_cli.py render my-video --output output.mp4
Conceitos Principais
Composições
Uma composição define as dimensões, duração e FPS do seu vídeo:
<Composition
id="MyVideo"
component={MyComponent}
durationInFrames={300} // 10 segundos a 30fps
fps={30}
width={1920}
height={1080}
/>
Animação Baseada em Frame
TODAS as animações DEVEM usar useCurrentFrame(). Animações CSS são PROIBIDAS.
const frame = useCurrentFrame();
const { fps } = useVideoConfig();
const opacity = interpolate(frame, [0, fps], [0, 1], { extrapolateRight: 'clamp' });
Sequências
Use <Sequence> para temporizar quando os elementos aparecem:
<Sequence from={30} durationInFrames={60}>
<Title />
</Sequence>
Referências de Regras
Leia estas para padrões detalhados (carregados das skills upstream do Remotion):
| Regra | Descrição |
|---|---|
references/animations.md | Fundamentos de animação baseada em frame |
references/timing.md | Springs, easing, curvas de interpolação |
references/compositions.md | Definindo composições, stills, pastas |
references/sequencing.md | Temporização e ordenação de elementos |
references/videos.md | Incorporando vídeos - cortar, volume, velocidade |
references/audio.md | Manipulação de áudio - importar, cortar, volume |
references/assets.md | Imagens, fontes, arquivos estáticos |
references/transitions.md | Transições de cena |
references/text-animations.md | Padrões de animação tipográfica |
references/charts.md | Padrões de visualização de dados |
references/display-captions.md | Legendas estilo TikTok |
Comandos CLI
# Gerenciamento de projetos
python3 Skills/remotion/scripts/remotion_cli.py new <nome> [--template blank|hello-world]
python3 Skills/remotion/scripts/remotion_cli.py studio <nome>
python3 Skills/remotion/scripts/remotion_cli.py render <nome> [--composition ID] [--output caminho]
python3 Skills/remotion/scripts/remotion_cli.py list
# Opções de renderização
--composition ID # Composição específica a renderizar (padrão: primeira)
--output CAMINHO # Caminho do arquivo de saída (padrão: out/video.mp4)
--fps N # Substituir FPS
--width N # Substituir largura
--height N # Substituir altura
--codec CODEC # h264, h265, vp8, vp9, prores (padrão: h264)
Padrões Comuns
Fade In/Out
const frame = useCurrentFrame();
const { fps, durationInFrames } = useVideoConfig();
const fadeIn = interpolate(frame, [0, fps], [0, 1], { extrapolateRight: 'clamp' });
const fadeOut = interpolate(frame, [durationInFrames - fps, durationInFrames], [1, 0], { extrapolateLeft: 'clamp' });
const opacity = fadeIn * fadeOut;
Animação com Spring (Movimento Natural)
const scale = spring({
frame,
fps,
config: { damping: 200 }, // Suave, sem bounce
});
Elementos Escalonados
{items.map((item, i) => (
<Sequence key={i} from={i * 10}>
<Item data={item} />
</Sequence>
))}
Vídeo Baseado em Dados
type VideoProps = { title: string; stats: number[] };
export const DataVideo: React.FC<VideoProps> = ({ title, stats }) => {
// Animar com base em props
};
// Em Root.tsx:
<Composition
id="DataVideo"
component={DataVideo}
defaultProps={{ title: "Resultados Q4", stats: [10, 20, 30] }}
// ...
/>
Integração com Zo
Renderização em Lote
Use /zo/ask para renderizar múltiplos vídeos em paralelo:
for row in data:
# Cada chamada renderiza com props diferentes
await render_video(row)
Localização da Saída
Os projetos residem em Sites/<nome>/ para consistência com o sistema de sites do Zo.
Os vídeos renderizados são enviados para Sites/<nome>/out/.
Restrições
- Sem animações CSS - Elas não renderizarão corretamente
- Sem classes de animação do Tailwind - Mesmo problema
- Baseado em frame apenas - Todo movimento vindo de
useCurrentFrame() - Intensivo em CPU - A renderização leva tempo; vídeos complexos = renderização mais longa
- Node.js necessário - Remotion precisa de ambiente Node (já disponível no Zo)