Cuándo Usarlo
Usa esta skill cuando:
- Creando vídeos programáticos a partir de código (no vídeo generativo por IA)
- Construyendo contenido de vídeo basado en datos (gráficos, estadísticas, vídeos personalizados)
- Produciendo vídeos por lotes a partir de plantillas + datos
- Creando contenido animado para redes sociales (TikTok, Reels, Shorts)
- Construyendo vídeos de producto/explicativos con control preciso
Inicio Rápido
1. Crear un Nuevo Proyecto
python3 Skills/remotion/scripts/remotion_cli.py new mi-video --template blank
cd Sites/mi-video
2. Escribe tu Composición
Edita src/Composition.tsx - este es tu vídeo definido como componentes de React.
3. Vista Previa en el Estudio
python3 Skills/remotion/scripts/remotion_cli.py studio mi-video
4. Renderizar a MP4
python3 Skills/remotion/scripts/remotion_cli.py render mi-video --output salida.mp4
Conceptos Clave
Composiciones
Una composición define las dimensiones, duración y fps de tu vídeo:
<Composition
id="MiVideo"
component={MiComponente}
durationInFrames={300} // 10 segundos a 30fps
fps={30}
width={1920}
height={1080}
/>
Animación Basada en Fotogramas
TODAS las animaciones DEBEN usar useCurrentFrame(). Las animaciones CSS están PROHIBIDAS.
const frame = useCurrentFrame();
const { fps } = useVideoConfig();
const opacity = interpolate(frame, [0, fps], [0, 1], { extrapolateRight: 'clamp' });
Secuencias
Usa <Sequence> para temporizar cuándo aparecen los elementos:
<Sequence from={30} durationInFrames={60}>
<Titulo />
</Sequence>
Referencias de Reglas
Lee estas para patrones detallados (cargadas desde las skills upstream de Remotion):
| Regla | Descripción |
|---|---|
references/animations.md | Fundamentos de animación basada en fotogramas |
references/timing.md | Springs, easing, curvas de interpolación |
references/compositions.md | Definición de composiciones, imágenes fijas, carpetas |
references/sequencing.md | Temporización y orden de elementos |
references/videos.md | Incrustar vídeos - recortar, volumen, velocidad |
references/audio.md | Manejo de audio - importar, recortar, volumen |
references/assets.md | Imágenes, fuentes, archivos estáticos |
references/transitions.md | Transiciones de escena |
references/text-animations.md | Patrones de animación tipográfica |
references/charts.md | Patrones de visualización de datos |
references/display-captions.md | Subtítulos estilo TikTok |
Comandos CLI
# Gestión de proyectos
python3 Skills/remotion/scripts/remotion_cli.py new <nombre> [--template blank|hello-world]
python3 Skills/remotion/scripts/remotion_cli.py studio <nombre>
python3 Skills/remotion/scripts/remotion_cli.py render <nombre> [--composition ID] [--output ruta]
python3 Skills/remotion/scripts/remotion_cli.py list
# Opciones de renderizado
--composition ID # Composición específica a renderizar (por defecto: primera)
--output RUTA # Ruta del archivo de salida (por defecto: out/video.mp4)
--fps N # Sobrescribir FPS
--width N # Sobrescribir ancho
--height N # Sobrescribir alto
--codec CODEC # h264, h265, vp8, vp9, prores (por defecto: h264)
Patrones Comunes
Fundido de Entrada/Salida
const frame = useCurrentFrame();
const { fps, durationInFrames } = useVideoConfig();
const fadeIn = interpolate(frame, [0, fps], [0, 1], { extrapolateRight: 'clamp' });
const fadeOut = interpolate(frame, [durationInFrames - fps, durationInFrames], [1, 0], { extrapolateLeft: 'clamp' });
const opacity = fadeIn * fadeOut;
Animación con Spring (Movimiento Natural)
const scale = spring({
frame,
fps,
config: { damping: 200 }, // Suave, sin rebote
});
Elementos Escalonados
{items.map((item, i) => (
<Sequence key={i} from={i * 10}>
<Item data={item} />
</Sequence>
))}
Vídeo Basado en Datos
type VideoProps = { titulo: string; estadisticas: number[] };
export const VideoDatos: React.FC<VideoProps> = ({ titulo, estadisticas }) => {
// Animar basado en props
};
// En Root.tsx:
<Composition
id="VideoDatos"
component={VideoDatos}
defaultProps={{ titulo: "Resultados Q4", estadisticas: [10, 20, 30] }}
// ...
/>
Integración con Zo
Renderizado por Lotes
Usa /zo/ask para renderizar múltiples vídeos en paralelo:
for fila in datos:
# Cada llamada renderiza con diferentes props
await renderizar_video(fila)
Ubicación de Salida
Los proyectos residen en Sites/<nombre>/ para consistencia con el sistema de sitios de Zo.
Los vídeos renderizados se generan en Sites/<nombre>/out/.
Restricciones
- Sin animaciones CSS - No se renderizarán correctamente
- Sin clases de animación de Tailwind - Mismo problema
- Solo basado en fotogramas - Todo movimiento desde
useCurrentFrame() - Intensivo en CPU - El renderizado toma tiempo; vídeos complejos = renderizado más largo
- Node.js requerido - Remotion necesita entorno Node (ya disponible en Zo)