admin/guias_informatica

Fork 0

Files

T

admin c18f8253e4 añadida guia yt-dlp y spotDL

2026-09-26 17:43:23 +02:00

14 KiB

Raw Blame History

yt-dlp y spotDL

Guía de instalación y uso para Windows, macOS y Linux

Guía práctica para instalar y utilizar yt-dlp, spotDL, FFmpeg y Deno.

Nota: usa estas herramientas únicamente con contenido cuya descarga y uso estén permitidos.

1. Introducción

yt-dlp

yt-dlp es una herramienta de línea de comandos para descargar contenido multimedia de numerosos sitios web.

Es especialmente útil para:

Vídeos.
Audio.
Playlists.
Canales.
Subtítulos.
Metadatos.
Selección de formatos y calidades.
Descargas automatizadas.

Proyecto oficial: https://github.com/yt-dlp/yt-dlp

spotDL

spotDL trabaja con enlaces de Spotify para identificar canciones y obtener una fuente correspondiente para descargar el audio. No descarga directamente los archivos de audio offline de Spotify.

En términos generales:

Spotify
   │
   │ información de canción
   ▼
 spotDL
   │
   │ búsqueda
   ▼
YouTube / yt-dlp
   │
   │ audio
   ▼
archivo local

Proyecto oficial: https://github.com/spotDL/spotify-downloader

2. Requisitos generales

Para una instalación completa se recomienda:

Python 3.10–3.14 para spotDL.
FFmpeg.
yt-dlp.
spotDL.
Deno.

No todos son imprescindibles para cada operación.

Arquitectura típica:

Python
   │
   ├── spotDL
   │
   └── yt-dlp
          │
          └── FFmpeg

3. yt-dlp

Documentación de instalación:
https://github.com/yt-dlp/yt-dlp/wiki/Installation

3.1 Windows

WinGet

En PowerShell:

winget install yt-dlp

Actualizar:

winget upgrade yt-dlp

Comprobar:

yt-dlp --version

Instalación manual

También puedes descargar el ejecutable oficial yt-dlp.exe desde:

https://github.com/yt-dlp/yt-dlp/releases/latest

Colócalo en una carpeta incluida en PATH para poder ejecutarlo desde cualquier terminal.

3.2 macOS

Con Homebrew:

brew install yt-dlp

Comprobar:

yt-dlp --version

Actualizar:

brew upgrade yt-dlp

3.3 Linux

Ubuntu / Debian

sudo apt update
sudo apt install yt-dlp

También puedes utilizar el binario oficial o Python:

python3 -m pip install -U "yt-dlp[default]"

Comprobar:

yt-dlp --version

Arch Linux

sudo pacman -Syu yt-dlp

Binario oficial

Para instalar el binario en ~/.local/bin:

mkdir -p ~/.local/bin

curl -L \
  https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp \
  -o ~/.local/bin/yt-dlp

chmod a+rx ~/.local/bin/yt-dlp

Asegúrate de que ~/.local/bin está incluido en PATH.

3.4 Uso básico

yt-dlp "URL"

Ejemplo:

yt-dlp "https://www.youtube.com/watch?v=XXXXXXXXXXX"

El archivo se guardará en la carpeta actual.

Linux/macOS:

pwd

Windows PowerShell:

Get-Location

3.5 Descargar vídeo

Mejor vídeo + audio disponibles:

yt-dlp -f "bv*+ba/b" "URL"

Solicitar MP4 como contenedor final:

yt-dlp \
  -f "bv*+ba/b" \
  --merge-output-format mp4 \
  "URL"

La combinación de pistas separadas requiere FFmpeg.

3.6 Descargar audio

Extraer audio:

yt-dlp -x "URL"

Convertir a MP3:

yt-dlp -x --audio-format mp3 "URL"

Calidad alta:

yt-dlp \
  -x \
  --audio-format mp3 \
  --audio-quality 0 \
  "URL"

3.7 Elegir calidad

Consultar formatos:

