🎵 YTGrabber
Terminal-based YouTube & YouTube Music downloader and player with search, playlist support, and MP3 conversion
YTGrabber é uma ferramenta completa de linha de comando para buscar, reproduzir e baixar conteúdo do YouTube e YouTube Music. Com interface intuitiva em português, suporte a MPV player integrado, conversão automática para MP3, e gerenciamento organizado de downloads por tipo (vídeos, playlists, álbuns, canais).
✨ Recursos
- 🔍 Busca integrada no YouTube e YouTube Music com resultados organizados
▶️ Reprodução direta de vídeos e músicas usando MPV player embutido- 💾 Download de áudio em MP3 com conversão automática via FFmpeg
- 📦 Suporte a downloads em massa de playlists, álbuns e canais completos
- 🍪 Sistema de cookies para acesso a conteúdo restrito do YouTube Music
- 🇧🇷 Interface 100% em português com navegação intuitiva por menus
- 📁 Organização automática de downloads em pastas separadas (downloads, playlists, albuns, canais)
📦 Download
Escolha a versão que melhor atende suas necessidades:
1️⃣ YTGrabber-Full.rar (Pasta completa)
- Tamanho: ~150-200MB (descompactado)
- Vantagem: Abre instantaneamente (menos de 2 segundos), porque todos os arquivos já estão extraídos e prontos
- Desvantagem: Precisa extrair o RAR e manter a pasta com todos os arquivos organizados
- Ideal para: Quem usa frequentemente e quer velocidade máxima de abertura
⬇️ Download YTGrabber-Full.rar
2️⃣ YTGrabber-Portable.exe (Arquivo único)
- Tamanho: ~80-100MB
- Vantagem: Só baixar e executar! Tudo empacotado em um único arquivo executável
- Desvantagem: Leva de 15-30 segundos pra abrir na primeira execução, porque ele precisa descompactar tudo temporariamente em background
- Ideal para: Quem quer praticidade máxima e não liga pra demora na inicialização
⬇️ Download YTGrabber-Portable.exe
💡 Dica: Se for usar o programa direto, pegue a versão Full. Se for só testar ou usar esporadicamente, a Portable tá de boa!
🔧 O que vem incluído
- MPV player portátil
- FFmpeg e FFprobe
- Todas as bibliotecas Python necessárias (yt-dlp, ytmusicapi)
⚙️ Requisitos do Sistema
- Windows 10/11 (64-bit)
- Arquivo
cookies.txtdo YouTube para acesso completo ao YouTube Music (instruções incluídas no programa)
🚀 Como usar
- Baixe a versão de sua preferência (Full.rar ou Portable.exe)
- Se escolheu o RAR, extraia todos os arquivos
- Execute o arquivo
YouTubeCLI.exe - Siga as instruções no menu para:
- Buscar conteúdo no YouTube ou YouTube Music
- Reproduzir vídeos/músicas diretamente
- Baixar em MP3
- Baixar playlists, álbuns ou canais completos
🍪 Configuração de Cookies (Opcional)
Para acessar conteúdo restrito do YouTube Music, você precisa do arquivo cookies.txt:
- Instale a extensão "Get cookies.txt LOCALLY" no Chrome/Edge
- Acesse music.youtube.com e faça login
- Clique na extensão e exporte os cookies
- Salve o arquivo
cookies.txtna mesma pasta do YouTubeCLI - Pronto! Agora você tem acesso completo
Nota: Os cookies expiram após aproximadamente 1 mês e precisam ser renovados.
🐛 Problemas Conhecidos
Esta é uma versão beta inicial (0.x). Algumas funcionalidades podem apresentar bugs ou comportamentos inesperados.
Se encontrar algum problema:
- Abra uma Issue
- Descreva o erro detalhadamente
- Inclua capturas de tela se possível
📝 Licença
Este projeto está sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.
🤝 Contribuindo
Contribuições são bem-vindas! Sinta-se livre para:
- Reportar bugs
- Sugerir novos recursos
- Enviar pull requests
📧 Contato
Criado por JoaoDEVWHADS
⭐ Apoie o Projeto
Se o YTGrabber foi útil pra você, considere dar uma estrela ⭐ no repositório!