Cómo instalar y usar youtube-dl / yt-dlp para descargar vídeos (línea de comandos)

Advertencia legal: Descargar vídeos de YouTube viola sus Términos de Servicio (Sección 5.B) salvo: tu propio contenido, licencia permisiva (CC0, CC BY), permiso escrito, o excepción legal "copia privada" / "fair use" según tu país. Úsalo responsablemente.

yt-dlp (fork activo, recomendado) vs youtube-dl (abandonado 2021)

• yt-dlp: actualizado semanalmente, soporta YouTube, Twitter/X, Twitch, Vimeo, 1000+ sitios, sponsors, subtítulos, capítulos, thumbnails, metadata, post-procesado FFmpeg.
• youtube-dl: sin updates desde 2021, roto para YouTube y muchos sitios. No lo uses.

Instalación

Windows

# Gestores paquetes (recomendado):
scoop install yt-dlp
# o
choco install yt-dlp

# Manual: descarga yt-dlp.exe de https://github.com/yt-dlp/yt-dlp/releases/latest
# Pon en carpeta en PATH (ej. C:\Tools) y renombra a yt-dlp.exe

macOS

brew install yt-dlp
# Incluye ffmpeg automáticamente.

Linux

# Debian/Ubuntu/Mint (suele estar desactualizado en repos):
sudo apt install yt-dlp   # Verifica versión: yt-dlp --version

# Mejor: pipx (aislado, actualizable):
pipx install yt-dlp
# O pip (usuario):
pip install --user -U yt-dlp

# Arch/Manjaro:
sudo pacman -S yt-dlp

# Flatpak (cualquier distro):
flatpak install flathub org.yt_dlp.yt-dlp

Instalar FFmpeg (requerido para fusionar vídeo+audio, convertir, recortar)

• Windows: scoop install ffmpeg / choco install ffmpeg / descarga gyan.dev (essentials) > pon ffmpeg.exe, ffprobe.exe en misma carpeta que yt-dlp.exe o en PATH.
• Mac: brew install ffmpeg (ya viene con yt-dlp via brew).
• Linux: sudo apt install ffmpeg / sudo dnf install ffmpeg / sudo pacman -S ffmpeg.

Uso básico

# Descargar mejor calidad (vídeo+audio fusionado):
yt-dlp "URL"

# Listar formatos disponibles:
yt-dlp -F "URL"

# Elegir formato específico:
yt-dlp -f "bv*+ba/b" "URL"          # Mejor vídeo + mejor audio (por defecto)
yt-dlp -f "bv*[height<=720]+ba" "URL"  # Máx 720p
yt-dlp -f "worst" "URL"             # Peor calidad (rápido, poco espacio)

# Solo audio (MP3, M4A, OPUS):
yt-dlp -x --audio-format mp3 "URL"
yt-dlp -x --audio-format m4a "URL"   # M4A (AAC) nativo YouTube, mejor calidad/tamaño

# Playlist / Canal:
yt-dlp "https://www.youtube.com/playlist?list=PLxxxx"
yt-dlp "https://www.youtube.com/@canal/videos"

# Subtítulos:
yt-dlp --write-subs --sub-langs es,en "URL"          # Descarga .vtt/.srt
yt-dlp --write-auto-subs --sub-langs es "URL"        # Auto-generados
yt-dlp --embed-subs "URL"                            # Incrusta en MP4/MKV

# Miniatura + Metadatos JSON:
yt-dlp --write-thumbnail --write-info-json "URL"

# Limitar velocidad (evitar throttle ISP):
yt-dlp --limit-rate 2M "URL"

# Continuar descarga interrumpida:
yt-dlp --continue "URL"  # (por defecto ya lo hace con .part)

Interfaces gráficas (GUI) para yt-dlp

• Stacher (Win/Mac/Linux, open source, bonita, cola, colas, formatos, sponsors).
• YT-DLP-GUI (Windows, sencilla).
• Tartube (Linux/Win, estilo YouTube local, suscripciones, categorías).

JDownloader 2 (Alternativa multi-sitio, GUI)

Copia URL > JDownloader detecta > Elige calidad/formato > Iniciar. Soporta YouTube, 1000+ sitios, cuentas premium, captchas, descargas paralelas.

Ética y seguridad

• Apoya creadores: suscríbete, dona (Patreon, Ko-fi, Memberships), comparte.
• Evita webs "conversoras online" (malware, trackers, calidad baja, publicidad agresiva).
• No redistribuyas sin permiso.
• Verifica hash (SHA256) de binarios descargados manualmente.