yt-dlp -F "URL"

Ejemplo:

ID     EXT   RESOLUTION
137    mp4   1080p
136    mp4   720p
135    mp4   480p
140    m4a   audio

Seleccionar formatos concretos:

yt-dlp -f 137+140 "URL"

Selección automática recomendada:

yt-dlp -f "bv*+ba/b" "URL"

3.8 Playlists

Descargar una playlist:

yt-dlp "URL_DE_LA_PLAYLIST"

Organizarla automáticamente:

yt-dlp \
  -o "%(playlist_title)s/%(playlist_index)02d - %(title)s.%(ext)s" \
  "URL_DE_LA_PLAYLIST"

Resultado:

Mi Playlist/
├── 01 - Canción 1.mp4
├── 02 - Canción 2.mp4
├── 03 - Canción 3.mp4
└── ...

3.9 Subtítulos

Ver subtítulos disponibles:

yt-dlp --list-subs "URL"

Descargar subtítulos:

yt-dlp --write-subs "URL"

Español:

yt-dlp \
  --write-subs \
  --sub-langs "es" \
  "URL"

Subtítulos automáticos:

yt-dlp \
  --write-auto-subs \
  --sub-langs "es" \
  "URL"

3.10 Actualizar yt-dlp

Windows — WinGet

winget upgrade yt-dlp

macOS — Homebrew

brew upgrade yt-dlp

Linux — pip

python3 -m pip install -U "yt-dlp[default]"

Binario oficial

yt-dlp -U

4. spotDL

Documentación:
https://spotdl.github.io/spotify-downloader/

Repositorio:
https://github.com/spotDL/spotify-downloader

spotDL requiere Python 3.10–3.14 y FFmpeg. En Windows puede ser necesario el Visual C++ Redistributable.

4.1 Windows

Instalar Python

Descarga Python desde:

https://www.python.org/downloads/windows/

Durante la instalación activa:

☑ Add Python to PATH

Comprobar:

python --version

Instalar FFmpeg

Con WinGet:

winget install -e --id Gyan.FFmpeg

Comprobar:

ffmpeg -version

Instalar spotDL

python -m pip install spotdl

Comprobar:

spotdl --version

Si el comando no funciona:

python -m spotdl --version

Instalar Deno

spotdl --download-deno

4.2 macOS

Comprobar Python:

python3 --version

Si hace falta:

brew install python

Instalar FFmpeg:

brew install ffmpeg

Instalar spotDL:

python3 -m pip install spotdl

Comprobar:

spotdl --version

Instalar Deno:

spotdl --download-deno

4.3 Linux

Ubuntu / Debian

sudo apt update
sudo apt install python3 python3-pip ffmpeg

Comprobar:

python3 --version
ffmpeg -version

Instalar spotDL:

python3 -m pip install spotdl

Alternativa con pipx

Si la distribución impide instalar paquetes Python directamente en el sistema:

sudo apt install pipx
pipx ensurepath

Reinicia la terminal y ejecuta:

pipx install spotdl

Comprobar:

spotdl --version

Instalar Deno:

spotdl --download-deno

4.4 Uso básico

spotdl "URL_DE_SPOTIFY"

También:

spotdl download "URL_DE_SPOTIFY"

La operación download es la predeterminada.

4.5 Canciones, álbumes y playlists

Canción

spotdl "https://open.spotify.com/track/XXXXXXXX"

Álbum

spotdl "https://open.spotify.com/album/XXXXXXXX"

Playlist

spotdl "https://open.spotify.com/playlist/XXXXXXXX"

4.6 Organización y metadatos

Por defecto, spotDL utiliza la carpeta desde la que se ejecuta.

Linux/macOS:

cd ~/Music
spotdl "URL"

Windows:

cd "C:\Users\TuUsuario\Music"
spotdl "URL"

Una biblioteca puede organizarse como:

