# Pack Animated: convierte un MP4 en un sitio animado con el scroll

> El Animated Website Creator convierte un vídeo en una página guiada por el scroll en cinco pasos: análisis, extracción, seis secciones, construcción, vista previa. Requisitos, seis ejemplos y límites.

Canonical: https://bmad-plus.rochetta.fr/es/docs/packs/animated/
Language: es
BMAD+ version: 0.23.1
Documentation reviewed: 2026-10-19
Author: Laurent Rochetta
License: MIT

Documentación de BMAD+ › [Packs](https://bmad-plus.rochetta.fr/es/docs/packs/) › Pack Animated: convierte un MP4 en un sitio animado con el scroll

El pack Animated instala el Animated Website Creator, un agente que convierte un MP4 corto en una única página web en la que el vídeo se reproduce fotograma a fotograma al hacer scroll, con secciones de texto que aparecen y desaparecen encima. Es el patrón de las páginas de producto de gama alta. El agente hace toda la cadena: inspecciona el vídeo, extrae imágenes optimizadas, escribe la página con un sistema de diseño integrado y la sirve en local para que la previsualices. Encaja en un lanzamiento de producto, la presentación de un inmueble, un portfolio o cualquier escaparate cuya historia lleve un buen vídeo.

<a id="when-to-use"></a>
## Cuándo usarlo

- Ya tienes un buen MP4 de 5 a 30 segundos y quieres una página construida a su alrededor, no un sitio generalista.
- Aceptas una página de un solo archivo HTML con estilos y scripts incrustados y una carga de varios megabytes de imágenes.
- No es para sitios con mucho contenido y muchas páginas, ni cuando una política estricta de seguridad de contenido prohíbe el código incrustado.

<a id="installed"></a>
## Qué se instala

Un pack empaquetado en `.agents/skills/pack-animated/`: el archivo del agente `animated-website-agent.md` (proceso, sistema de diseño, arquitectura del código, lista de calidad, resolución de problemas) y una plantilla de workflow `templates/animated-website-workflow.md`. El agente responde a peticiones como animated website, scroll animation, video to website, convert video to website o luxury website from video.

<a id="process"></a>
## El proceso en cinco pasos

1. Analizar el vídeo con `ffprobe` y presentar duración, resolución, fotogramas por segundo, total de fotogramas y códec. El agente recomienda un número de fotogramas y te pide confirmar antes de extraer nada.
2. Extraer y optimizar fotogramas en WebP con dos comandos ffmpeg, uno por tamaño: escritorio 1920 por 1080 y móvil 960 por 540, más un `manifest.json`. El presupuesto de carga es menos de 10 MB en escritorio y menos de 5 MB en móvil.
3. Preparar el contenido de seis secciones superpuestas: Hero (nombre, lema, cifras clave), Vision (una cita), Details (características con iconos), Grid (cuatro a seis tarjetas), Context (lugar o información secundaria) y CTA (llamada a la acción y contacto).
4. Construir el sitio: un único archivo HTML con el sistema de diseño completo, la animación canvas y las secciones.
5. Servir y previsualizar en local, y después iterar sobre velocidad, colores y texto hasta quedar conforme.

**Número de fotogramas recomendado según la duración del vídeo**

| Duración del vídeo | Fotogramas | Altura de scroll |
| --- | --- | --- |
| 0 a 5 s | 60 a 90 | 400vh |
| 5 a 15 s | 100 a 150 | 650vh |
| 15 a 30 s | 150 a 200 | 800vh |
| 30 s o más | tope de 200 | 900vh |

<a id="design-system"></a>
### El sistema de diseño integrado

La página trae un aspecto fijo que el agente adapta a tu tema (inmueble, producto tecnológico, portfolio, restaurante o automóvil cambian el color de acento, el contenido del hero, las cifras clave y la llamada a la acción). Sus ingredientes: una paleta oscura cálida, una tipografía con serifas para títulos y otra sin serifas para el texto, tarjetas con efecto cristal, una capa de grano de película y viñeta, partículas flotantes, un cursor personalizado en escritorio, marcadores de capítulo, una pantalla de carga de marca con barra de progreso y un motor de pausas de scroll: en lugar de asociar linealmente scroll y fotogramas, frena cerca de cada sección de texto para que siga siendo legible. Una sección de galería con paralaje puede usar seis o siete fotogramas del vídeo.

<a id="quick-start"></a>
## Inicio rápido

1. **Instalar FFmpeg tú mismo** BMAD+ no lo instala. El agente necesita `ffmpeg` y `ffprobe` en el PATH, con el codificador `libwebp` (`ffmpeg -hide_banner -encoders` debe listarlo). Python 3 solo se usa para el servidor de vista previa local.

   ```sh
   winget install FFmpeg
   ```
2. **Instalar el pack** Core se añade automáticamente. En macOS instala FFmpeg con `brew install ffmpeg` en lugar de la línea anterior.

   ```sh
   npx bmad-plus install --packs animated
   ```
3. **Pedir el sitio y dar la ruta del vídeo** Indica el concepto (producto, inmueble, portfolio) y, si los tienes, los colores de marca y los textos de las secciones.

   ```sh
   Convierte product-demo.mp4 en un sitio animado con el scroll para el lanzamiento de una lámpara inteligente.
   ```

<a id="examples"></a>
## Ejemplos para copiar

<a id="example-animated-build-site"></a>
### Construir el sitio completo a partir de un vídeo

La frase de ejemplo del propio instalador es «animated website from hero.mp4». No existe un comando /animated: el agente responde a peticiones como esa.

**En tu asistente de IA**

```text
Convierte product-demo.mp4 en un sitio animado con el scroll. El producto es la lámpara inteligente Lumen, que sale en marzo. Color de acento #2563eb, llamada a la acción «Reservar».
```

**Lo que deberías obtener** El agente muestra el análisis del vídeo, recomienda un número de fotogramas y te pide confirmar. Después extrae los fotogramas WebP (escritorio y móvil con un manifiesto), construye la página con las seis secciones y el sistema de diseño, y la sirve en local para la vista previa. Cuenta con iterar después sobre velocidad y texto.

<a id="example-animated-analyse-first"></a>
### Analizar solo el vídeo, sin extraer nada todavía

Úsalo para dimensionar el proyecto antes de comprometerte con una carga.

**En tu asistente de IA**

```text
Analiza hero.mp4 con ffprobe y recomienda un número de fotogramas y una altura de scroll. No extraigas nada hasta que yo confirme.
```

**Lo que deberías obtener** Un bloque con duración, resolución, fotogramas por segundo, total de fotogramas y códec, y luego la recomendación de la tabla anterior (para un vídeo de 12 segundos: 100 a 150 fotogramas y una altura de scroll de 650vh). El agente espera tu visto bueno.

<a id="example-animated-real-estate"></a>
### Adaptar el tema a la presentación de un inmueble

La tabla de temas del agente cubre inmueble, producto tecnológico, portfolio, restaurante y automóvil.

**En tu asistente de IA**

```text
Construye un sitio animado de lujo a partir de villa-tour.mp4 para la venta de un inmueble. Hero: el nombre de la villa y su precio. Barra de cifras: superficie, dormitorios, baños. Llamada a la acción: «Programar una visita». Sección Context: distancias a la playa y al aeropuerto.
```

**Lo que deberías obtener** Las seis secciones se rellenan con tu contenido en el diseño de inmueble: nombre y precio en el Hero con una barra de cifras de cristal, una cita en Vision, la lista de características en Details, una cuadrícula de tarjetas, las distancias en Context y un CTA de reserva de visita con una tarjeta de contacto.

<a id="example-animated-tune-scroll"></a>
### Ajustar la sensación del scroll

El agente conoce los controles detrás de las peticiones habituales; di lo que sientes y ajusta el parámetro correspondiente.

**En tu asistente de IA**

```text
El scroll va demasiado rápido y las secciones de texto se sienten pegajosas. Haz el scroll más lento y suaviza la pausa.
```

**Lo que deberías obtener** El agente alarga la sección de animación (por ejemplo de 650vh hacia 900vh para un scroll más lento) y baja `DWELL_PEAK` (de 3,5 hacia 2,5) para una pausa menos pegajosa. Para fotogramas más fluidos o más reactivos cambia `LERP_FACTOR` (0,09 hacia 0,05 para más fluido, hacia 0,15 para más reactivo).

<a id="example-animated-reduce-weight"></a>
### Reducir el peso de los fotogramas

Úsalo cuando los fotogramas de escritorio superan 10 MB o la página tarda en cargar.

**En tu asistente de IA**

```text
Los fotogramas de escritorio pesan 14 MB. Llévalos por debajo del presupuesto de 10 MB con menos calidad o menos fotogramas e indícame qué cambió.
```

**Lo que deberías obtener** El agente vuelve a extraer con menos calidad (por ejemplo 60 en lugar de 80) o menos fotogramas (por ejemplo 90) y luego indica la nueva carga de escritorio y móvil frente a los presupuestos de 10 MB y 5 MB.

<a id="example-animated-quality-check"></a>
### Pasar la lista de calidad antes de entregar

El agente lleva una lista previa a la entrega; pídele que la repase e informe con honestidad de lo que pudo y no pudo verificar.

**En tu asistente de IA**

```text
Antes de que publique, repasa tu lista de calidad sobre el sitio que construiste. Para cada punto, di si lo verificaste ejecutando algo o solo leyendo el código.
```

**Lo que deberías obtener** La lista cubre: animación fluida sin tirones, primer fotograma visible en menos de un segundo, cargador operativo, carga dentro del presupuesto, movimiento reducido resuelto con un fotograma fijo, sin fotogramas en blanco, canvas adaptable, cursor personalizado, partículas, las seis secciones que aparecen y desaparecen, letras del hero animadas, barra de cifras legible, galería con paralaje, pausa de scroll natural y marcadores de capítulo actualizados. Solo una ejecución en un navegador puede confirmar lo visual.

<a id="outputs"></a>
## Qué escribe y dónde

**Salida de una construcción**

| Ruta | Contenido |
| --- | --- |
| `<output>/frames/desktop/` | Fotogramas WebP de 1920 por 1080 |
| `<output>/frames/mobile/` | Fotogramas WebP de 960 por 540 |
| `<output>/frames/manifest.json` | Metadatos de los fotogramas |
| `<output>/index.html` | La página completa: estilos, scripts, secciones, cargador |

<a id="data-and-prerequisites"></a>
## Flujos de datos y requisitos

- Requerido en tu máquina: FFmpeg y FFprobe con el codificador `libwebp`, y un MP4 de origen. Python 3 solo hace falta para el servidor de vista previa (sirve cualquier servidor de archivos estáticos). Instala FFmpeg con `winget install FFmpeg` en Windows o `brew install ffmpeg` en macOS.
- Tu vídeo y los fotogramas se quedan en local. La vista previa la sirve `python3 -m http.server 8080` en tu máquina; servir por HTTP también evita las restricciones del navegador con archivos locales.
- Antes de generar la página, el agente pregunta cómo cargar las fuentes. Por defecto usa fuentes del sistema (Georgia para los títulos, la fuente del sistema para el texto), sin petición externa. Puedes aportar archivos `.woff2` para alojarlos tú (Playfair Display y DM Sans están bajo licencia SIL Open Font; comprueba la licencia de cualquier otra fuente). Google Fonts solo se usa si lo pides explícitamente, después de que el agente avise de que el navegador de cada visitante contactará entonces con Google y de que puede hacer falta mencionarlo en la política de privacidad del sitio. Esa petición pertenecería al sitio generado, no a BMAD+.

<a id="limits"></a>
## Límites y trampas

> **Nota · Los fotogramas salen de dos comandos de FFmpeg, no de un script** El pack no incluye ningún script de extracción. El agente ejecuta un comando `ffmpeg` por tamaño, con muestreo `fps=N/D`, calidad `libwebp` de 80 y numeración desde `frame-0000.webp`, y luego escribe `frames/manifest.json` y comprueba que cada carpeta tiene N archivos. Una fuente que no sea 16:9 se escala y recorta para llenar el encuadre; con un vídeo vertical, el agente pregunta qué encuadre quieres antes de extraer. Sin el codificador `libwebp` los comandos fallan, así que revisa antes `ffmpeg -hide_banner -encoders`.

> **Advertencia · Un archivo con código incrustado** La página es un único archivo HTML con estilos y scripts incrustados. Un sitio que aplique una política estricta de seguridad de contenido sin código incrustado la bloqueará, salvo que separes el archivo y adaptes la política. La página también depende del elemento `canvas` y de la carga de las imágenes; pruébala en un móvil de gama media.

> **Nota · Problemas habituales** FFmpeg no encontrado: instálalo y reabre el terminal. Sin codificador WebP: usa una compilación de FFmpeg que liste `libwebp`. Animación entrecortada: menos fotogramas, ratio de píxeles limitado a 2, menos partículas. Destello blanco entre fotogramas: revisa la extracción y el recurso al fotograma más cercano. Canvas en blanco en móvil: comprueba que existen los fotogramas móviles y la ruta de la carpeta. Cargador bloqueado: un fotograma devuelve 404, mira la consola. Errores de origen cruzado en local: sirve por HTTP en lugar de abrir el archivo.

> **Nota · Procedencia** El pack Animated Website lo escribió Laurent Rochetta en Oveanet, su empresa, y se integró en BMAD+.

**Véase también**

- [Los diez packs lado a lado](https://bmad-plus.rochetta.fr/es/docs/packs/packs-overview/)
- [Pack Design (Atelier) para interfaces](https://bmad-plus.rochetta.fr/es/docs/packs/design/)
- [Pack SEO / GEO antes del lanzamiento](https://bmad-plus.rochetta.fr/es/docs/packs/seo/)

[Documentación de BMAD+](https://bmad-plus.rochetta.fr/es/docs/) · [Packs](https://bmad-plus.rochetta.fr/es/docs/packs/)

[Código en GitHub](https://github.com/lrochetta/BMAD-PLUS)
