Esta es una guía para escribir marcado React con Remotion. Si esto no es relevante, carga Mejores prácticas de Remotion en su lugar.
Reglas generales
Anima propiedades usando useCurrentFrame() e interpolate().
Usa interpolate() en lugar de spring().
Usa Easing.bezier() para personalizar la temporización, incluyendo movimientos bruscos o con sobreimpulso.
Usa Easing.spring() si deseas animaciones con resorte.
Los elementos HTML que tengan sentido hacerse interactivos en el Studio deben usar Interactive: <div> -> <Interactive.Div>.
Establece una prop name descriptiva como name="Título principal" para Interactive, Solid, Sequence.
import { useCurrentFrame, Easing, interpolate, Interactive } from "remotion";
export const FadeIn = () => {
const frame = useCurrentFrame();
return (
<Interactive.Div
name="Título"
style={{
opacity: interpolate(frame, [0, 60], [0, 1], {
extrapolateRight: "clamp",
extrapolateLeft: "clamp",
easing: Easing.bezier(0.16, 1, 0.3, 1),
}),
}}
>
¡Hola Mundo!
</Interactive.Div>
);
};
Mantén la llamada a interpolate() en línea dentro de la prop style.
Prefiere las propiedades CSS scale, translate, rotate sobre transform.
// 👍 Fotogramas clave editables en línea y abreviaturas de transformación
style={{
scale: interpolate(frame, [0, 100], [0, 1]),
translate: interpolate(frame, [0, 100], ["0px 0px", "100px 100px"]),
rotate: interpolate(frame, [0, 100], ["20deg", "90deg"]),
}}
// 👎 Los valores ocultos y las cadenas de transformación se vuelven más difíciles de editar en Studio
const scale = interpolate(frame, [0, 100], [0, 1]);
style={{
transform: `scale(${scale})`,
}}
Las transiciones o animaciones CSS están PROHIBIDAS: no se renderizarán correctamente. Los nombres de clases de animación de Tailwind están PROHIBIDOS: no se renderizarán correctamente.
Coloca los assets en la carpeta public/ en la raíz de tu proyecto.
Usa staticFile() para hacer referencia a archivos de la carpeta public/.
Agrega video y audio usando @remotion/media.
Agrega imágenes usando el componente <Img>.
Usa staticFile() para archivos en public/ o pasa una URL remota directamente:
import { Audio, Video } from "@remotion/media";
import { staticFile } from "remotion";
export const MyComposition = () => {
return (
<>
<Video src={staticFile("video.mp4")} style={{ opacity: 0.5 }} />
<Audio src={staticFile("audio.mp3")} />
<Img src={staticFile("logo.png")} style={{ width: 100, height: 100 }} />
<Video src="https://remotion.media/video.mp4" />
</>
);
};
Para retrasar contenido, envuélvelo en <Sequence> y usa from.
Para limitar la duración de un elemento, usa durationInFrames de <Sequence>.
<Sequence> por defecto es un relleno absoluto que cubre la escena.
Para contenido en línea, usa layout="none".
const Main = () => {
const {fps} = useVideoConfig();
return (
<AbsoluteFill>
<Sequence name="Fondo">
<Background />
</Sequence>
<Sequence name="Título" from={30} durationInFrames={60} layout="none">
<Title />
</Sequence>
<Sequence name="Subtítulo" from={60} durationInFrames={60} layout="none">
<Subtitle />
</Sequence>
</AbsoluteFill>
);
}
export const Title = () => {
const frame = useCurrentFrame();
return (
<div
style={{
opacity: interpolate(frame, [0, 60], [0, 1], {
extrapolateRight: "clamp",
extrapolateLeft: "clamp",
easing: Easing.bezier(0.16, 1, 0.3, 1),
}),
}}
>
Título
</div>
);
};
export const Subtitle = () => {
return <div>Subtítulo</div>;
};
Mapas
Consulta map.md para elegir entre mapas estáticos simples, mapas de Mapbox y mapas de MapLibre.
Voz en off
Consulta voiceover.md para agregar voz en off generada por IA a composiciones de Remotion usando ElevenLabs TTS.
Recorte
Consulta trimming.md para patrones de recorte: cortar el inicio o el final de las animaciones.
Incrustación de videos
Consulta embedding-videos.md para conocimientos avanzados sobre incrustación de videos: recorte, volumen, velocidad, bucle, tono.
Incrustación de audio
Consulta audio.md para funciones avanzadas de audio como recorte, volumen, velocidad, tono.
Transiciones
Consulta transitions.md para patrones de transición de escenas.
Efectos visuales y de píxeles
Al crear un efecto visual, prefiere: 1. animación normal de Remotion/HTML/CSS/SVG/filtro/mezcla/máscara, 2. un efecto listado mediante effects.md, incluyendo en HTML renderizado a través de <HtmlInCanvas>, 3. un createEffect() personalizado mediante effects.md cuando el usuario solicite un efecto reutilizable o específico del proyecto, 4. <HtmlInCanvas onPaint> personalizado mediante html-in-canvas.md solo si ningún efecto se ajusta.
Para superposiciones de fugas de luz, consulta light-leaks.md. Documentación: https://www.remotion.dev/docs/effects
Efectos disponibles: brightness(), contrast(), colorKey(), duotone(), grayscale(), hue(), invert(), saturation(), tint(), linearGradient(), linearGradientTint(), thermalVision(), blur(), linearProgressiveBlur(), radialProgressiveBlur(), zoomBlur(), dropShadow(), glow(), lightTrail(), evolve(), venetianBlinds(), mirror(), scale(), uvTranslate(), xyTranslate(), barrelDistortion(), chromaticAberration(), fisheye(), cornerPin(), wave(), burlap(), emboss(), dotGrid(), halftone(), noise(), noiseDisplacement(), paper(), roughenEdges(), pattern(), pixelate(), pixelDissolve(), scanlines(), speckle(), shine(), shrinkwrap(), vignette(), contourLines(), checkerboard(), halftoneLinearGradient(), gridlines(), whiteNoise(), tvSignalOff(), lines(), rings(), waves(), zigzag(), lightLeak(), starburst().
Contenido 3D
Consulta 3d.md para contenido 3D en Remotion usando Three.js y React Three Fiber.
Efectos de sonido
Cuando necesites usar efectos de sonido, carga el archivo ./sfx.md para más información.
Visualización de audio
Cuando necesites visualizar audio (barras de espectro, formas de onda, efectos reactivos a graves), carga el archivo ./audio-visualization.md para más información.
Subtítulos
Cuando trates con subtítulos o leyendas, carga la habilidad Remotion Captions para más información.
Fuentes de Google
Es la forma recomendada de cargar fuentes en Remotion. Consulta google-fonts.md para saber cómo cargar fuentes de Google.
Fuentes locales
Consulta local-fonts.md para saber cómo cargar fuentes locales.
GIFs
Consulta gifs.md para saber cómo mostrar GIFs sincronizados con la línea de tiempo de Remotion.
Imágenes avanzadas
Consulta images.md para dimensionar y posicionar imágenes, rutas de imágenes dinámicas y obtener dimensiones de imágenes.
Animaciones Lottie
Consulta lottie.md para incrustar animaciones Lottie en Remotion.
Temporización avanzada
Consulta timing.md para temporización avanzada con interpolate y easing Bézier, y resortes.
Videos parametrizados
Consulta parameters.md para hacer una composición parametrizable agregando un esquema Zod.
Medición de nodos DOM
Consulta measuring-dom-nodes.md para medir las dimensiones de elementos DOM en Remotion.
Medición de texto
Consulta measuring-text.md para medir dimensiones de texto, ajustar texto a contenedores y verificar desbordamiento.
Uso de FFmpeg
Para algunas operaciones de video, como recortar videos o detectar silencio, se debe usar FFmpeg. Carga el archivo ./ffmpeg.md para más información.
Detección de silencio
Cuando necesites detectar y recortar segmentos silenciosos de archivos de video o audio, carga el archivo ./silence-detection.md.
Duración, dimensiones y datos dinámicos
Consulta calculate-metadata.md para establecer dinámicamente la duración de la composición, las dimensiones y las props.
Composiciones avanzadas
Consulta compositions.md para saber cómo definir imágenes fijas, carpetas, props predeterminados y cómo anidar composiciones.
Secuenciación avanzada
Consulta sequencing.md para más patrones de secuenciación: retraso, recorte, limitación de duración de elementos.
Instalación de módulos
Usa npx remotion add para agregar nuevos paquetes con la versión correcta:
npx remotion add @remotion/media
Esto aplica para paquetes @remotion/*, mediabunny, @mediabunny/* y zod.
Vista previa del marcado
Haz esto solo si crees que el usuario quiere ver la vista previa.
npx remotion studio --no-open
Esto iniciará un proceso de larga duración e imprimirá la URL del servidor para la vista previa. Si ya está iniciado, se imprimirá la URL.
Opcional: verificación de renderizado de un fotograma
Puedes renderizar un solo fotograma con la CLI para verificar diseño, colores o temporización. Omítelo para ediciones triviales, refactorizaciones puras o cuando ya tengas suficiente confianza desde Studio o renderizados anteriores.
npx remotion still [composition-id] --scale=0.25 --frame=30
A 30 fps, --frame=30 es la marca de un segundo (--frame tiene base cero).