yt-dlp: La bifurcación moderna de youtube-dl para descargar vídeos

El 23 de octubre de 2020, la Asociación de la Industria Discográfica de Estados Unidos (RIAA) presentó una solicitud de eliminación por infracción de derechos de autor (DMCA) contra youtube-dl en GitHub. Tres días después, el 26 de octubre, apareció discretamente un nuevo repositorio en github.com/yt-dlp/yt-dlp. Para cuando GitHub restableció el proyecto original el 16 de noviembre —junto con un nuevo fondo de defensa para desarrolladores de un millón de dólares—, la nueva bifurcación ya había comenzado a absorber a los colaboradores de youtube-dl.

Esa bifurcación es ahora la principal. A mayo de 2026, yt-dlp registra más de 12 millones de descargas mensuales en PyPI. Su repositorio de GitHub tiene 160 766 estrellas. El proyecto publica una nueva versión aproximadamente cada dos semanas. La última etiqueta, al momento de escribir esto, es `2026.03.17`. Admite más de 1800 sitios de video y audio a través de su sistema de complementos extractores. A continuación, se presenta un análisis detallado de qué es yt-dlp y cómo usarlo. Además, se explica su situación legal en 2026 y por qué una instalación que funciona perfectamente puede dejar de funcionar repentinamente a mediados de 2025.

Origen de yt-dlp: la cadena de bifurcaciones de youtube-dl

El linaje es importante aquí porque explica una diferencia de comportamiento. yt-dlp implementa correcciones a las pocas horas de una interrupción de YouTube; youtube-dl puede tardar semanas. Tres proyectos forman parte de este árbol genealógico, y cada paso surgió de la frustración con el anterior.

youtube-dl fue el proyecto original. Ricardo García lo escribió en agosto de 2006, y Philipp Hagemeister lo lideró posteriormente con un grupo reducido bajo el nombre de `ytdl-org/youtube-dl`. Para 2020, se había convertido en la herramienta de archivo por excelencia, pero las solicitudes de incorporación de cambios se acumulaban y las correcciones de YouTube llegaban tarde.

Esa brecha fue la que dio origen a youtube-dlc, donde la "c" significaba "comunidad". `blackjack4494` bifurcó el repositorio en 2020 y la cola de fusiones se vació en cuestión de días. La bifurcación en sí quedó semiinactiva a finales del mismo año; uno de los mantenedores es frágil.

yt-dlp es una bifurcación de youtube-dlc. El repositorio se creó el 26 de octubre de 2020, tres días después de que la RIAA retirara youtube-dl. yt-dlp es una herramienta de línea de comandos que permite descargar vídeos y audio de sitios web compatibles. La "p" hace referencia a un mantenedor principal inicial (`pukkandan`). El proyecto ahora está dirigido por una organización de mantenedores múltiples que incluye a `coletdjnz`, `dirkf`, `Grub4K`, `bashonly` y `seproDev`. Para enero de 2021, yt-dlp había absorbido la base de colaboradores de youtube-dlc. Se había convertido en la bifurcación dominante de youtube-dl. El enfoque estaba en características y mejoras que no se habían incorporado al proyecto original.

Algunos datos del proyecto merecen ser destacados. yt-dlp utiliza versionado por calendario, por lo que una etiqueta como `2026.03.17` es literalmente la fecha de lanzamiento. La licencia es The Unlicense, una dedicación explícita al dominio público que ni siquiera la mayoría de los proyectos FOSS utilizan. El repositorio tiene 13.348 bifurcaciones y 2.507 incidencias abiertas. Ubuntu 22.04 reemplazó youtube-dl con yt-dlp como su descargador de vídeo predeterminado, y Debian hizo lo mismo con bookworm. La lista de sitios compatibles en `supportedsites.md` actualmente incluye más de 1.500 entradas con nombre; el propio código fuente incluye cerca de 1.800 módulos extractores con carga diferida. Arch, Fedora, NixOS, Homebrew, Chocolatey, Scoop y Winget lo incluyen en sus paquetes. Entre veinte y treinta lanzamientos al año es lo que ha evitado que las distribuciones vuelvan a depender del repositorio principal, que es más lento.

Cómo la retirada de YT-DLP por parte de la RIAA en 2020 hizo inevitable su aparición

La notificación de la RIAA del 23 de octubre de 2020, conforme a la DMCA, se presentó en virtud del artículo 1201 del Título 17 del Código de los Estados Unidos, la cláusula de no elusión. Su argumento era que youtube-dl había eludido el mecanismo de firma de cifrado rotatorio de YouTube, que la RIAA definió como una medida tecnológica para proteger el acceso a las obras protegidas por derechos de autor. Inicialmente, GitHub acató la orden y eliminó el repositorio junto con diecisiete bifurcaciones.

