Remotion
Remotion convierte componentes de React en vídeos. Escribes JSX, Remotion llama a tu componente una vez por fotograma a un fps fijo, y los fotogramas resultantes se unen en un MP4 (u otro formato).
Modelo mental central
Remotion te da un número de fotograma y un lienzo en blanco. Tu componente React decide qué renderizar en ese fotograma.
No existe una línea de tiempo de animación en el sentido imperativo. El tiempo es un número (frame), y tu componente es una función pura de ese número más las props. Por eso las animaciones deben manejarse con useCurrentFrame() — las transiciones CSS y setTimeout no son deterministas durante el renderizado y provocarán parpadeos o desincronización.
Cuándo usar este skill
- El usuario tiene un proyecto Remotion (
remotion.config.tso@remotion/*en package.json) y quiere construir, cambiar o depurar una composición - El usuario dice "hagamos un vídeo con Remotion / con código / programáticamente"
- El usuario pega un error de Remotion o pregunta sobre
interpolate,spring,Sequence,useCurrentFrame,Composition, etc. - El usuario quiere renderizar un proyecto Remotion existente o configurar el renderizado con Lambda
Cuándo NO usar
- Generar vídeo con modelos de IA (Veo, Sora, Runway, Kling, HeyGen) → usa el skill video
- Editar archivos de vídeo existentes (cortar/recortar/unir) → ffmpeg, no Remotion
- Transmisión en vivo → Remotion es solo para renderizado offline
Flujo de trabajo
-
Detectar o crear el proyecto.
- Proyecto nuevo:
npx create-video@latest(interactivo — elige una plantilla como Hello World, Blank, JavaScript, TikTok, etc.) - Proyecto existente: verifica
remotion.config.ts,src/Root.tsxy@remotion/clienpackage.json. Anota la versión mayor de Remotion — las APIs evolucionan y la URL correcta de la documentación eshttps://www.remotion.dev/docs(última) o páginas con versión específica.
- Proyecto nuevo:
-
Localizar o crear la composición. Las composiciones se registran en
src/Root.tsxmediante<Composition id="..." component={...} durationInFrames={...} fps={30} width={1920} height={1080} defaultProps={{...}} />. Elides lo que la CLI renderiza por nombre. -
Construir el componente usando
useCurrentFrame+useVideoConfigpara el tiempo y los metadatos. Compón el diseño con<AbsoluteFill>, segmenta el tiempo con<Sequence>. -
Vista previa en el Studio:
npx remotion studio(recarga automática). No intentes "probar" fotogramas de forma aislada — abre el Studio. -
Renderizar:
npx remotion render <CompositionId> [output.mp4]. El códec predeterminado es H.264 / MP4. Consulta references/rendering.md para conocer las opciones y la API programática.
Referencia rápida de la API
Consulta los archivos enlazados para más profundidad — cárgalos solo cuando una tarea los necesite.
| Tema | Archivo |
|---|---|
| Composition, hooks, Sequence, AbsoluteFill, diseño | references/core-concepts.md |
interpolate, spring, Easing, escalonamiento, patrones de animación comunes | references/animation.md |
Renderizado: opciones de CLI, @remotion/renderer, Lambda, códecs, props | references/rendering.md |
Audio/vídeo/imágenes: <Audio>, <Video>, <Img>, <OffthreadVideo>, subtítulos | references/media.md |
Configuración del proyecto, convenciones de archivos, remotion.config.ts | references/project-setup.md |
| Patrones comunes: animaciones de escritura, tercios inferiores, basados en datos, parallax | references/patterns.md |
Reglas estrictas
- Anima mediante
useCurrentFrame(). Nunca usessetTimeout,requestAnimationFrameo transiciones CSS (transition). Parpadean durante el renderizado porque cada fotograma se renderiza de forma independiente en un navegador headless. durationInFrameses obligatorio y debe ser un entero. El total de segundos =durationInFrames / fps.- Mantén los componentes puros. Sin efectos secundarios de nivel superior, sin
Math.random()sin una semilla determinista — el mismo fotograma siempre debe producir los mismos píxeles. - No hagas fetch en el renderizado. Usa
delayRender()/continueRender()para bloquear la preparación del fotograma mientras se cargan los datos, o precarga y pasa mediante props. - Usa
<OffthreadVideo>en lugar de<Video>cuando sea posible para lecturas de vídeo no bloqueantes durante el renderizado (más rápido, menos memoria). - Pasa datos dinámicos mediante
--props(CLI) oinputProps(Studio/programático), no editando archivos.
Errores comunes
| Error / síntoma | Causa | Solución |
|---|---|---|
| Parpadeo / movimiento desajustado en MP4 vs vista previa en Studio | Se usaron transiciones CSS o animaciones no basadas en fotogramas | Reemplaza con interpolate(frame, ...) o spring({ frame, fps }) |
| "Composition not found" | Error tipográfico en el ID o falta el registro de <Composition> | Verifica src/Root.tsx |
| El renderizado se cuelga | delayRender() pendiente nunca llamó a continueRender() | Encuentra la promesa no resuelta; agrega try/finally |
| Falta de memoria en vídeos largos | <Video> mantiene fotogramas en memoria | Cambia a <OffthreadVideo> |
| Audio desincronizado | El archivo de audio tiene fps incorrecto o comienza en el fotograma equivocado | Envuelve <Audio> en <Sequence from={...}> |
Verificación
Después de realizar cambios, siempre:
- Ejecuta
npx remotion studioy recorre la línea de tiempo para confirmar que el cambio se vea correcto en varios fotogramas (inicio, medio, final) - Para cambios programáticos, renderiza un segmento de prueba corto:
npx remotion render <id> out.mp4 --frames=0-60 - Verificación de tipos:
npx tsc --noEmitsi el proyecto es TypeScript
No declares éxito sin uno de estos pasos. El código que compila no es lo mismo que un vídeo que se vea bien.