Moodle Video Optimizer (via .mbz)

Moodle-Kurse zu groß? Videos sprengen das Backup? Hier ist die Lösung.

Jeder Moodle-Administrator oder Kurs-Ersteller kennt das Problem: Man möchte einen Kurs sichern oder umziehen, aber die .mbz-Datei ist mehrere Gigabyte groß. Meistens sind hochauflösende Videos die Übeltäter. Moodle selbst bietet keine einfache Möglichkeit, alle Videos eines Backups in einem Rutsch zu verkleinern, ohne die Integrität der Datei-Hashes zu verletzen.

Dieses Tool automatisiert diesen Prozess. Es entpackt das Backup, optimiert alle enthaltenen Videos (z.B. auf webtaugliche 720p), berechnet die neuen SHA-1 Hashes, aktualisiert die Moodle-Metadaten (files.xml) und schnürt ein neues, deutlich kleineres Backup-Paket.

---

🚀 Features

• Intelligente Optimierung: Skaliert Videos auf 720p (oder wählbar) und nutzt moderne H.264 Kompression (CRF 28).
• Integrität bewahrt: Aktualisiert alle Moodle-internen Hashes und Metadaten, sodass das Backup fehlerfrei wiederhergestellt werden kann (keine "progress out of range" Fehler).
• Einfache Bedienung: Moderne grafische Benutzeroberfläche (GUI) mit Fortschrittsanzeige.
• Portable Edition: Läuft unter Windows ohne Installation von Python oder anderen Abhängigkeiten.
• Cross-Platform: Lädt die benötigten FFmpeg-Binaries für Windows, Mac und Linux automatisch nach.
• Logging: Detaillierte Log-Dateien für maximale Transparenz und Fehlersuche.

---

🛠 Nutzung

Variante A: Die Portable Version (Empfohlen)

1. Lade die aktuellste Version unter Releases herunter.
2. Entpacke die ZIP-Datei.
3. Starte die MoodleVideoOptimizer.exe.
4. Wähle deine .mbz Datei aus, stelle die gewünschte Qualität ein und klicke auf "Optimierung Starten".

Variante B: Als Python-Skript (für Entwickler)

1. Klone das Repository.
2. Installiere die Anforderungen: pip install -r requirements.txt.
3. Starte das Tool über python main.py oder nutze die beiliegende start.bat.

---

📂 Struktur des Projekts

• core/: Die "Engine" des Tools (Archiv-Handling, XML-Parsing, Video-Processing).
• gui/: Die Benutzeroberfläche basierend auf CustomTkinter.
• utils/: Hilfsfunktionen für Logging, Config und den automatischen FFmpeg-Download.

---

🤝 Mitwirken & Kontakt

Dieses Tool wurde entwickelt, um die Arbeit mit Moodle-Kursen effizienter zu gestalten. Wenn du Fehler findest oder Verbesserungsvorschläge hast, öffne gerne ein Issue oder einen Pull Request.

Created by Steffen Schwabe
GitHub Profil

---

Rechtlicher Hinweis

Dieses Tool nutzt FFmpeg (LGPL v2.1). FFmpeg wird beim ersten Start automatisch von offiziellen Quellen heruntergeladen und im lokalen bin/ Ordner abgelegt.