YouTube Downloader

Proyecto en Python para descargar videos de YouTube en calidad maxima de 720p, guardarlos con el titulo del video, bajar su miniatura principal en la mayor calidad disponible y generar un .txt con sus metadatos.

Requisitos

• Python 3.10 o superior
• ffmpeg opcional, pero recomendado para combinar mejor video y audio
• Se recomienda instalar yt-dlp con extras por defecto para incluir componentes EJS necesarios en YouTube

Instalacion

cd /Users/gadem/Developer/python/youtube_downloader
python3 -m venv .venv
source .venv/bin/activate
pip install -r requirements.txt

Uso con videos.csv

python3 download_youtube.py

El script lee por defecto el archivo videos.csv. Usa una URL por fila:

url
https://www.youtube.com/watch?v=VIDEO_ID
https://www.youtube.com/watch?v=OTRO_VIDEO_ID

Uso con una URL directa

python3 download_youtube.py "https://www.youtube.com/watch?v=VIDEO_ID"

Para elegir otra carpeta de salida o un CSV distinto:

python3 download_youtube.py --csv-file videos.csv --output-dir mis_videos

Para descargar solo los primeros 60 segundos de un video:

python3 download_youtube.py --duration 60 "https://www.youtube.com/watch?v=VIDEO_ID"

Si YouTube pide verificacion de bot, puedes usar cookies del navegador:

python3 download_youtube.py --cookies-from-browser chrome

Tambien puedes usar un archivo cookies.txt exportado manualmente:

python3 download_youtube.py --cookies ~/Downloads/cookies.txt

Si tienes node o deno instalado, puedes indicarlo como runtime JavaScript:

python3 download_youtube.py --cookies-from-browser chrome --js-runtime node

Notas

• El nombre del archivo se genera con el titulo y el ID del video para evitar colisiones.
• La miniatura principal tambien se descarga y se guarda junto al video en la mejor calidad que YouTube exponga.
• Por cada video descargado se crea un archivo .txt con titulo, canal, URL, ID, duracion, fecha, vistas y descripcion.
• Si ffmpeg esta instalado, yt-dlp puede descargar mejor combinacion de video y audio manteniendo el objetivo de 720p.
• Si no existe una version exacta a 720p, se descargara la mejor disponible que no supere esa altura.
• Algunos videos de YouTube pueden requerir cookies de sesion para pasar la verificacion antibot.
• Instalar node o deno ayuda a yt-dlp a extraer mejor la informacion de YouTube.
• Si aparece n challenge solving failed u Only images are available for download, actualiza dependencias con pip install -U -r requirements.txt.
• --duration solo acepta enteros mayores que 0.