YouTube Downloader Pro 🎥🎵

Um downloader profissional de vídeos e áudios do YouTube, construído em Python. Simples, rápido e com recursos avançados de compatibilidade.

✨ Recursos

• Vídeo & Áudio: Baixe vídeos em alta qualidade ou converta para MP3/M4A.
• Detector de Playlist/Mix: Suporte inteligente para links "Mix" (vídeo + playlist).
• Audio Art (Capa): Sistema robusto que incorpora a capa do vídeo no arquivo MP3/M4A (compatibilidade total com Windows Explorer).
• Zero Config: FFmpeg embutido via static-ffmpeg.
• Alta Performance: Download acelerado com fragmentos concorrentes.
• Resume Automático: Retoma downloads interrompidos.
• Logs: Sistema de logs detalhado.

🚀 Instalação

Este projeto utiliza uv para gerenciamento moderno de dependências.

1. Pré-requisitos: Ter Python instalado.

2. Instalar uv :

   Via winget :

   winget install --id=astral-sh.uv  -e

   Via pip:

   pip install uv

   Outras opções no site oficial: https://docs.astral.sh/uv/

3. Download do projeto: (Clone ou baixe os arquivos para uma pasta)

4. Configurar Ambiente: Na pasta do projeto, rode:

   uv sync

🎮 Como Usar

Basta rodar o comando:

uv run main.py

O Script irá pedir:

1. URL: Cole o link do YouTube.
2. Tipo: Escolha entre Vídeo ou Áudio.
3. Qualidade:
   • Vídeo: 1080p, 720p, etc.
   • Áudio: MP3, M4A, etc (Automaticamente converte e adiciona capa/metadados).

Os arquivos baixados aparecerão na pasta downloads dentro do diretório do projeto.

🛠️ Detalhes Técnicos

• Core: yt-dlp
• Interface: inquirer + colorama
• Metadados: mutagen (para tagging ID3v2.3 manual)
• FFmpeg: static-ffmpeg

📝 Troubleshooting

Se algo der errado, verifique o arquivo logs/app.log.