Cómo Migrar Videos de Vimeo a Bunny.net

¿Estás pagando $20, $50 o más al mes por Vimeo para alojar los videos de tu curso online? Te cuento cómo migré toda mi biblioteca de videos y ahora pago menos de $5 al mes.

Si eres creador de cursos online, tienes una membresía en Skool, o manejas cualquier tipo de contenido educativo en video, probablemente estés familiarizado con el dolor de ver tu factura de Vimeo cada mes. La buena noticia es que existe una alternativa que puede reducir tus costos drásticamente: Bunny.net Stream.

En este tutorial te explico paso a paso cómo migrar todos tus videos de Vimeo a Bunny.net de forma automatizada, preservando tu estructura de carpetas y sin perder ningún contenido.

¿Por Qué Abandoné Vimeo?

No me malinterpretes, Vimeo es una excelente plataforma. Pero su modelo de precios está diseñado para creadores que necesitan sus funciones sociales y de comunidad. Si solo usas Vimeo como CDN de video para tus cursos (como la mayoría de nosotros), estás pagando de más.

La Matemática que me Hizo Cambiar

La diferencia es brutal. Bunny.net cobra por uso real:

• Almacenamiento: $0.005/GB/mes
• Transferencia: $0.01/GB entregado
• Encoding: $0.005/minuto

Para cursos asincrónicos donde los estudiantes ven el contenido de forma esporádica, esto significa ahorros enormes.

Lo Que Necesitas Antes de Empezar

1. Cuenta en Bunny.net con Stream habilitado

Si aún no tienes cuenta, créala aquí (no requiere tarjeta de crédito para empezar).

Una vez dentro:

1. Ve al Dashboard → Stream
2. Crea una nueva Video Library
3. Anota estos datos que necesitarás:
   • Library ID (número de 5-6 dígitos)
   • API Key (en la pestaña API)
   • CDN Hostname (formato: vz-xxxxxxxx-xxx.b-cdn.net)

2. Token de API de Vimeo

1. Ve a developer.vimeo.com/apps
2. Crea una nueva app o usa una existente
3. Genera un Access Token con permisos de lectura
4. Importante: Necesitas Vimeo Pro o Business para acceder a las URLs de descarga

3. Node.js 18 o superior

Verifica tu versión:

node --version

Si necesitas instalarlo, ve a nodejs.org.

Paso 1: Descarga la Herramienta de Migración

Creé una herramienta open source específicamente para esta migración. Clona el repositorio:

git clone https://github.com/ctala/vimeo-to-bunny-migration.git
cd vimeo-to-bunny-migration

Paso 2: Configura tus Credenciales

Copia el archivo de ejemplo y edítalo:

cp .env.example .env

Abre .env con tu editor favorito y completa:

# Vimeo API
VIMEO_ACCESS_TOKEN=tu_token_de_vimeo

# Bunny.net Stream
BUNNY_LIBRARY_ID=123456
BUNNY_API_KEY=tu_api_key_de_bunny
BUNNY_CDN_HOSTNAME=vz-xxxxxxxx-xxx.b-cdn.net

Paso 3: Ejecuta una Prueba en Seco (Dry Run)

Antes de migrar nada, veamos qué videos se van a procesar:

node migrate.js --dry-run

Esto te mostrará:

• Cuántos videos tienes en Vimeo
• Cuáles ya existen en Bunny (si los hay)
• Qué carpetas se convertirán en colecciones
• Cualquier video que no tenga URL de descarga

Paso 4: Ejecuta la Migración

Si todo se ve bien en el dry run, ejecuta la migración real:

node migrate.js

El script:

• ✅ Obtiene todos tus videos de Vimeo (con paginación automática)
• ✅ Verifica duplicados contra Bunny.net
• ✅ Crea colecciones basadas en tus carpetas de Vimeo
• ✅ Selecciona la mejor calidad disponible (hasta 4K)
• ✅ Sube cada video a Bunny.net
• ✅ Guarda un log de todo para posible rollback

Dependiendo de cuántos videos tengas, esto puede tomar desde minutos hasta un par de horas. El script maneja automáticamente los límites de rate de ambas APIs.

Paso 5: Genera tu Catálogo de Videos

Una vez completada la migración, genera un catálogo con todas las URLs:

node generate-video-catalog.js

Esto crea un archivo VIDEO_CATALOG.md con:

• Todos tus videos organizados por colección
• URLs de embed listas para copiar
• URLs de streaming HLS
• URLs de thumbnails

Cómo Embeber Videos de Bunny.net en Skool

Si usas Skool para tu comunidad, sabrás que solo acepta YouTube, Vimeo, Loom y Wistia de forma nativa. Pero hay una solución elegante usando el editor HTML.

Código de Embed (Funciona en Skool, Teachable, Thinkific, WordPress)

<div style="position: relative; padding-top: 56.25%;">
  <iframe
    src="https://iframe.mediadelivery.net/embed/LIBRARY_ID/VIDEO_ID"
    loading="lazy"
    style="border: none; position: absolute; top: 0; height: 100%; width: 100%;"
    allow="accelerometer; gyroscope; autoplay; encrypted-media; picture-in-picture"
    allowfullscreen="true">
  </iframe>
</div>

Reemplaza:

• LIBRARY_ID con tu ID de biblioteca
• VIDEO_ID con el GUID del video (lo encuentras en el catálogo generado)

URL Directa HLS (Para reproductores personalizados)

https://vz-xxxxxxxx-xxx.b-cdn.net/VIDEO_ID/playlist.m3u8

Thumbnail del Video

https://vz-xxxxxxxx-xxx.b-cdn.net/VIDEO_ID/thumbnail.jpg

Solución de Problemas Comunes

«no_download_url» en algunos videos

Esto significa que Vimeo no proporciona URL de descarga para ese video. Causas comunes:

• Video en estado borrador
• Descargas deshabilitadas en configuración de privacidad
• Video aún procesándose

Solución: Entra a Vimeo, edita el video, y habilita las descargas.

La migración se interrumpió a mitad

No te preocupes. El script detecta duplicados automáticamente. Simplemente ejecútalo de nuevo:

node migrate.js

Solo procesará los videos que faltan.

Quiero hacer rollback

En la carpeta data/ encontrarás rollback_info.json con los comandos curl necesarios para eliminar cada video de Bunny.net si necesitas revertir.

Próximos Pasos Después de la Migración

1. Actualiza los embeds en tu plataforma – Usa el catálogo generado para reemplazar los iframes de Vimeo por los de Bunny
2. Prueba la reproducción – Verifica que los videos se reproduzcan correctamente en diferentes dispositivos
3. Monitorea el uso – En el dashboard de Bunny.net puedes ver estadísticas de visualización
4. Cancela Vimeo – Una vez confirmado que todo funciona, puedes cancelar tu suscripción de Vimeo

Conclusión

Migrar de Vimeo a Bunny.net fue una de las mejores decisiones que tomé para optimizar los costos de mi negocio de cursos online. El proceso con esta herramienta automatizada toma menos de una hora para bibliotecas de cientos de videos.

Si tienes preguntas sobre el proceso o encuentras algún problema, deja un comentario abajo o abre un issue en el repositorio de GitHub.

Publicaciones relacionadas:

Los Cofundadores y los Socios para el éxito de una Startup Inversión Ángel ¿Qué es y cómo conseguirla para tu Startup? Los abogados como actor clave del ecosistema de Startups Marketing de Contenidos: ¿Por qué es Crucial para Emprendedores y Startups?