O que Remotion — Crie Vídeos com React faz?
Fonte: remotion-dev/remotion · 43.6k ⭐ · v4.x · 🟢 ativo 2026 NPM:
remotion·@remotion/cli·@remotion/player·@remotion/lambdaDocumentação: https://www.remotion.dev/
1. Modelo mental central
- Um vídeo é uma sequência de componentes React renderizados quadro a quadro
- Você recebe um número de
frame(0 → N) e uma tela em branco — o resto é CSS / SVG / Canvas / WebGL - Remotion compila seu React em uma série de quadros PNG/JPEG e depois codifica para MP4 via FFmpeg
2. Quando usar
- Geração programática de vídeos (vídeos explicativos, anúncios de vídeo personalizados, vídeos baseados em dados)
- Vídeos de retrospectiva anual / estatísticas (como GitHub Unwrapped, Spotify Wrapped)
- Explicadores de marketing criados a partir de texto + dados (não editados manualmente no AE/Premiere)
- Vídeos de tutorial / ferramentas para desenvolvedores gerados a partir de código
Quando NÃO usar
- Edição de vídeo com cenas reais (use Premiere / Final Cut)
- Motion graphics tradicionais (After Effects é mais eficiente)
- Vídeos únicos — o custo inicial não compensa
3. Instalação (novo projeto)
npx create-video@latest meu-video
cd meu-video
npm install
npm start # Abre o Remotion Studio
Modelos oferecidos
- Hello World
- TypeScript
- JavaScript
- React 18 / 19
- Audiogram
- Stargazer (animação de estrelas do GitHub)
- Three.js
- Vazio
Adicionar a um projeto existente
npm install remotion @remotion/cli
Crie src/Root.tsx:
import { Composition } from 'remotion';
import { MeuVideo } from './MeuVideo';
export const RemotionRoot: React.FC = () => {
return (
<Composition
id="MeuVideo"
component={MeuVideo}
durationInFrames={150}
fps={30}
width={1920}
height={1080}
defaultProps={{ titulo: 'Olá' }}
/>
);
};
Registre a raiz em remotion.config.ts:
import { Config } from '@remotion/cli/config';
Config.setEntryPoint('./src/index.ts');
4. Conceitos principais
<Composition />
Define um vídeo: qual componente renderiza, duração, fps, resolução, props padrão.
useCurrentFrame()
Retorna o número do quadro atual (começando em 0). Tudo anima a partir daqui:
import { useCurrentFrame, useVideoConfig, interpolate } from 'remotion';
export const MeuVideo: React.FC<{ titulo: string }> = ({ titulo }) => {
const frame = useCurrentFrame();
const { fps, durationInFrames } = useVideoConfig();
const opacidade = interpolate(frame, [0, 30], [0, 1], { extrapolateRight: 'clamp' });
return (
<div style={{ flex: 1, backgroundColor: '#0a0a0f', color: 'white', opacity: opacidade, display: 'flex', alignItems: 'center', justifyContent: 'center' }}>
<h1 style={{ fontSize: 120 }}>{titulo}</h1>
</div>
);
};
interpolate(frame, [de, para], [valorInicial, valorFinal], opcoes)
Mapeia o número do quadro para qualquer valor (posição, opacidade, escala, cor, etc.).
spring(...)
Curva de movimento natural:
import { spring, useCurrentFrame, useVideoConfig } from 'remotion';
const frame = useCurrentFrame();
const { fps } = useVideoConfig();
const escala = spring({
frame,
fps,
config: { damping: 100, stiffness: 200, mass: 0.5 },
});
<div style={{ transform: `scale(${escala})` }}>Conteúdo</div>
<Sequence from={f} durationInFrames={n}>
Desloca um componente para começar no quadro f:
import { Sequence } from 'remotion';
<Sequence from={0} durationInFrames={60}><Intro /></Sequence>
<Sequence from={60} durationInFrames={120}><Cena1 /></Sequence>
<Sequence from={180} durationInFrames={90}><Outro /></Sequence>
<Audio src={...} />
import { Audio } from 'remotion';
import musica from './musica.mp3';
<Audio src={musica} volume={0.5} />
<Img src={...} /> / <Video src={...} />
Incorpora imagens / clipes de vídeo na linha do tempo.
staticFile('...')
Referencia arquivos em public/ — Remotion resolve o caminho:
import { staticFile } from 'remotion';
<Img src={staticFile('logo.svg')} />
5. Renderização
Renderização local (CLI)
npx remotion render MeuVideo out/video.mp4
npx remotion render MeuVideo out/video.mp4 --props='{"titulo":"Olá"}'
npx remotion render MeuVideo out/video.mp4 --quality=high --codec=h265
Remotion Studio (pré-visualização + linha do tempo)
npm start # Abre http://localhost:3000
Remotion Player (incorporar em seu app React)
import { Player } from '@remotion/player';
import { MeuVideo } from './MeuVideo';
<Player
component={MeuVideo}
durationInFrames={150}
fps={30}
compositionWidth={1920}
compositionHeight={1080}
inputProps={{ titulo: 'Olá' }}
controls
style={{ width: '100%' }}
/>
Remotion Lambda (renderização na nuvem)
Para renderização em lote / server-side:
npm install @remotion/lambda
Configure a função AWS Lambda, implante o Remotion:
npx remotion lambda functions deploy
npx remotion lambda sites create
npx remotion lambda render MeuVideo --input-props='{"titulo":"Usuário 123"}'
6. Exemplo — vídeo baseado em dados
Gere um vídeo "Retrospectiva do Ano" personalizado:
import { Composition } from 'remotion';
import { RetrospectivaAno } from './RetrospectivaAno';
export const RemotionRoot = () => (
<Composition
id="Recap"
component={RetrospectivaAno}
durationInFrames={8 * 30} // 8 segundos a 30 fps
fps={30}
width={1080}
height={1920} // Vertical (mobile)
defaultProps={{
usuario: { nome: 'Alice', estatisticas: { commits: 1284, prs: 42, revisoes: 89 } },
}}
/>
);
Renderize para cada usuário:
for usuario in $(cat usuarios.json); do
npx remotion lambda render Recap --input-props="$usuario"
done
7. Preços / licenciamento
| Nível | Quem | Preço |
|---|---|---|
| Individual / equipe ≤ 3 | Pessoal, pequena empresa | Grátis (semelhante ao MIT) |
| Empresa ≤ 10 funcionários | Startup pequena | Grátis |
| Empresa maior | > 10 funcionários | $100/mês + $25/assento |
| Editor Starter | Construir seu próprio editor de vídeo usando Remotion | $600 (pagamento único) |
| Lambda | Renderização na nuvem | Pague por renderização (≈ alguns centavos por minuto de vídeo) |
Consulte https://www.remotion.dev/docs/license para os termos oficiais.
8. PROIBIDO
- ❌ NUNCA use Remotion para mecanismos de reprodução de vídeo em tempo real — ele foi projetado para renderizar em arquivo, não para transmissão ao vivo
- ❌ NUNCA coloque arquivos de vídeo reais > 100MB no bundle — use
staticFile()com mídia grande hospedada separadamente - ❌ NUNCA use
setTimeout,setIntervalourequestAnimationFramedentro de um componente Remotion — a determinismo vem deuseCurrentFrame()apenas - ❌ NUNCA busque dados dentro da renderização — pré-busque e passe via
inputProps - ❌ NUNCA renderize com mais quadros por componente do que o necessário — cada quadro custa tempo de renderização
- ❌ NUNCA envie renderizações Lambda comerciais sem uma licença para equipe > 3 pessoas
- ❌ NUNCA use
Math.random()diretamente — a saída não será determinística. Userandom()do Remotion com semente. - ❌ NUNCA anime com transições CSS — Remotion renderiza quadro a quadro; transições CSS não se aplicam. Use
interpolate()+ quadro.
9. Lista de verificação pré-voo
- [ ] remotion + @remotion/cli instalados
- [ ] src/Root.tsx com <Composition /> definindo o(s) vídeo(s)
- [ ] Todas as animações impulsionadas por useCurrentFrame() — sem setTimeout/setInterval
- [ ] Valores aleatórios usam random() do Remotion com semente (não Math.random)
- [ ] Carregamento de fontes: useFont ou <link> no <head>
- [ ] Arquivos de áudio via <Audio> com volume/corte adequados
- [ ] Para produção: renderize via Lambda OU remotion render CLI
- [ ] Preços verificados — nível correto para o tamanho da equipe
- [ ] inputProps tipados (TypeScript) para cada Composition
- [ ] Teste de renderização curta antes da renderização completa
10. Ajuste de dial
Depende totalmente do design do vídeo — Remotion é uma estrutura, não uma biblioteca visual.
11. Integração com DesignDNA
Remotion combina bem com os DNAs de marca do DesignDNA: use os tokens de DESIGN.md de uma marca (cores, fontes, espaçamento) como linguagem visual do seu vídeo gerado. Exemplo:
import { tokens } from '../design-md/stripe/tokens';
<div style={{ color: tokens.colors['stripe-purple'], fontFamily: tokens.typography.families[0] }}>
Intro com a marca Stripe
</div>
Seu vídeo "retrospectiva do ano" então combina com a identidade visual da sua marca.
12. Alternativas
| Cenário | Alternativa |
|---|---|
| Vídeo tradicional (sem código) | Adobe After Effects / Premiere |
| Vídeos com visualização de dados | D3 + gravação de tela OU Remotion + D3 |
| Componentes React animados (não vídeos completos) | Framer Motion · Motion · React Bits (veja a skill) |
| Animações web interativas | Lottie · GSAP |