Communitygithub.com

Remotion (Criação de Vídeos com React)

Construa, depure e renderize vídeos programaticamente com Remotion (framework de vídeo baseado em React). Use quando o usuário quiser criar um vídeo com código, perguntar especificamente sobre Remotion, mencionar vídeo React, vídeo programático, MP4 a partir de React, explicador animado com código, narrador com legendas, vídeo orientado a dados ou colar um erro do Remotion. Abrange configuração de composição, padrões de animação useCurrentFrame (interpolate, spring), layout Sequence/AbsoluteFill, componentes de áudio/vídeo/imagem, o Studio e renderização via CLI / @remotion/renderer / Lambda. PULE para tarefas de vídeo que não são Remotion — use a habilidade `video` para geração de vídeo por IA (Veo, Sora, Runway, HeyGen).

O que é Remotion (Criação de Vídeos com React)?

Esta habilidade oferece conhecimento especializado sobre o Remotion, um framework que transforma componentes React em vídeos MP4 ou outros formatos. O conceito central é que cada quadro do vídeo é uma função pura do número do quadro (`frame`), impulsionada pelo hook `useCurrentFrame()`, garantindo renderização determinística e sem cintilação. A habilidade é indicada para usuários que desejam criar vídeos com código, depurar projetos Remotion existentes ou renderizar saídas, abrangendo desde a configuração inicial com `npx create-video@latest` até a renderização final via CLI, API programática (`@remotion/renderer`) ou Lambda. Ela fornece uma referência rápida de APIs essenciais (Composition, hooks, Sequence, AbsoluteFill, animações com interpolate/spring), regras rígidas (como evitar CSS transitions e manter componentes puros) e soluções para erros comuns. Por outro lado, a habilidade não deve ser usada para tarefas de edição de vídeo tradicional ou geração de vídeo por modelos de IA, que são cobertas por outras habilidades específicas. Ao seguir o fluxo de trabalho descrito — detectar/scaffold o projeto, localizar a composição, construir o componente com hooks, visualizar no Studio e renderizar — o usuário pode criar vídeos animados, orientados a dados e totalmente reproduzíveis. A verificação final sempre inclui a execução no Studio e a renderização de um segmento de teste para garantir que o resultado visual esteja correto.

Funciona com✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/AbdelrhmanAlquran/claude-skills/tree/HEAD/remotion

Perguntar na sua IA favorita

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

Documentação

Remotion

Remotion transforma componentes React em vídeos. Você escreve JSX, o Remotion chama seu componente uma vez por quadro a um fps fixo, e os quadros resultantes são unidos em um MP4 (ou outro formato).

Modelo mental central

Remotion fornece a você um número de quadro e uma tela em branco. Seu componente React decide o que renderizar naquele quadro.

Não há uma linha do tempo de animação no sentido imperativo. O tempo é um número (frame), e seu componente é uma função pura desse número mais as propriedades. É por isso que as animações devem ser conduzidas por useCurrentFrame() — transições CSS e setTimeout são não determinísticas durante a renderização e causarão cintilação ou dessincronização.

