sunnify spotify downloader

Sunnify (baixador do Spotify)

---

Sunnify é um aplicativo de download do Spotify que permite baixar playlists inteiras localmente em seu PC Mac/Linux/Windows.

---

Demonstração do programa

Abaixo estão capturas de tela que demonstram o aplicativo Sunnify em ação, baixando minha playlist pessoal do Spotify.

Instalação

Pré-requisitos

• Python 3.6 ou superior instalado em seu sistema. Se não estiver instalado, baixe e instale o Python em python.org.
• Certifique-se de que o pip, gerenciador de pacotes do Python, esteja instalado. Geralmente vem com Python. Você pode verificar executando pip --version em seu terminal.

Executável Sunnify (Windows)

Se estiver usando Windows, você pode baixar diretamente o arquivo executável aqui

Construindo a partir da fonte

Clone o repositório:

git clone https://github.com/sunnypatell/sunnify-spotify-downloader.git

Navegue até o diretório do projeto:

 cd sunnify-spotify-downloader

Instale as dependências necessárias:

pip install -r req.txt

Execute o aplicativo:

python Spotify_Downloader.py

Uso

1. Inicie o aplicativo Sunnify.
2. Insira o URL da sua lista de reprodução do Spotify no campo de entrada fornecido.
3. Marque a caixa de visualização para ver o progresso
4. Marque a caixa de metadados se quiser baixar a capa, autor, álbum, data de lançamento, etc.
5. Pressione Enter no campo URL para iniciar o download.
6. As músicas baixadas serão salvas no diretório de mídia (onde quer que sua fonte ou executável esteja localizado).

Bibliotecas usadas

Sunnify utiliza as seguintes bibliotecas Python:

• PyQt5: usado para a interface GUI.
• navegador da web: usado para ignorar a detecção de tráfego de rede do Spotify.
• solicitações: usado para fazer solicitações HTTP.
• mutagen.id3: usado para editar tags ID3 e extrair metadados.

Depuração Comum

Se você encontrar algum problema ao executar o Sunnify, tente as seguintes etapas:

1. Certifique-se de ter uma conexão estável com a Internet.
2. Verifique se você inseriu o URL correto da lista de reprodução do Spotify.
3. Verifique se há alguma atualização disponível para Sunnify. Você pode extrair as alterações mais recentes do repositório e reinstalar as dependências. git pull

Executando o Web App (se você optar por não usar a versão Windows Desktop)

Se você deseja executar o aplicativo da web Sunnify localmente, siga estas etapas para configurar o back-end e o front-end:

Configuração de back-end (back-end Sunnify)

1. Navegue até o diretório web-app/sunnify-backend em seu terminal:

    cd web-app/sunnify-backend

2. Instale as dependências necessárias, caso ainda não tenha feito:

   pip install -r requirements.txt

3. Execute o servidor back-end:

   python app.py

   Alternativamente, você pode usar:

   python -m app.py

   Isso iniciará o back-end em http://127.0.0.1:5000 .

   O back-end se comunica com o front-end usando Flask para criar endpoints de API e Flask-CORS para lidar com o compartilhamento de recursos de origem cruzada (CORS), permitindo solicitações de API entre o front-end e o back-end em diferentes domínios.

Configuração de front-end (cliente Web Sunnify)

1. Assim que o back-end estiver em execução, navegue até o diretório web-app/sunnify-webclient :

    cd ../sunnify-webclient

2. Instale as dependências de front-end necessárias:

   npm install

3. Inicie o servidor de desenvolvimento front-end:

   npm run dev

   O frontend agora será executado localmente em http://localhost:3000 e poderá se comunicar com o backend em http://127.0.0.1:5000 .

---

Tecnologias Utilizadas

Tecnologias de front-end:

• ⚛️ React : usado para construir os componentes da interface do usuário.
• Next.js : fornece a estrutura para renderização e roteamento do lado do servidor.
• ? Tailwind CSS : usado para estilo e design responsivo.
• ? shadcn/ui : Fornece componentes de UI pré-construídos e personalizáveis.
• ? Lucide React : usado para ícones em todo o aplicativo.
• React Hooks : Utilizados para gerenciamento de estado e efeitos colaterais.
• API de busca : usada para fazer solicitações HTTP ao back-end.
• API de áudio da Web : implementada para funcionalidade de reprodução de áudio.

