yt-dlp (Español)

Esta traducción de Yt-dlp fue revisada el 2026-01-25. Si existen cambios puede actualizarla o avisar al equipo de traducción.

Artículos relacionados

• mpv (Español)
• FFmpeg

yt-dlp es un programa de línea de comandos que le permite descargar fácilmente videos y audio de más de mil sitios web. Consulte la lista de sitios compatibles.

Nota yt-dlp es un fork de youtube-dl que fue creado después de que el proyecto padre se estancó. El youtube-dl principal puede seguir siendo instalado como youtube-dl^AUR; los comandos en esta página deberían seguir funcionando, pero revisa la lista de diferencias

Instalación

Instale el paquete yt-dlp. Vea las dependencias opcionales, las más notables para instalar son:

• yt-dlp-ejs para mejor soporte, como extracción de YouTube sin él ha quedado obsoleto y es posible que falten algunos formatos [1].
• FFmpeg es usado por muxing para algunos sitios.

Hay también varios frontends gráficos para yt-dlp, como tartube^AUR y yt-dlg-git^AUR.

Puedes instalar también yt-dlp-drop-in^AUR que provee un ejecutable ficticio /usr/bin/youtube-dl (que solo redirige a yt-dlp) para programas desactualizados que continuan buscando un ejecutable youtube-dl.

Configuración

El archivo de configuración de todo el sistema es /etc/yt-dlp.conf y archivo de configuración especifico para el usuario es ~/.config/yt-dlp/config. La sintaxis es simplemente una opción de línea de comandos por línea. Ejemplo de configuración:

--ignore-errors
# --no-playlist

# Guardar en ~/Videos
-o ~/Videos/%(title)s.%(ext)s

# Preferir 1080p en bajas resoluciones
-f bestvideo[height<=?1080]+bestaudio/best

Vea [2] para más información.

Un archivo de configruación personalizado puede también ser especificado con:

$ yt-dlp URL --config-locations PATH

Utilización

Ver yt-dlp(1) para el manual.

$ yt-dlp [OPCIONES] URL

Sugerencia En algunos casos (como YouTube) la URL puede sustituirse por el ID del video.

Selección de formato

En los casos en que haya múltiples formatos de video disponibles, yt-dlp usará por defecto la descarga de la mejor versión posible.

Para obtener una lista de los formatos disponibles:

$ yt-dlp -F URL

Para seleccionar uno en especifico para descargar:

$ yt-dlp -f formato URL

Extraer audio

Utilice -x para descargar solo el audio (requiere FFmpeg).

$ yt-dlp -x -f bestaudio URL

Dependiendo de las fuentes de transmisiones disponibles, esto a menudo lo corregirá el contenedor de solo audio. Si una transmisión de solo audio no está disponible, excluya -f bestaudio del ejemblo de arriba. Esto descargará el vídeo y copiará su audio como proceso posterior. Por defecto esto removerá el vídeo descargado, incluya -k para saltar esto.

Para incluir el albúm artistico también (requiere atomicparsley):

$ yt-dlp -x -f bestaudio[ext=m4a] --add-metadata --embed-thumbnail URL

Subtítulos

Para ver cuales lenguajes están disponibles:

$ yt-dlp --list-subs URL

Para descargar un vídeo con los subtítulos seleccionados (separados con coma):

$ yt-dlp --write-sub --sub-lang LANG URL

Para auto generar subtítulos:

$ yt-dlp --write-auto-sub --sub-lang LANG URL

Añada --skip-download para obtener solo subtítulos.

Cookies

Para importar cookies añada --cookies-from-browser <navegador>

Ejemplo de importación de cookies desde chromium

$ yt-dlp --cookies-from-browser chromium URL

Consejos y trucos

Aumento de las velocidades de descarga

Algunos sitios web aceleran las velocidades de descarga. A menudo puede aumentar la velocidad usando aria2, un descargador externo que admite descargas de conexión múltiple. Ejemplo:

$ yt-dlp --downloader aria2c --downloader-args '-c -j 3 -x 3 -s 3 -k 1M' URL

Playlist

Usando yt-dlp para una playlist usualmente se reduce a las siguientes opciones:

$ yt-dlp --ignore-errors --continue --no-overwrites --download-archive progress.txt opciones usuales URL

Este conjunto de opciones permite que la descarga continúe de manera efectiva incluso después de una interrupción. Si estas archivando, añade las opciones usuales --write-xxx y --embed-xxx a las opciones que tengas.

Recortar (descarga parcial)

Partes de vídeos se pueden descargar usando la salida de yt-dlp -g -f formato URL como entrada ffmpeg con las opciones -ss (para entraad), -t y -c copy opciones.

URL del portapapeles

Se puede configurar un alias de shell, un lanzador de escritorio o un método abreviado de teclado para descargar un video (o audio) de una URL seleccionada (o copiada) emitiéndolo desde la X selection. Véase herramientas de portapapeles.

Véase también

• repositorio GitHub para documentación.