Tutorial
|
por Hunt Team

Usar FFmpeg con yt-dlp

Aunque yt-dlp es una herramienta muy capaz para descargar contenido multimedia, depende en gran medida de FFmpeg para manejar tareas de post-procesado. Sin FFmpeg, te pierdes funciones críticas como fusionar streams de vídeo y audio de alta calidad, convertir archivos a diferentes formatos e incrustar metadatos.

Para sacar el máximo partido a yt-dlp, es esencial instalar y configurar correctamente FFmpeg. Esta guía cubre cómo configurarlo y por qué es necesario.

Instalar FFmpeg y FFProbe

Para que yt-dlp utilice FFmpeg, necesita acceso a los ejecutables binarios independientes. Nota: instalar wrappers de Python como ffmpeg-python con pip no es suficiente; necesitas los binarios reales del software.

  • Windows: descarga las últimas builds. El método más simple es extraer ffmpeg.exe y ffprobe.exe y colocarlos en la misma carpeta que tu yt-dlp.exe. Alternativamente, puedes colocarlos en una carpeta dedicada y añadir esa carpeta al PATH del sistema.
  • Linux/macOS: normalmente es mejor instalarlo con tu gestor de paquetes (p. ej. apt install ffmpeg o brew install ffmpeg), que gestiona automáticamente el PATH.

Por qué FFmpeg es esencial para yt-dlp

Puede que notes que sin FFmpeg, yt-dlp no puede descargar vídeos 1080p o 4K de forma efectiva en sitios como YouTube. Esto se debe a que las plataformas modernas suelen servir vídeo en alta definición y audio de alta calidad como streams separados.

  1. Fusión de streams (muxing): yt-dlp descarga la mejor pista de vídeo y la mejor pista de audio por separado. Después llama a FFmpeg para “muxearlas” (combinarlas) en un único archivo (como MP4 o MKV). Sin FFmpeg, te quedarías con dos archivos separados o tendrías que elegir una versión de menor calidad ya combinada.
  2. Conversión de formato: si necesitas un formato de salida específico (p. ej. convertir un vídeo musical directamente a MP3 o FLAC), FFmpeg realiza el proceso de transcodificación.
  3. Metadatos y capítulos: FFProbe (parte del suite de FFmpeg) permite a yt-dlp analizar los streams para asegurar que se incrustan correctamente metadatos, miniaturas y capítulos.

Configurar el PATH del sistema

Si prefieres no mantener los binarios en la misma carpeta que yt-dlp, debes asegurarte de que el sistema operativo sepa dónde encontrarlos. Esto se hace añadiendo la carpeta bin de FFmpeg a tu variable de entorno PATH.

En Windows:

  1. Busca “Editar las variables de entorno del sistema”.
  2. Haz clic en Variables de entorno.
  3. En “Variables del sistema”, encuentra Path y haz clic en Editar.
  4. Añade la ruta completa al directorio bin de FFmpeg (p. ej. C:\Program Files\ffmpeg\bin).

Una vez configurado, reinicia tu terminal. Puedes verificar que funciona ejecutando ffmpeg -version. Si aparecen los detalles de la versión, yt-dlp lo detectará y lo usará automáticamente.

Entender la fusión de vídeo y audio

La potencia de yt-dlp está en su selección de formatos. El comportamiento por defecto suele ser bestvideo+bestaudio/best.

  • El operador +: indica al descargador que obtenga los mejores streams de vídeo y audio por separado.
  • La fusión: una vez descargados, FFmpeg se encarga de combinarlos. Por ejemplo, puede combinar un stream de vídeo WebM con un stream de audio Opus en un contenedor MKV.

Si los códecs son compatibles con el contenedor deseado (p. ej. MP4), FFmpeg simplemente copiará los streams (rápido). Si son incompatibles, los recodificará (más lento, pero asegura compatibilidad). Puedes controlar este comportamiento con las extensas opciones de selección de formato de yt-dlp.

Fuentes

VIDEO API

Discover why Hunt is the preferred API provider for developers.