Tecnologias de back-end:

• ? Flask : estrutura web Python para criar os endpoints da API.
• ? Flask-CORS : Lida com compartilhamento de recursos entre origens (CORS) para solicitações de API.
• ? Solicitações : usadas para fazer solicitações HTTP para buscar dados da lista de reprodução.
• ? Mutagênico : usado para editar tags ID3 e extrair metadados.
• ?️ BeautifulSoup : usado para web scraping e análise de conteúdo HTML.
• ? UUID : Gera IDs exclusivos para trilhas e processos de análise.
• ‍♂️ User-Agent : emula a atividade real do navegador para contornar os mecanismos de proteção.
• ? Selenium : usado para automação do navegador e emulação de interações do usuário.
• ? FFmpeg : Lida com conversão e processamento de áudio.

---

Principais recursos

• Tratamento CORS : implementado para permitir solicitações de origem cruzada com segurança.
• ? Geração de ID : IDs exclusivos são gerados para rastreamentos e processos de análise.
• ?️ Emulação de cabeçalhos de navegador : imita cabeçalhos reais de navegador para evitar detecção.
• Recuperação de metadados da lista de reprodução : busca e processa informações da lista de reprodução.
• ?️ Web Scraping : extrai os dados necessários das páginas da web.
• ? ‍ Emulação de atividade real do navegador : simula padrões de navegação semelhantes aos humanos.
• Rotação de agente de usuário : altera regularmente as strings de agente de usuário para evitar bloqueio.
• ?️ Flask Routing : Lida com vários endpoints de API para diferentes funcionalidades.
• ⚡ Processamento assíncrono : gerencia downloads simultâneos e tarefas de processamento.
• Tratamento de erros : gerenciamento robusto de erros para vários cenários.

---

Nota importante

O back-end do Sunnify está hospedado no Render no plano de computação gratuito. Se não houver uma chamada de API para o back-end hospedado no Render por um tempo, ele poderá "adormecer" e demorar um pouco para acordar quando o front-end enviar uma solicitação (por exemplo, baixando uma lista de reprodução). Seja paciente, pois pode levar alguns segundos para o back-end ativar e processar a solicitação.

---

Em breve

Atualmente estou trabalhando na integração do Sunnify com o iTunes para transferência perfeita de músicas baixadas para dispositivos iOS, adicionando-as especificamente à biblioteca do Apple Music. Além disso, também estou trabalhando para adicionar suporte a sistemas de arquivos Android para permitir a transferência direta de músicas baixadas para dispositivos Android.

Fique atento a essas atualizações interessantes, que aprimorarão a funcionalidade do Sunnify e fornecerão uma experiência mais integrada para usuários em diferentes plataformas.

⚖️Aviso Legal e Ético⚖️

Sunnify (Spotify Downloader) destina-se apenas a fins educacionais. É sua responsabilidade garantir o cumprimento das leis e regulamentos de direitos autorais em seu país ou região. Baixar músicas protegidas por direitos autorais sem a devida autorização pode ser ilegal em certas jurisdições.

Autor

Sunnify (Spotify Downloader) é desenvolvido e mantido por Sunny Jayendra Patel. Para dúvidas, sugestões ou comentários, entre em contato com Sunny em [email protected].

Licença

Este projeto está licenciado sob a Licença Personalizada. Consulte o arquivo LICENSE para obter detalhes.

---

Contribuindo

Se você encontrar algum bug, tiver solicitações de recursos ou quiser contribuir com melhorias, sinta-se à vontade para enviar uma solicitação pull no GitHub.

Relatando problemas

Se você encontrar algum problema ao usar o Sunnify, abra um problema no GitHub. Certifique-se de incluir informações detalhadas sobre o problema, incluindo etapas para reproduzi-lo e quaisquer mensagens de erro que você possa ter encontrado. Seu feedback me ajuda a melhorar o aplicativo para todos os outros.

---