Remotion — Criação Programática de Vídeos com React
Crie vídeos programaticamente usando componentes React. O framework mais maduro para produção de vídeo baseada em código.
Visão Geral
- Repositório: github.com/remotion-dev/remotion (21K+ estrelas)
- Linguagem: TypeScript / React
- Licença: Gratuito para indivíduos e empresas com faturamento abaixo de $1M
- Instalação:
npm install remotion @remotion/cli @remotion/transitions - Documentação: remotion.dev/docs
Conceitos Principais
Composição
Um <Composition> define as dimensões, taxa de quadros e duração de um vídeo:
import { Composition } from "remotion";
export const RemotionRoot: React.FC = () => {
return (
<Composition
id="MyVideo"
component={MyVideo}
durationInFrames={300} // 10 segundos a 30fps
fps={30}
width={1920}
height={1080}
/>
);
};
Primitivas de Animação
useCurrentFrame() — Retorna o número do quadro atual (indexado a partir de 0):
const frame = useCurrentFrame();
interpolate() — Mapeia intervalos de quadros para valores de saída:
import { interpolate, useCurrentFrame } from "remotion";
const opacity = interpolate(frame, [0, 30], [0, 1], {
extrapolateRight: "clamp",
});
spring() — Animação baseada em mola física:
import { spring, useCurrentFrame, useVideoConfig } from "remotion";
const { fps } = useVideoConfig();
const scale = spring({ frame, fps, config: { damping: 200 } });
Sequenciamento
— Desloca conteúdo no tempo:
<Sequence from={30} durationInFrames={60}>
<MyScene />
</Sequence>
— Coloca filhos um após o outro:
import { Series } from "remotion";
<Series>
<Series.Sequence durationInFrames={90}>
<IntroScene />
</Series.Sequence>
<Series.Sequence durationInFrames={150}>
<MainScene />
</Series.Sequence>
<Series.Sequence durationInFrames={60}>
<OutroScene />
</Series.Sequence>
</Series>
— Container posicionado em tela cheia:
<AbsoluteFill style={{ backgroundColor: "#0a0a0a" }}>
<h1>Hello World</h1>
</AbsoluteFill>
Transições
import { linearTiming, TransitionSeries } from "@remotion/transitions";
import { fade } from "@remotion/transitions/fade";
import { slide } from "@remotion/transitions/slide";
<TransitionSeries>
<TransitionSeries.Sequence durationInFrames={90}>
<Scene1 />
</TransitionSeries.Sequence>
<TransitionSeries.Transition
presentation={fade()}
timing={linearTiming({ durationInFrames: 15 })}
/>
<TransitionSeries.Sequence durationInFrames={90}>
<Scene2 />
</TransitionSeries.Sequence>
</TransitionSeries>
Transições disponíveis: fade, slide, wipe, flip, clockWipe, none
Mídia
import { Video, Audio, Img, staticFile } from "remotion";
// Arquivos estáticos vão em /public
<Video src={staticFile("demo.mp4")} />
<Audio src={staticFile("music.mp3")} volume={0.5} />
<Img src={staticFile("logo.png")} />
Configuração do Projeto
# Criar novo projeto
npx create-video@latest my-video
# Ou manualmente:
mkdir my-video && cd my-video
npm init -y
npm install remotion @remotion/cli @remotion/transitions react react-dom
npm install -D typescript @types/react
Arquivos Necessários
src/index.ts (ponto de entrada):
import { registerRoot } from "remotion";
import { RemotionRoot } from "./Root";
registerRoot(RemotionRoot);
remotion.config.ts:
import { Config } from "@remotion/cli/config";
Config.setVideoImageFormat("jpeg");
Config.setOverwriteOutput(true);
Comandos
# Pré-visualizar no navegador (Remotion Studio)
npx remotion studio
# Renderizar para MP4
npx remotion render MyVideo out/video.mp4
# Renderizar quadros específicos
npx remotion render MyVideo out/video.mp4 --frames=0-90
# Renderizar como GIF
npx remotion render MyVideo out/video.gif --image-format=png
# Renderizar imagem estática
npx remotion still MyVideo out/thumbnail.png --frame=45
Melhores Práticas
- Sempre limitar interpolações: Use
extrapolateRight: "clamp"para evitar que valores ultrapassem os limites - Use spring() para movimentos naturais: Molas parecem mais orgânicas do que interpolação linear
- Mantenha cenas como componentes separados: Cada cena deve ser seu próprio componente React
- Use para cenas sequenciais: Mais fácil do que calcular deslocamentos manuais
- Defina durações explícitas: Todo Sequence deve ter
durationInFrames - Use AbsoluteFill: Para fundos de tela cheia e camadas sobrepostas
- Ativos estáticos em /public: Use
staticFile()para referenciá-los - Teste em diferentes quadros: Use o seletor de quadros do Remotion Studio para verificar animações
- Prefira transformações CSS:
transform: scale()etranslateX()são acelerados por GPU - Evite re-renderizações pesadas: Memoize cálculos caros com
useMemo
Padrões Comuns
Texto com fade-in:
const frame = useCurrentFrame();
const opacity = interpolate(frame, [0, 20], [0, 1], { extrapolateRight: "clamp" });
const y = interpolate(frame, [0, 20], [20, 0], { extrapolateRight: "clamp" });
<div style={{ opacity, transform: `translateY(${y}px)` }}>
Hello World
</div>
Lista de itens escalonados:
{items.map((item, i) => {
const delay = i * 8;
const opacity = interpolate(frame, [delay, delay + 15], [0, 1], {
extrapolateLeft: "clamp",
extrapolateRight: "clamp",
});
return <div key={i} style={{ opacity }}>{item}</div>;
})}
Efeito de máquina de escrever:
const charsShown = interpolate(frame, [0, text.length * 2], [0, text.length], {
extrapolateRight: "clamp",
});
<span>{text.slice(0, Math.floor(charsShown))}</span>
Extensões (todas open source, npm install)
@remotion/transitions— Transições de cena (fade, slide, wipe)@remotion/three— Cenas 3D com React Three Fiber em vídeo@remotion/lottie— Incorporar animações Lottie@remotion/gif— Incorporar arquivos GIF@remotion/media-utils— Utilitários de metadados de áudio/vídeo@remotion/noise— Ruído Perlin para efeitos orgânicos@remotion/paths— Utilitários de animação de caminhos SVG
Fontes de Skills Relacionadas
- Skills oficiais: github.com/remotion-dev/skills
- Templates: github.com/reactvideoeditor/remotion-templates
- Pipeline Superpowers: github.com/dojocodinglabs/remotion-superpowers