sunnify spotify downloader

Sunnify (Pengunduh Spotify)

---

Sunnify adalah aplikasi pengunduh Spotify yang memungkinkan Anda mengunduh seluruh daftar putar secara lokal ke Mac/Linux/PC Windows Anda.

---

Demonstrasi Program

Di bawah ini adalah tangkapan layar yang menunjukkan aplikasi Sunnify beraksi, mengunduh playlist Spotify pribadi saya.

Instalasi

Prasyarat

• Python 3.6 atau lebih tinggi diinstal pada sistem Anda. Jika belum terinstal, unduh dan instal Python dari python.org.
• Pastikan pip, manajer paket Python, telah diinstal. Biasanya dilengkapi dengan Python. Anda dapat memverifikasi dengan menjalankan pip --version di terminal Anda.

Sunnify Dapat Dieksekusi (Windows)

Jika Anda menggunakan Windows, Anda dapat langsung mengunduh file yang dapat dieksekusi dari sini

Membangun dari Sumber

Kloning repositori:

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

Arahkan ke direktori proyek:

 cd sunnify-spotify-downloader

Instal dependensi yang diperlukan:

pip install -r req.txt

Jalankan aplikasi:

python Spotify_Downloader.py

Penggunaan

1. Luncurkan aplikasi Sunnify.
2. Masukkan URL playlist Spotify Anda di kolom input yang tersedia.
3. Centang kotak tampilkan pratinjau untuk melihat kemajuan
4. Centang kotak metadata jika Anda ingin mengunduh sampul, penulis, album, tanggal rilis, dll...
5. Tekan enter di bidang URL untuk mulai mengunduh.
6. Lagu yang diunduh akan disimpan di direktori media (di mana pun sumber atau file executable Anda berada).

Perpustakaan Digunakan

Sunnify menggunakan pustaka Python berikut:

• PyQt5: Digunakan untuk antarmuka GUI.
• browser web: Digunakan untuk melewati Deteksi Lalu Lintas Jaringan Spotify.
• permintaan: Digunakan untuk membuat permintaan HTTP.
• mutagen.id3: Digunakan untuk mengedit tag ID3 dan menggores metadata.

Debug Umum

Jika Anda mengalami masalah apa pun saat menjalankan Sunnify, coba langkah-langkah berikut:

1. Pastikan Anda memiliki koneksi internet yang stabil.
2. Pastikan Anda telah memasukkan URL playlist Spotify yang benar.
3. Periksa apakah ada pembaruan yang tersedia untuk Sunnify. Anda dapat mengambil perubahan terbaru dari repositori dan menginstal ulang dependensinya. git pull

Menjalankan Aplikasi Web (Jika Anda memilih untuk tidak menggunakan versi Windows Desktop)

Jika Anda ingin menjalankan aplikasi web Sunnify secara lokal, ikuti langkah-langkah berikut untuk menyiapkan backend dan frontend:

Pengaturan Backend (Sunnify Backend)

1. Navigasikan ke direktori web-app/sunnify-backend di terminal Anda:

    cd web-app/sunnify-backend

2. Instal dependensi yang diperlukan jika belum selesai:

   pip install -r requirements.txt

3. Jalankan server backend:

   python app.py

   Sebagai alternatif, Anda dapat menggunakan:

   python -m app.py

   Ini akan memulai backend pada http://127.0.0.1:5000 .

   Backend berkomunikasi dengan frontend menggunakan Flask untuk membuat titik akhir API dan Flask-CORS untuk menangani Cross-Origin Resource Sharing (CORS), memungkinkan permintaan API antara frontend dan backend di domain yang berbeda.

Pengaturan Frontend (Klien Web Sunnify)

1. Setelah backend berjalan, navigasikan ke direktori web-app/sunnify-webclient :

    cd ../sunnify-webclient

2. Instal dependensi frontend yang diperlukan:

   npm install

3. Mulai server pengembangan frontend:

   npm run dev

   Frontend sekarang akan berjalan secara lokal di http://localhost:3000 dan dapat berkomunikasi dengan backend di http://127.0.0.1:5000 .

---

Teknologi yang Digunakan

Teknologi Bagian Depan:

• ⚛️ React : Digunakan untuk membangun komponen antarmuka pengguna.
• Next.js : Menyediakan kerangka kerja untuk rendering dan perutean sisi server.
• ? Tailwind CSS : Digunakan untuk penataan gaya dan desain responsif.
• ? shadcn/ui : Menyediakan komponen UI yang sudah dibuat sebelumnya dan dapat disesuaikan.
• ? Lucide React : Digunakan untuk ikon di seluruh aplikasi.
• React Hooks : Digunakan untuk manajemen status dan efek samping.
• Fetch API : Digunakan untuk membuat permintaan HTTP ke backend.
• Web Audio API : Diimplementasikan untuk fungsi pemutaran audio.

