🎬 YouTube Mail & Telegram Playlist Downloader

📌 Was macht das Skript?

Dieses Projekt lädt automatisch YouTube-Videos und ganze Playlists herunter – ausgelöst per E-Mail oder Telegram-Befehl.

Features:

• 📧 Liest YouTube-Links aus E-Mails mit dem Betreff YouTube
  
• 📂 Lädt Playlists aus playlists.txt
  
• 🤖 Telegram-Bot zum Abrufen und Verwalten von Downloads
  
• 🧠 Automatische Unterordnerstruktur nach Eingabe
  
• 🎵 Optional: MP3-Konvertierung der Videos
  
• 🧱 Keine Dubletten dank Download-Archiv
  
• 🔧 Flexible Qualitätswahl: 720p, 1080p, max
  
• 🪵 Logging & Fehleranalyse
  
• 💬 Hilfemenü per Telegram-Befehl
  
• 🛑 Steuerung per /StopBot oder STOP-Datei
  
  

---

🚀 Quickstart

🔁 Repository klonen

git clone https://github.com/DEINUSER/yt_downloader.git
cd yt_downloader

📦 Abhängigkeiten installieren

pip install -r requirements.txt

⚙️ Konfiguration
Bearbeite config.json und hinterlege dort:

• Mail-Zugangsdaten
  
• Downloadverzeichnis
  
• Standard-Qualität
  
• Telegram-Bot-Token & Chat-ID (optional)
  
  

---

🎵 Playlists verwalten

Trage in playlists.txt deine gewünschten Playlists ein – Format:

https://www.youtube.com/playlist?list=PLxxxx;Ordnername;Qualität;mp3

Beispiel:

https://www.youtube.com/playlist?list=PL123456789;TechDokus;1;mp3

---

✉️ Videos per Mail anstoßen

Sende eine E-Mail mit Betreff YouTube und Inhalt wie:

https://www.youtube.com/watch?v=abc123, Musik-Live, 0, mp3
  oder
https://www.youtube.com/watch?v=xyz123, , 2, mp3

- Qualität: 0=720p, 1=1080p, 2=max

---

🤖 Telegram-Bot verwenden

Sende Befehle an deinen Bot:

• /dl https://youtube.com/watch?v=abc123, Musik, 1, mp3 – startet einen Download
• /help – zeigt Hilfetext an
• /stopbot – beendet den Bot (bis Neustart)
• ➕ Bot prüft regelmäßig auf STOP-Datei yt_telegram_downloader.STOP

---

🧪 Skripte testen

# Mail-Downloader
python3 yt_mail_downloader.py
Telegram-Downloader (läuft dauerhaft)
python3 yt_telegram_downloader.py

---

🕑 Automatisierung via Cron oder systemd

Beispiel für Cron (alle 30 Minuten):

*/30 * * * * /usr/bin/python3 /pfad/yt_downloader/yt_mail_downloader.py

Oder über systemd-Timer für bessere Kontrolle.

---

Cronjobs über SystemD einrichten

🏁 Aktivieren

bash sudo cp yt_mail_downloader.* /etc/systemd/system/ sudo cp yt_telegram_downloader.service /etc/systemd/system/ sudo systemctl daemon-reload sudo systemctl enable --now yt_mail_downloader.timer

sudo systemctl enable yt_telegram_downloader.service sudo systemctl start yt_telegram_downloader.service

🏁 Timer aktualisieren (z.B. Zeiten ändern)

bash sudo cp yt_mail_downloader.* /etc/systemd/system/ sudo systemctl daemon-reexec sudo systemctl daemon-reload sudo systemctl restart yt_mail_downloader.timer

sudo systemctl enable yt_telegram_downloader.service sudo systemctl start yt_telegram_downloader.service

sudo systemctl list-timers | grep verz

🏁 Starte Telegram-Bot neu... z.B. nach /StopBot

sudo systemctl restart yt_telegram_downloader.service oder sudo ./start_telegram_bot.sh

---

✅ Zusammenfassung der Features

• 🔁 Zyklisches Mail-Monitoring
• 📥 Playlists + Einzelvideos
• 🗂 Ordnerstruktur je nach Vorgabe
• 🎞 MP3-Konvertierung optional
• 🔒 Kein mehrfacher Download (Archiv)
• 🤖 Telegram-Befehle für sofortige Steuerung
• 🧼 STOP-Funktion (Datei & per Befehl)
• 📄 Logfile-Ausgabe für jedes Skript

---

Viel Spaß beim automatisierten Sammeln deiner Lieblingsinhalte! 💡