🎵 Donation Media Hub

Desktop player for donation music from DonationAlerts and DonateX
with automatic YouTube → MP3 download and playback.

Clean architecture · Dark UI · Vertical player · Windows & macOS

---

✨ Features

• 🎧 Queue-based music player
• 🔄 Auto polling:
  • DonationAlerts (YouTube media)
  • DonateX (musicLink)
• ⬇️ YouTube → MP3 auto-download (via API)
• 🧠 Smart queue trimming (keeps current / prev / next)
• 💾 Persistent state:
  • queue
  • tokens
  • last processed donations
• 🖥️ Builds for Windows (.exe)

---

🖼️ UI Overview

• Now Playing card
• Transport controls:
  Start | Prev | Play/Pause | Next | Skip
• Queue table (minimal):
  • #
  • Title
  • Status
• Tokens & settings panel
• Log panel (compact)

🔑 Tokens

DonationAlerts

1. Open: https://www.donationalerts.com/dashboard/general-settings/account
2. Copy Secret token
3. Paste into DA field

DonateX

1. Open: https://donatex.gg/streamer/dashboard

2. Open donations page

3. In URL find:

   token=XXXX
   

4. Copy XXXX into DX field

You can use only one service — the other may stay empty.

---

🚀 Quick Start (Dev)

1️⃣ Python

Recommended:

Python 3.10 – 3.11

2️⃣ Install dependencies

pip install -r requirements.txt

3️⃣ Run app

python run.py

---

🔊 Audio

• Uses pygame

• If pygame is missing:

  pip install pygame
  

• If audio init fails, the app will show an error.

---

🧹 Temp Files

• MP3 files are stored in OS temp directory:

  donation_media_hub_tracks/
  

• App keeps only:

  • previous
  • current
  • next track

• On exit, user is asked whether to clean temp files.

---

🛠️ Build (Local)

Install PyInstaller

pip install pyinstaller

Build

pyinstaller donation_media_hub.spec

Output

OS	Result
Windows	dist/DonationMediaHub.exe

🧠 Architecture Principles

• UI ≠ Business logic
• UI does NOT call APIs directly
• Background threads communicate via event queue
• Single responsibility per module
• PyInstaller-safe paths

---

📜 License

MIT

---

❤️ Fatyzzz

Built with care for streamers.

Contributions and ideas welcome.