Teknologi Backend:

• ? Flask : Kerangka web Python untuk membuat titik akhir API.
• ? Flask-CORS : Menangani Cross-Origin Resource Sharing (CORS) untuk permintaan API.
• ? Permintaan : Digunakan untuk membuat permintaan HTTP untuk mengambil data daftar putar.
• ? Mutagen : Digunakan untuk mengedit tag ID3 dan menggores metadata.
• ?️ BeautifulSoup : Digunakan untuk web scraping dan parsing konten HTML.
• ? UUID : Menghasilkan ID unik untuk trek dan proses analisis.
• ‍♂️ Agen-Pengguna : Mengemulasi aktivitas browser nyata untuk melewati mekanisme perlindungan.
• ? Selenium : Digunakan untuk otomatisasi browser dan meniru interaksi pengguna.
• ? FFmpeg : Menangani konversi dan pemrosesan audio.

---

Fitur Utama

• Penanganan CORS : Diimplementasikan untuk memungkinkan permintaan lintas asal dengan aman.
• ? Pembuatan ID : ID unik dihasilkan untuk jalur dan proses analisis.
• ?️ Emulasi Header Browser : Meniru header browser asli untuk menghindari deteksi.
• Pengambilan Metadata Daftar Putar : Mengambil dan memproses informasi daftar putar.
• ?️ Web Scraping : Mengekstrak data yang diperlukan dari halaman web.
• ? ‍ Emulasi Aktivitas Peramban Nyata : Mensimulasikan pola penjelajahan mirip manusia.
• Rotasi Agen-Pengguna : Secara teratur mengubah string agen-pengguna untuk menghindari pemblokiran.
• ?️ Flask Routing : Menangani berbagai titik akhir API untuk fungsi yang berbeda.
• ⚡ Pemrosesan Asinkron : Mengelola pengunduhan dan tugas pemrosesan secara bersamaan.
• Penanganan Kesalahan : Manajemen kesalahan yang kuat untuk berbagai skenario.

---

Catatan Penting

Backend untuk Sunnify dihosting di Render berdasarkan paket komputasi gratis. Jika tidak ada panggilan API ke backend yang dihosting Render selama beberapa waktu, mungkin akan "tertidur" dan memerlukan waktu beberapa saat untuk bangun ketika frontend mengirimkan permintaan (misalnya, mendownload playlist). Harap bersabar karena mungkin diperlukan waktu beberapa detik hingga backend aktif dan memproses permintaan.

---

Segera hadir

Saat ini saya sedang berupaya mengintegrasikan Sunnify dengan iTunes untuk transfer musik yang diunduh dengan lancar ke perangkat iOS, khususnya menambahkannya ke perpustakaan Apple Music. Selain itu, saya juga berupaya menambahkan dukungan untuk sistem file Android untuk memungkinkan transfer langsung musik yang diunduh ke perangkat Android.

Nantikan pembaruan menarik ini, yang akan meningkatkan fungsionalitas Sunnify dan memberikan pengalaman yang lebih lancar bagi pengguna di berbagai platform.

⚖️Pemberitahuan Hukum dan Etika⚖️

Sunnify (Spotify Downloader) dimaksudkan untuk tujuan pendidikan saja. Anda bertanggung jawab untuk memastikan bahwa Anda mematuhi undang-undang dan peraturan hak cipta di negara atau wilayah Anda. Mengunduh musik berhak cipta tanpa izin yang sesuai mungkin ilegal di wilayah hukum tertentu.

Pengarang

Sunnify (Spotify Downloader) dikembangkan dan dikelola oleh Sunny Jayendra Patel. Untuk pertanyaan, saran, atau masukan, silakan hubungi Sunny di [email protected].

Lisensi

Proyek ini dilisensikan di bawah Lisensi Kustom. Lihat file LISENSI untuk detailnya.

---

Berkontribusi

Jika Anda menemukan bug, memiliki permintaan fitur, atau ingin memberikan kontribusi penyempurnaan, silakan kirimkan permintaan penarikan di GitHub.

Masalah Pelaporan

Jika Anda mengalami masalah apa pun saat menggunakan Sunnify, silakan buka masalah di GitHub. Pastikan untuk menyertakan informasi rinci tentang masalah tersebut, termasuk langkah-langkah untuk mereproduksinya dan pesan kesalahan apa pun yang mungkin Anda temui. Masukan Anda membantu saya meningkatkan aplikasi untuk orang lain.

---