Lo que siguió fue un caso típico de Streisand. Los desarrolladores republicaron el código fuente de maneras cada vez más ingeniosas, incluyendo una imagen de Twitter cuyos colores de píxeles codificaban todo el código. La Electronic Frontier Foundation envió una carta a GitHub el 16 de noviembre de 2020. Su argumento técnico era sencillo. Una firma que cualquier navegador compatible con los estándares puede ejecutar no es una "medida tecnológica que controle efectivamente el acceso" según el § 1201. youtube-dl utiliza la firma; no la infringe.

GitHub restableció el repositorio el mismo día. Además, prometió un fondo de defensa para desarrolladores de un millón de dólares y se comprometió a realizar una revisión técnica y legal manual de cada eliminación bajo la Sección 1201 en adelante. Este episodio impulsó la creación de yt-dlp. El repositorio de la nueva bifurcación aparece en el historial de confirmaciones tres días después de la eliminación. Nadie sabía aún si GitHub daría marcha atrás. Los desarrolladores querían tener garantías.

Instala yt-dlp en Windows, macOS y Linux.

La gente olvida la segunda parte de la instalación y luego se pregunta por qué falla el paso de fusión. yt-dlp por sí solo puede obtener una sola transmisión de cualquiera de sus sitios compatibles, claro. ¿Pero el mejor vídeo más el mejor audio? ¿Capítulos incrustados? ¿Un remux mp4? Todo eso se transfiere silenciosamente a `ffmpeg` y `ffprobe`. Si omites esos dos, tu primer intento con `bv*+ba/b` imprimirá algo críptico y fallará. Así que: instala ambos, siempre.

Para Windows, uso winget. `winget install yt-dlp.yt-dlp`, luego `winget install Gyan.FFmpeg`. Scoop funciona si ya lo usas; Chocolatey también. Si usar un gestor de paquetes te parece excesivo, el archivo independiente `yt-dlp.exe` está en GitHub Releases: simplemente colócalo en una carpeta, agrega la carpeta a PATH y listo.

Los usuarios de Mac tienen la versión sencilla. `brew install yt-dlp ffmpeg`. Una sola línea. Y listo.

Linux varía según la distribución. El repositorio principal de Debian lo incluye. Arch lo mantiene en `extra`. Fedora lo obtiene a través de los canales estándar. El problema es el tiempo: cuando llega un fallo de YouTube, las versiones de las distribuciones tienden a retrasarse varios días. La solución es la instalación de Python, que es la mejor manera de descargar vídeos el mismo día después de que llegue una solución: `python -m pip install -U yt-dlp` en cualquier sistema con Python 3.9 o posterior. Esa línea también actualiza en el mismo lugar. La opción curl-and-chmod todavía está en la documentación (`sudo curl -L https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -o /usr/local/bin/yt-dlp && sudo chmod +x /usr/local/bin/yt-dlp`), pero úsela solo cuando no exista ninguna opción en el gestor de paquetes.

Tras la instalación, `yt-dlp -U` actualiza las copias de pip y los binarios; omite las copias del gestor de paquetes a propósito. Elija un método de instalación y manténgalo. La combinación de ffmpeg y ffprobe es indispensable.

Comandos básicos de yt-dlp que realmente usarás

La guía básica es breve. El comando simple, `yt-dlp URL`, funciona para la mayoría de los casos. Todo lo demás requiere uno o dos parámetros.

Antes de descargar un vídeo de YouTube, ejecuta `yt-dlp -F URL` para ver las opciones disponibles. La salida muestra todos los formatos de vídeo, todos los flujos de audio y todos los flujos precombinados que el extractor encontró, junto con los códecs y los tamaños de archivo. La mayoría de la gente pasa directamente a `yt-dlp -f "bv*+ba/b" URL`. Este selector se lee como "mejor vídeo más mejor audio; si no están separados, se utilizará el mejor flujo combinado". Es la sintaxis principal de selección de formato de yt-dlp y vale la pena memorizarla. Añade `--merge-output-format mp4` para forzar el contenedor; añade `-x --audio-format mp3` para solo audio. Para los subtítulos, `--write-subs --sub-langs en` descarga los oficiales, y `--write-auto-subs` utiliza la pista generada automáticamente si no hay ninguna.