Music/
├── Artista/
│   ├── Album/
│   │   ├── 01 - Cancion.mp3
│   │   ├── 02 - Cancion.mp3
│   │   └── 03 - Cancion.mp3

spotDL puede incorporar información como:

Artista.
Título.
Álbum.
Número de pista.
Año.
Carátula.
Otros metadatos disponibles.

Consultar opciones:

spotdl --help

4.7 Actualizar spotDL

Windows:

python -m pip install --upgrade spotdl

macOS/Linux:

python3 -m pip install --upgrade spotdl

Con pipx:

pipx upgrade spotdl

5. FFmpeg

FFmpeg permite, entre otras cosas:

Combinar vídeo y audio.
Extraer audio.
Convertir formatos.
Convertir a MP3.
Procesar archivos multimedia.

Windows

winget install -e --id Gyan.FFmpeg

macOS

brew install ffmpeg

Ubuntu/Debian

sudo apt update
sudo apt install ffmpeg

Arch Linux

sudo pacman -S ffmpeg

Comprobar:

ffmpeg -version

6. Deno

Deno es recomendable para spotDL porque se utiliza junto con yt-dlp en determinados flujos de descarga.

La instalación sencilla mediante spotDL es:

spotdl --download-deno

Comprobar:

deno --version

7. Configuración recomendada

yt-dlp

Crear una carpeta para vídeos:

~/Videos/YouTube/

~/Downloads/YouTube/

Organizar por canal:

yt-dlp \
  -o "%(channel)s/%(title)s.%(ext)s" \
  "URL"

Organizar playlists:

yt-dlp \
  -o "%(playlist_title)s/%(playlist_index)02d - %(title)s.%(ext)s" \
  "URL"

Audio MP3 con metadatos

yt-dlp \
  -x \
  --audio-format mp3 \
  --audio-quality 0 \
  --embed-thumbnail \
  --embed-metadata \
  "URL"

El resultado de los metadatos depende de la información disponible en la fuente.

8. Solución de problemas

`command not found: yt-dlp`

Linux/macOS:

which yt-dlp

command -v yt-dlp

Si utilizaste pip:

python3 -m pip show yt-dlp

Windows:

where.exe yt-dlp

`command not found: spotdl`

Linux/macOS:

python3 -m spotdl --version

Windows:

python -m spotdl --version

Si funciona mediante Python pero no como comando, comprueba el PATH.

`ffmpeg not found`

Comprueba:

ffmpeg -version

Si no está disponible, instala FFmpeg según tu sistema operativo.

Una descarga de YouTube deja de funcionar

Actualiza yt-dlp.

Windows:

winget upgrade yt-dlp

macOS:

brew upgrade yt-dlp

Linux/Python:

python3 -m pip install -U "yt-dlp[default]"

Comprueba:

yt-dlp --version

spotDL no encuentra una canción

Comprueba que yt-dlp funciona correctamente y actualiza spotDL:

yt-dlp --version

python3 -m pip install -U spotdl

Después:

spotdl --download-deno

9. Resumen de comandos

yt-dlp

Vídeo

yt-dlp "URL"

Mejor vídeo + audio

yt-dlp -f "bv*+ba/b" "URL"

MP4

yt-dlp -f "bv*+ba/b" --merge-output-format mp4 "URL"

MP3

yt-dlp -x --audio-format mp3 "URL"

Ver formatos

yt-dlp -F "URL"

Playlist

yt-dlp "URL_PLAYLIST"

Subtítulos

yt-dlp --write-subs --sub-langs "es" "URL"

Actualizar

yt-dlp -U

spotDL

Canción

spotdl "URL_SPOTIFY"

Álbum

spotdl "URL_ALBUM"

Playlist

spotdl "URL_PLAYLIST"

Ayuda

spotdl --help

Actualizar

python3 -m pip install --upgrade spotdl

Instalar Deno

spotdl --download-deno

10. Consideraciones legales

Estas herramientas son software de descarga y procesamiento multimedia. Su utilización debe respetar:

