sunnify spotify downloader

Sunnify（Spotify 下載器）

---

Sunnify 是一款 Spotify 下載器應用程序，可讓您將整個播放清單本地下載到 Mac/Linux/Windows PC 上。

---

程式演示

下面的螢幕截圖展示了 Sunnify 應用程式的運行情況，下載我的個人 Spotify 播放清單。

安裝

先決條件

• 您的系統上安裝了 Python 3.6 或更高版本。如果未安裝，請從 python.org 下載並安裝 Python。
• 確保安裝了 Python 的套件管理器 pip。它通常與 Python 一起提供。您可以透過在終端機中執行pip --version進行驗證。

Sunnify 執行檔 (Windows)

如果您使用的是Windows，您可以直接從這裡下載可執行文件

從源頭構建

克隆儲存庫：

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

導航到專案目錄：

 cd sunnify-spotify-downloader

安裝所需的依賴項：

pip install -r req.txt

運行應用程式：

python Spotify_Downloader.py

用法

1. 啟動 Sunnify 應用程式。
2. 在提供的輸入欄位中輸入您的 Spotify 播放清單 URL。
3. 選取顯示預覽框以查看進度
4. 如果您想下載封面藝術、作者、專輯、發行日期等，請選取元資料框...
5. 在 URL 欄位中按 Enter 鍵開始下載。
6. 下載的歌曲將保存在媒體目錄中（無論原始程式碼或執行檔所在的位置）。

使用的庫

Sunnify 使用以下 Python 函式庫：

• PyQt5：用於GUI介面。
• webbrowser：用於繞過 Spotify 網路流量偵測。
• requests：用於發出 HTTP 請求。
• mutagen.id3：用於編輯 ID3 標籤和抓取元資料。

常見偵錯

如果您在執行 Sunnify 時遇到任何問題，請嘗試以下步驟：

1. 確保您有穩定的網路連線。
2. 驗證您輸入的 Spotify 播放清單 URL 是否正確。
3. 檢查是否有適用於 Sunnify 的任何更新。您可以從儲存庫中提取最新變更並重新安裝相依性。 git pull

執行 Web 應用程式（如果您選擇不使用 Windows 桌面版本）

如果您想在本地運行 Sunnify Web 應用程序，請按照以下步驟設定後端和前端：

後端設定（Sunnify 後端）

1. 導覽至終端機中的web-app/sunnify-backend目錄：

    cd web-app/sunnify-backend

2. 安裝所需的依賴項（如果尚未完成）：

   pip install -r requirements.txt

3. 運行後端伺服器：

   python app.py

   或者，您可以使用：

   python -m app.py

   這將在http://127.0.0.1:5000上啟動後端。

   後端使用Flask與前端通訊以建立 API 端點，並使用Flask-CORS來處理跨來源資源共用 (CORS)，從而允許前端和後端之間跨不同域的 API 請求。

前端設定（Sunnify Web 用戶端）

1. 後端運行後，導航至web-app/sunnify-webclient目錄：

    cd ../sunnify-webclient

2. 安裝所需的前端相依性：

   npm install

3. 啟動前端開發伺服器：

   npm run dev

   前端現在將在http://localhost:3000上本地運行，並且可以與http://127.0.0.1:5000上的後端通訊。

---

使用的技術

前端技術：

• ⚛️ React ：用於建立使用者介面元件。
• Next.js ：提供伺服器端渲染和路由的框架。
• ？ Tailwind CSS ：用於樣式和響應式設計。
• ？ shadcn/ui ：提供預先建置的、可自訂的 UI 元件。
• ？ Lucide React ：用於整個應用程式中的圖示。
• React Hooks ：用於狀態管理和副作用。
• Fetch API ：用於向後端發出 HTTP 請求。
• Web Audio API ：實作音訊播放功能。

後端技術：

• ？ Flask ：用於建立 API 端點的 Python Web 框架。
• ？ Flask-CORS ：處理 API 請求的跨來源資源共用 (CORS)。
• ？ Requests ：用於發出 HTTP 請求以取得播放清單資料。
• ？ Mutagen ：用於編輯 ID3 標籤和抓取元資料。
• ?️ BeautifulSoup ：用於網頁擷取和解析 HTML 內容。
• ？ UUID ：為追蹤和分析過程產生唯一的 ID。
• ‍♂️ User-Agent ：模擬真實的瀏覽器活動以繞過保護機制。
• ？ Selenium ：用於瀏覽器自動化和模擬使用者互動。
• ？ FFmpeg ：處理音訊轉換和處理。

---

主要特點

• CORS 處理：實作安全地允許跨來源請求。
• ？ ID 產生：為追蹤和分析過程產生唯一 ID。
• ?️瀏覽器標頭模擬：模仿真實的瀏覽器標頭以避免檢測。
• 播放清單元資料檢索：取得並處理播放清單資訊。
• ?️網頁抓取：從網頁擷取必要的資料。
• ? ‍ 真實瀏覽器活動模擬：模擬類似人類的瀏覽模式。
• 用戶代理輪換：定期更改用戶代理字串以避免阻塞。
• ️ Flask 路由：處理不同功能的各種 API 端點。
• ⚡異步處理：管理並發下載和處理任務。
• 錯誤處理：針對各種場景的強大錯誤管理。

---

重要提示

Sunnify 的後端根據免費計算計劃託管在 Render 上。如果一段時間內沒有對渲染託管後端進行 API 調用，它可能會“睡著”，並在前端發送請求（例如，下載播放清單）時需要一段時間才能喚醒。請耐心等待，後端可能需要幾秒鐘的時間才能喚醒並處理請求。

---

即將推出

我目前正在致力於將 Sunnify 與 iTunes 集成，以便將下載的音樂無縫傳輸到 iOS 設備，特別是將它們添加到 Apple Music 庫中。此外，我還致力於添加對 Android 檔案系統的支持，以便將下載的音樂直接傳輸到 Android 裝置。

請繼續關注這些令人興奮的更新，它們將增強 Sunnify 的功能，並為不同平台的用戶提供更無縫的體驗。

⚖️法律與道德聲明⚖️

Sunnify（Spotify 下載器）僅用於教育目的。您有責任確保遵守您所在國家或地區的版權法律和法規。在某些司法管轄區，未經適當授權下載受版權保護的音樂可能是非法的。

作者

Sunnify (Spotify Downloader) 由 Sunny Jayendra Patel 開發和維護。如有疑問、建議或回饋，請聯絡 Sunny：[email protected]。

執照

該項目根據自訂許可證獲得許可。有關詳細信息，請參閱許可證文件。

---

貢獻

如果您遇到任何錯誤、有功能請求或想要貢獻增強功能，請隨時在 GitHub 上提交拉取請求。

報告問題

如果您在使用 Sunnify 時遇到任何問題，請在 GitHub 上提出問題。請務必提供有關該問題的詳細信息，包括重現該問題的步驟以及您可能遇到的任何錯誤訊息。您的回饋有助於我為其他人改進應用程式。

---