Para listas, `-a urls.txt` lee una URL por línea y es la forma estándar de descargar varios vídeos en una sola ejecución. La bandera `--playlist-items 1-10,15,20-` divide una lista de reproducción. Y `--download-archive seen.txt` mantiene un registro de las descargas completadas, por lo que las ejecuciones repetidas omiten lo que ya tienes. El archivo de descarga es la forma más limpia de descargar listas de reproducción y canales completos de forma incremental sin volver a descargarlos. El nombre de salida sigue una plantilla. La cadena `-o "%(channel)s/%(upload_date>%Y-%m-%d)s — %(title)s.%(ext)s"` produce nombres de archivo agrupados por canal y fechados en la carpeta elegida. El resultado es compatible con las bibliotecas de Plex y Jellyfin. La bandera `-P` cambia el directorio de destino. La bandera `--restrict-filenames` mantiene los nombres en ASCII para mayor seguridad entre sistemas de archivos. Y `--print filename` muestra una vista previa de lo que escribiría yt-dlp antes de que comience el proceso de descarga.

Si una descarga se reproduce en lugar de descargarse, significa que tu navegador abre el enlace antes de que yt-dlp lo detecte. Pasa la URL como argumento literal o entrecomíllala y ejecuta yt-dlp desde la terminal.

Funciones avanzadas para usuarios avanzados: postprocesadores, SponsorBlock, cookies

Más allá de lo básico, yt-dlp cuenta con una enorme cantidad de funcionalidades. Las opciones que se detallan a continuación son las más importantes en la práctica.

La integración con SponsorBlock es útil. La opción accede a la base de datos de la comunidad de SponsorBlock. Marca los marcadores de capítulo o elimina directamente las secciones de patrocinadores en los vídeos de YouTube. La opción `--cookies-from-browser` lee las cookies de los perfiles del navegador, incluidos los contenedores de Firefox, que es la forma más limpia de descargar cualquier contenido detrás de un muro de pago o que requiera inicio de sesión. Para terabytes de archivos de larga duración, la transferencia del descargador externo a aria2c aumenta notablemente la velocidad de descarga en redes donde la ventana TCP es el cuello de botella. Y `--split-chapters` dividirá el contenido de vídeo por capítulo en archivos separados, lo que resulta útil cuando una sola carga agrupa varias charlas. yt-dlp también admite `--video-multistreams` para combinar pistas de vídeo cuando el sitio proporciona varias, aunque esto es raro en la práctica.

El sistema de complementos merece una mención aparte. yt-dlp detectará automáticamente los módulos de Python ubicados en `~/.yt-dlp/plugins/` (o instalados mediante `pip` con el punto de entrada `yt-dlp-plugins`) y los cargará como extractores o postprocesadores. Así es como se da soporte a sitios web poco convencionales sin necesidad de esperar una actualización del proyecto original. También es así como se integran los complementos del proveedor PoToken que se describen a continuación.

Situación de PoToken y SABR para 2025-2026

YouTube dedicó 2025 a complicarle la vida a yt-dlp. Dos cambios son la razón por la que una instalación que funcionaba perfectamente puede empezar a fallar repentinamente en 2026.

PoToken es la opción más importante. Ahora, cada solicitud de video requiere un token de prueba de origen (Proof-of-Origin Token). Este token está vinculado al video, caduca rápidamente y también está vinculado a la sesión. La extracción manual dejó de funcionar hace meses. Lo que sí funciona es un pequeño programa auxiliar llamado `bgutil-ytdlp-pot-provider` que se ejecuta en segundo plano; genera tokens bajo demanda y la llamada principal a yt-dlp los recoge automáticamente. La wiki de yt-dlp tiene una guía llamada PO Token Guide que explica el proceso de configuración. Sin este programa auxiliar, las solicitudes se devuelven degradadas o simplemente bloqueadas, y yt-dlp puede no funcionar correctamente incluso con videos que se reprodujeron en su navegador treinta segundos antes.

SABR es la segunda pieza. SABR es la tasa de bits adaptativa del servidor de YouTube, y hasta 2025 el extractor `web` comenzó a devolver formatos solo SABR que interrumpen la ruta de descarga normal. La solución suele ser una sugerencia de argumentos del extractor más cookies de un navegador con sesión iniciada. Los hilos que vale la pena seguir mientras se perfecciona la solución son los problemas #12482, #14307, #14390, #16082 y #13968. Resultado final: yt-dlp todavía funciona en la gran mayoría del contenido público de YouTube, pero en 2026 un comando que "simplemente funciona" a menudo será un comando que "proveedor de PoToken, cookies nuevas y un poco de paciencia".

Estatus legal de yt-dlp en 2026: EE. UU., Alemania, UE

La respuesta legal es una cuestión de jurisdicción, y lo importante es que aún no se ha resuelto nada de forma definitiva.

