Communitygithub.com

Remotion — Crie Vídeos com React

Remotion é uma estrutura React que permite criar vídeos programaticamente usando componentes, props, CSS, Canvas e SVG. Ideal para geração de vídeos explicativos, anúncios personalizados e conteúdo baseado em dados.

O que é Remotion — Crie Vídeos com React?

Remotion é um framework React de código aberto (43.6k estrelas no GitHub, ativo) que permite a desenvolvedores criar vídeos programaticamente. A ideia central é que um vídeo é uma sequência de componentes React renderizados quadro a quadro, usando `useCurrentFrame()` para animação. Suporta renderização local via CLI, incorporação em apps React com o Remotion Player e renderização em nuvem com AWS Lambda. É útil para gerar vídeos explicativos, anúncios personalizados, vídeos baseados em dados (como Year-in-Review) e muito mais, tudo com a flexibilidade do ecossistema React. A ferramenta inclui estúdio de pré-visualização, suporte a áudio, imagens e vídeos, e integra-se naturalmente com design tokens de marcas. Sua licença é gratuita para pequenas equipes e empresas, com planos pagos para uso comercial mais amplo.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/tiantangcao1980-web/DesignDNA-Skills/tree/HEAD/designdna/skills/remotion

Perguntar na sua IA favorita

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

Documentação

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/lambda Documentaçã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ívelQuemPreço
Individual / equipe ≤ 3Pessoal, pequena empresaGrátis (semelhante ao MIT)
Empresa ≤ 10 funcionáriosStartup pequenaGrátis
Empresa maior> 10 funcionários$100/mês + $25/assento
Editor StarterConstruir seu próprio editor de vídeo usando Remotion$600 (pagamento único)
LambdaRenderização na nuvemPague 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, setInterval ou requestAnimationFrame dentro de um componente Remotion — a determinismo vem de useCurrentFrame() 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. Use random() 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árioAlternativa
Vídeo tradicional (sem código)Adobe After Effects / Premiere
Vídeos com visualização de dadosD3 + 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 interativasLottie · GSAP

Habilidades Relacionadas