EchoDownloader

• 01 Descripción
• 02 Instalación
• 03 Uso
• 04 Autor
• 05 Licencia

01 Descripción

EchoDownloader es una herramienta de línea de comandos escrita en Python que permite descargar el audio o el vídeo de uno o varios vídeos de YouTube utilizando la librería yt-dlp. Es ideal para crear una biblioteca local de música, podcasts o vídeos.

Versión: v2.0.1 Última revisión: 4 de agosto de 2026

Novedades

• Nueva gestión de argumentos mediante subcomandos.
• Soporte para descarga de audio y vídeo.
• Refactorización completa de la arquitectura del proyecto.
• Conversión de los modelos principales a dataclass.
• Compatibilidad con pyproject.toml y empaquetado moderno de Python.
• Incorporación de pruebas unitarias.

Características

• Descarga audio en formato MP3 (192 kbps).
• Descarga vídeo en formato MP4 con la mejor calidad disponible.
• Descarga desde una única URL o desde un archivo de texto con múltiples URLs.
• Evita sobrescribir archivos existentes generando automáticamente un nombre único.
• Interfaz de consola limpia con mensajes informativos y de error personalizados.
• Gestión clara y controlada de errores.
• Compatible con Linux, macOS y Windows.

Requisitos

• Python 3.11 o superior.
• FFmpeg instalado y accesible desde la línea de comandos.
• Se recomienda utilizar un entorno virtual (venv).

Dependencias externas

• certifi: Proporciona un almacén actualizado de certificados raíz para conexiones HTTPS.
• colored: Añade colores y formato al texto mostrado en la consola.
• typing_extensions: Proporciona características modernas de tipado compatibles con distintas versiones de Python.
• yt-dlp: Biblioteca utilizada para descargar contenido multimedia de YouTube y de otros muchos servicios compatibles.

---

02 Instalación

Clonar el repositorio

git clone https://github.com/marcoscr4981/echodownloader.git
cd echodownloader

Crear un entorno virtual (recomendado)

python3 -m venv .venv

Activarlo:

# Windows
.venv\Scripts\activate

# Linux / macOS
source .venv/bin/activate

Instalar el proyecto

Instala el proyecto en modo editable para desarrollo:

pip install -e .

Si únicamente deseas instalar las dependencias:

pip install -r requirements.txt

Para desactivar el entorno virtual:

deactivate

---

03 Uso

Descargar el audio de un vídeo

echodownloader audio url "https://www.youtube.com/watch?v=XXXXX"

Descargar un vídeo

echodownloader video url "https://www.youtube.com/watch?v=XXXXX"

Se recomienda escribir la URL entre comillas dobles.

Descargar desde un archivo de texto

Audio:

echodownloader audio file urls.txt

Vídeo:

echodownloader video file urls.txt

El archivo de texto debe contener una URL por línea.

Puedes añadir un retraso entre descargas mediante el parámetro -d:

echodownloader audio file urls.txt -d 3

En este ejemplo se esperarán 3 segundos entre cada descarga.

Mostrar la ayuda

echodownloader --help

o

echodownloader -h

Mostrar la versión

echodownloader --version

o

echodownloader -v

---

04 Autor

• Marcos Cuadrado Rey
• Email: marcoscr4981@gmail.com
• GitHub: https://github.com/marcoscr4981

---

05 Licencia

Este proyecto se distribuye bajo la licencia MIT. Consulta el archivo LICENSE para obtener más información.

---

Última actualización: 4 de agosto de 2026