En Estados Unidos , ningún tribunal se ha pronunciado específicamente sobre yt-dlp. El caso de la RIAA de 2020 es el precedente más cercano y terminó con una revocación extrajudicial. La novena norma final trienal de la Sección 1201 de la Oficina de Derechos de Autor de EE. UU. entró en vigor el 28 de octubre de 2024 y se extiende hasta el 28 de octubre de 2027. Renovó las exenciones anteriores y añadió una para la investigación sobre la fiabilidad de la IA, pero no creó una exención general para el archivo personal de vídeo. El problema estructural de la Sección 1201, que criminaliza las herramientas que afectan a la gestión de derechos digitales (DRM) independientemente de la intención, persiste.

En Alemania , la controversia se ha centrado en la responsabilidad de los proveedores de alojamiento web, más que en el software en sí. El Tribunal Regional Superior de Hamburgo rechazó el recurso de apelación de Uberspace, el proveedor de alojamiento de `youtube-dl.org` en Maguncia, el 27 de noviembre de 2024. Esta decisión ratificó una sentencia de un tribunal inferior de 2023 que establecía que los proveedores de alojamiento web pueden ser responsables de los sitios que anuncian herramientas para eludir las restricciones. Si bien esta doctrina no prohíbe directamente yt-dlp, sí convierte el alojamiento web alemán en una opción arriesgada para cualquier proyecto que anuncie abiertamente la posibilidad de sortear dichas restricciones.

A nivel de la UE , la Ley de Servicios Digitales estandariza los procedimientos de notificación y retirada de contenido (artículos 16 y 17), pero no regula el software de descarga. No existe ninguna normativa a nivel de la UE que obligue a los proveedores de alojamiento a bloquear yt-dlp. El uso personal de yt-dlp en contenido propio no constituye el principal obstáculo legal en ninguna de estas jurisdicciones. Lo mismo se aplica al contenido para el que el creador ha dado su consentimiento. La dificultad reside en la distribución y en la interacción con la protección de la transmisión.

Interfaces gráficas de usuario y el ecosistema de descargas en general.

No todo el mundo quiere una terminal, y la línea de comandos de yt-dlp no es su punto fuerte. yt-dlp es uno de los muchos descargadores de vídeo, pero funciona como motor subyacente en la mayoría de las interfaces gráficas de usuario (GUI) modernas. Stacher es la GUI multiplataforma más pulida. Tartube es una alternativa en Python/GTK. yt-dlg es una bifurcación de la comunidad específica para yt-dlp. Tube-Archivist es un servidor Docker autoalojado para archivar canales; puede descargar vídeos de varios sitios web según un cronograma. YTDL-Material es una interfaz web autoalojada. ytdl-sub es una herramienta de configuración YAML declarativa popular entre los usuarios de Plex y Jellyfin. JDownloader 2 integra yt-dlp mediante un plugin. Cada herramienta expone su propia interfaz de selección de vídeo y panel de opciones de descarga, pero el trabajo pesado lo realiza yt-dlp.

La regla general es la siguiente: yt-dlp para descargas de archivos, streamlink para transmisión en vivo a un reproductor, gallery-dl para sitios con muchas imágenes.

Seguridad: dónde descargar yt-dlp y cómo detectar falsificaciones

Las únicas fuentes seguras son GitHub Releases, PyPI (`pip install yt-dlp`), los paquetes de distribución oficiales y los principales gestores de paquetes de Windows (Winget, Scoop, Chocolatey). Los sitios de descarga de terceros para "yt-dlp" incluyen adware, mineros o binarios modificados. Windows Defender ha marcado históricamente el archivo `yt-dlp.exe` empaquetado con PyInstaller como `Trojan:Win32/Wacatac.B!ml` (problemas n.° 7532 y n.° 15415). Se trata de falsos positivos heurísticos. Las bases de datos de firmas suelen borrarse en cuestión de días. Los pequeños proyectos de código abierto como yt-dlp sobreviven gracias a mantenedores voluntarios. Las donaciones en criptomonedas a través de plataformas como Plisio son una forma segura de que los colaboradores internacionales reciban apoyo, incluso ante la retirada de fondos.

Un ejemplo práctico. Supongamos que quieres descargar un vídeo de YouTube a tu ordenador para una presentación. El comando es `yt-dlp -f "bv*+ba/b" --merge-output-format mp4 URL`, que te proporciona el formato de descarga correcto. yt-dlp es una bifurcación con más extractores que youtube-dl, y cuenta con muchos que te permiten descargar un vídeo donde el original no lo permite. yt-dlp, mediante su sistema de complementos, cubre fuentes específicas, y permite usar `-a urls.txt` cuando necesitas descargar vídeos de varios sitios web. Todo lo que admite yt-dlp se encuentra en `supportedsites.md`.

Elisabeth McGowan

A freelance writer passionate about celebrities, net worth stories, athletes, and political figures. She transforms facts into engaging narratives. A true cheese lover and cycling enthusiast, she finds inspiration in motion and flavor.