Los derechos de autor.
Los términos de servicio de las plataformas.
Las leyes aplicables en tu país.
Los derechos del propietario del contenido.

Una descarga puede ser técnicamente posible y, aun así, no estar autorizada para determinados contenidos.

Utilízalas con contenido propio, contenido con licencia adecuada, dominio público o contenido cuya descarga esté permitida.

Referencias oficiales

yt-dlp: https://github.com/yt-dlp/yt-dlp
Instalación de yt-dlp: https://github.com/yt-dlp/yt-dlp/wiki/Installation
spotDL: https://github.com/spotDL/spotify-downloader
Documentación de spotDL: https://spotdl.github.io/spotify-downloader/
FFmpeg: https://ffmpeg.org/
Python: https://www.python.org/
Deno: https://deno.com/

Atajo: instalación completa

Windows

winget install yt-dlp
winget install -e --id Gyan.FFmpeg

Instala Python desde:

https://www.python.org/downloads/windows/

Después:

python -m pip install spotdl
spotdl --download-deno

macOS

brew install yt-dlp
brew install ffmpeg
brew install python

python3 -m pip install spotdl
spotdl --download-deno

Ubuntu/Debian

sudo apt update
sudo apt install yt-dlp ffmpeg python3 python3-pip

python3 -m pip install spotdl
spotdl --download-deno

Comprobación final

yt-dlp --version
ffmpeg -version
spotdl --version
deno --version

Si los cuatro comandos devuelven una versión, tienes instalada la cadena completa:

              ┌─────────────┐
              │   Spotify   │
              └──────┬──────┘
                     │
                     ▼
                 ┌───────┐
                 │ spotDL│
                 └───┬───┘
                     │
                     ▼
                ┌──────────┐
                │  yt-dlp  │
                └────┬─────┘
                     │
                     ▼
                ┌──────────┐
                │  FFmpeg  │
                └────┬─────┘
                     │
                     ▼
               Archivo local

Nota: spotDL utiliza fuentes externas para obtener el audio; no convierte las descargas offline de Spotify en archivos MP3.

14 KiB Raw Blame History Unescape Escape

yt-dlp y spotDL

Guía de instalación y uso para Windows, macOS y Linux

Índice

1. Introducción

yt-dlp

spotDL

2. Requisitos generales

3. yt-dlp

3.1 Windows

WinGet

Instalación manual

3.2 macOS

3.3 Linux

Ubuntu / Debian

Arch Linux

Binario oficial

3.4 Uso básico

3.5 Descargar vídeo

3.6 Descargar audio

3.7 Elegir calidad

3.8 Playlists

3.9 Subtítulos

3.10 Actualizar yt-dlp

Windows — WinGet

macOS — Homebrew

Linux — pip

Binario oficial

4. spotDL

4.1 Windows

Instalar Python

Instalar FFmpeg

Instalar spotDL

Instalar Deno

4.2 macOS

4.3 Linux

Ubuntu / Debian

Alternativa con pipx

4.4 Uso básico

4.5 Canciones, álbumes y playlists

Canción

Álbum

Playlist

4.6 Organización y metadatos

4.7 Actualizar spotDL

5. FFmpeg

Windows

macOS

Ubuntu/Debian

Arch Linux

6. Deno

7. Configuración recomendada

yt-dlp

Audio MP3 con metadatos

8. Solución de problemas

command not found: yt-dlp

command not found: spotdl

ffmpeg not found

Una descarga de YouTube deja de funcionar

spotDL no encuentra una canción

9. Resumen de comandos

yt-dlp

Vídeo

Mejor vídeo + audio

MP4

MP3

Ver formatos

Playlist

Subtítulos

Actualizar

spotDL

Canción

Álbum

Playlist

Ayuda

Actualizar

Instalar Deno

10. Consideraciones legales

Referencias oficiales

Atajo: instalación completa

14 KiB

Raw Blame History

`command not found: yt-dlp`

`command not found: spotdl`

`ffmpeg not found`