YouTube Music Playlist Downloader

Um aplicativo simples e intuitivo para baixar playlists completas do YouTube Music em formato MP3.

Easy way install ## (Windows)

Execute o bat de instalar as dependências e o FFMPEG antes de rodar a aplicação.

App open source para covertê-lo fácilmente para linux <3

🚀 Características

• Interface gráfica amigável
• Download de playlists completas do YouTube Music
• Conversão automática para MP3 (requer FFmpeg)
• Diferentes opções de qualidade de áudio (96-320 kbps)
• Barra de progresso e log detalhado
• Nomeação automática dos arquivos com numeração da playlist
• Verificação automática de dependências
• Script de instalação automática do FFmpeg

📋 Pré-requisitos

• Python 3.7 ou superior
• FFmpeg (essencial para conversão MP3)

⚡ Instalação Rápida do FFmpeg

Execute o instalador automático:

instalar_ffmpeg.bat

🔧 Instalação Manual do FFmpeg

Windows (mais fácil):

# Via winget (Windows 10/11)
winget install FFmpeg

# Via Chocolatey
choco install ffmpeg

# Via Scoop
scoop install ffmpeg

Windows (manual):

1. Baixe o FFmpeg: https://ffmpeg.org/download.html#build-windows
2. Extraia para C:\ffmpeg
3. Adicione C:\ffmpeg\bin ao PATH do sistema
4. Reinicie o computador

⚠️ Importante sobre conversão MP3

• Com FFmpeg: Arquivos são convertidos para MP3 automaticamente ✅
• Sem FFmpeg: Arquivos ficam em formato WebM (não é MP3) ❌

O programa irá detectar automaticamente se o FFmpeg está instalado e avisar caso contrário.

🔧 Instalação

1. Clone ou baixe este repositório
2. Abra o terminal na pasta do projeto
3. Execute o instalador de dependências:

instalar_dependencias.bat

Ou manualmente:

pip install -r requirements.txt

🎵 Como usar

1. Execute o aplicativo:

executar_app.bat

Ou manualmente:

python youtube_music_downloader.py

2. Se aparecer um aviso sobre FFmpeg, clique em "Como instalar FFmpeg" ou execute instalar_ffmpeg.bat

3. Cole a URL da playlist do YouTube Music no campo correspondente

4. Escolha a pasta onde deseja salvar os arquivos MP3

5. Selecione a qualidade de áudio desejada:

   • 320: 320 kbps (máxima qualidade)
   • 256: 256 kbps (alta qualidade)
   • 192: 192 kbps (boa qualidade) - padrão
   • 128: 128 kbps (qualidade média)
   • 96: 96 kbps (qualidade básica)

6. Clique em "Baixar Playlist" e aguarde o processo

📝 Formatos de URL suportados

• https://music.youtube.com/playlist?list=...
• https://www.youtube.com/playlist?list=...
• https://www.youtube.com/watch?v=...&list=...

📁 Organização dos arquivos

Os arquivos são salvos com o formato:

01 - Nome da Música.mp3
02 - Nome da Música.mp3
03 - Nome da Música.mp3
...

🐛 Resolução de problemas

"Arquivos saindo em WebM ao invés de MP3"

Causa: FFmpeg não está instalado Solução: Execute instalar_ffmpeg.bat ou instale manualmente

"yt-dlp não está instalado"

Solução: Execute instalar_dependencias.bat ou pip install yt-dlp

"FFmpeg não encontrado"

Solução:

1. Execute instalar_ffmpeg.bat
2. Ou instale via winget install FFmpeg
3. Reinicie o programa após instalação

Erro de download

• Verifique se a URL está correta
• Certifique-se de que a playlist é pública
• Verifique sua conexão com a internet
• Alguns vídeos podem estar bloqueados geograficamente

Interface do programa não abre

• Certifique-se de que o Python está instalado
• Execute instalar_dependencias.bat para verificar dependências

⚠️ Avisos importantes

• Este aplicativo é apenas para uso pessoal
• Respeite os direitos autorais e termos de uso do YouTube
• Certifique-se de ter permissão para baixar o conteúdo
• Use apenas para conteúdo que você tem direito de baixar

📄 Licença

Este projeto é disponibilizado sob a licença MIT. Consulte o arquivo LICENSE para mais detalhes.

🤝 Contribuição

Contribuições são bem-vindas! Sinta-se à vontade para abrir issues ou enviar pull requests.