Quando usar esta habilidade

  • O usuário tem um projeto Remotion (remotion.config.ts ou @remotion/* no package.json) e deseja construir, alterar ou depurar uma composição
  • O usuário diz "vamos fazer um vídeo com Remotion / com código / programaticamente"
  • O usuário cola um erro do Remotion ou pergunta sobre interpolate, spring, Sequence, useCurrentFrame, Composition, etc.
  • O usuário deseja renderizar um projeto Remotion existente ou configurar a renderização Lambda

Quando NÃO usar

  • Gerar vídeo com modelos de IA (Veo, Sora, Runway, Kling, HeyGen) → use a habilidade video
  • Editar arquivos de vídeo existentes (cortar/aparar/concatenar) → ffmpeg, não Remotion
  • Transmissão ao vivo → Remotion é apenas renderização offline

Fluxo de trabalho

  1. Detectar ou criar o projeto.

    • Novo projeto: npx create-video@latest (interativo — escolhe um template como Hello World, Blank, JavaScript, TikTok, etc.)
    • Existente: verifique se há remotion.config.ts, src/Root.tsx e @remotion/cli no package.json. Observe a versão principal do Remotion — as APIs evoluem, e a URL correta da documentação é https://www.remotion.dev/docs (mais recente) ou páginas com versão fixa.
  2. Localizar ou criar a composição. As composições são registradas em src/Root.tsx via <Composition id="..." component={...} durationInFrames={...} fps={30} width={1920} height={1080} defaultProps={{...}} />. O id é o que a CLI renderiza pelo nome.

  3. Construir o componente usando useCurrentFrame + useVideoConfig para tempo e metadados. Componha o layout com <AbsoluteFill>, fatie o tempo com <Sequence>.

  4. Visualizar no Studio: npx remotion studio (recarrega automaticamente). Não tente "testar" quadros isoladamente — abra o Studio.

  5. Renderizar: npx remotion render <CompositionId> [output.mp4]. O codec padrão é H.264 / MP4. Consulte references/rendering.md para flags e API programática.

Referência rápida da API

Consulte os arquivos vinculados para mais profundidade — carregue-os apenas quando uma tarefa precisar deles.

TópicoArquivo
Composition, hooks, Sequence, AbsoluteFill, layoutreferences/core-concepts.md
interpolate, spring, Easing, escalonamento, padrões de animação comunsreferences/animation.md
Renderização: flags da CLI, @remotion/renderer, Lambda, codecs, propsreferences/rendering.md
Áudio/vídeo/imagens: <Audio>, <Video>, <Img>, <OffthreadVideo>, legendasreferences/media.md
Configuração do projeto, convenções de arquivo, remotion.config.tsreferences/project-setup.md
Padrões comuns: animações de digitação, terços inferiores, orientado a dados, parallaxreferences/patterns.md

Regras rígidas

  1. Anime via useCurrentFrame(). Nunca setTimeout, requestAnimationFrame ou transition CSS. Eles cintilam durante a renderização porque cada quadro é renderizado independentemente em um navegador headless.
  2. durationInFrames é obrigatório e deve ser um número inteiro. Total de segundos = durationInFrames / fps.
  3. Mantenha os componentes puros. Sem efeitos colaterais de nível superior, sem Math.random() sem uma semente determinística — o mesmo quadro deve sempre produzir os mesmos pixels.
  4. Não busque dados durante a renderização. Use delayRender() / continueRender() para bloquear a prontidão do quadro enquanto os dados carregam, ou pré-busque e passe via props.
  5. Use <OffthreadVideo> em vez de <Video> quando possível para leituras de vídeo não bloqueantes durante a renderização (mais rápido, menos memória).
  6. Passe dados dinâmicos via --props (CLI) ou inputProps (Studio/programático), não editando arquivos.

Erros comuns

Erro / sintomaCausaCorreção
Cintilação / movimento incompatível no MP4 vs visualização do StudioUsou transições CSS ou animação não baseada em quadroSubstitua por interpolate(frame, ...) ou spring({ frame, fps })
"Composition not found"Erro de digitação no ID ou registro de <Composition> ausenteVerifique src/Root.tsx
Renderização travadelayRender() pendente nunca chamou continueRender()Encontre a promise não resolvida; adicione try/finally
Falta de memória em vídeos longos<Video> mantendo quadros na memóriaMude para <OffthreadVideo>
Áudio fora de sincroniaIncompatibilidade de fps do arquivo de áudio ou início no quadro erradoEnvolva <Audio> em <Sequence from={...}>

Verificação

Após fazer alterações, sempre:

  • Execute npx remotion studio e percorra a linha do tempo para confirmar se a alteração parece correta em vários quadros (início, meio, fim)
  • Para alterações programáticas, renderize um pequeno segmento de teste: npx remotion render <id> out.mp4 --frames=0-60
  • Verificação de tipo: npx tsc --noEmit se o projeto for TypeScript

Não afirme sucesso sem uma destas etapas. Código que compila não é o mesmo que um vídeo que parece correto.

Habilidades Relacionadas