Modernes, performantes Desktop-Tool zur Stapelkomprimierung, WebP-Konvertierung und Cloud-Optimierung.
- ⚡ Verlustarme Stapelverarbeitung: Verarbeiten Sie hunderte von Bildern vollautomatisch im Hintergrund ohne Einfrieren der Benutzeroberfläche.
- 🎨 Moderne Dark/Light UI: Intuitive Oberfläche mit CustomTkinter, Live-Fortschrittsanzeige und integriertem Log-Terminal.
- 🔄 Next-Gen WebP Konvertierung: Wandelt PNG- und JPEG-Dateien in moderne WebP-Grafiken für maximale Web-Performance um.
- 📐 Smarte Skalierung: Proportionale Größenanpassung mit automatischer EXIF-Ausrichtungskorrektur.
- ☁️ TinyPNG Integration: Nahtlose Cloud-Komprimierung für maximale Dateigrößen-Reduktion.
- 🛡️ Enterprise Security: Absicherung gegen Decompression-Bombs, Path-Traversal und Leaks von sensiblen API-Keys.
| Modul | Unterstützte Formate | Funktion |
|---|---|---|
| Lokale Komprimierung | .jpg, .jpeg, .png |
Anpassbare JPEG-Qualität (0–100 %) & PNG-Kompressionsstufen (0–9) |
| WebP Konvertierung | .png, .jpg, .jpeg |
Konvertierung mit Qualitätsregler und optionaler Maximalauflösung |
| TinyPNG Cloud | .png, .jpg, .jpeg |
Cloud-Kompression über offizielle TinyPNG-API mit automatischer Validierung |
Die Kernfunktionalität in main.py ist sauber zwischen GUI (CustomTkinter) und zustandsloser Domain-/Verarbeitungslogik getrennt:
- Kernverarbeitung (GUI-unabhängig):
compress_image_file,convert_image_to_webp,compress_image_tinypng - Konfigurationsmanagement: Atomares Speichern (
save_settings_file), sicheres Auslesen (load_settings_file) und Zusammenführen von.env- und JSON-Werten (get_merged_settings) - GUI-Steuerung & Reaktivität: Generische Steuerelement-Generatoren (
create_slider_row), bidirektionale Slider-Entry-Synchronisation (sync_slider_to_entry,sync_entry_to_slider) und dynamisches Tab-Mapping
git clone https://github.com/<username>/<repository>.git
cd "Bild Berabeitung"
# Virtuelle Umgebung erstellen und aktivieren (Windows)
python -m venv venv
venv\Scripts\activatepip install -r requirements.txtpython main.pyStandardordner und der TinyPNG API-Key können entweder direkt in der GUI oder über Umgebungsvariablen hinterlegt werden:
# Beispiel-Umgebungsdatei kopieren
copy .env.example .envBeispiel für .env:
TINYPNG_API_KEY=ihr_tinypng_api_key
COMP_SOURCE_DIR=Bilder_original
COMP_DEST_DIR=Bilder_komprimiertHinweis zur Sicherheit: Lokale Einstellungen (
settings.json) und Umgebungsvariablen (.env) werden durch.gitignoreautomatisch vor der Versionskontrolle geschützt.
Das Repository enthält ein optimiertes Build-Skript zur Erstellung einer eigenständigen Windows-Executable mittels PyInstaller:
# Build ausführen:
python build.py
# Schneller Build ohne Cython:
python build.py --no-cythonDas fertige Paket wird im Ordner dist_<timestamp>/ erstellt.
# Automatisierte Tests ausführen
pytest -v
# Testabdeckung analysieren
pytest --cov=. --cov-report=term-missing
# Code-Style & Linter (inkl. Flake8-Simplify)
ruff check .
# Statische Typüberprüfung
mypy main.py build.py
# Sicherheitsprüfung des Codes (SAST)
bandit -r main.py build.py -lll
# Sicherheitsprüfung der Abhängigkeiten (SCA)
pip-audit -r requirements.txt- Zero Secret Leaks: Keine hardcodierten Zugangsdaten; strikte Isolation lokaler Einstellungen (
settings.json,.env) via.gitignoreund automatischer Ausschluss insichern.py. - DoS- & Decompression-Schutz: Konfigurierte Obergrenzen für Pixeldimensionen (
Image.MAX_IMAGE_PIXELS = 120_000_000) sowie Bereichsvalidierung (1bis16.384px). - Pfadsicherheit & Path-Traversal-Schutz: Strikte Pfadauflösung via
pathlib.Path.resolve()und Isolierung von Dateinamen (Path(filename).name). - Atomare Dateispeicherung:
settings.jsonwird über temporäre Swap-Dateien mitfsyncatomar geschrieben und mit restriktiven Dateiberechtigungen geschützt. - URL- & Command-Sanitization: Browser-Aufrufe sind auf sichere HTTP(S)-Schemata beschränkt; Prozessbeendigung in
build.pyist gegen Befehlsinjektionen abgesichert.
Dieses Projekt ist unter der GNU General Public License v3.0 (GPLv3) lizenziert. Details finden Sie in der Datei LICENSE.