Skip to content

About

Effiziente Stapelverarbeitung zur Bildkomprimierung für Onlineshops und Webseiten. Reduziert Ladezeiten und spart Speicherplatz durch gezielte Qualitätsoptimierung und moderne WebP-Konvertierung – lokal, sicher und ohne externe API-Limits.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

🖼️ Bildbearbeitung & Image Optimizer Pro

Modernes, performantes Desktop-Tool zur Stapelkomprimierung, WebP-Konvertierung und Cloud-Optimierung.

Python License: GPL v3 CustomTkinter CI/CD Code Style Security


Bildbearbeitungstool Benutzeroberfläche

🌟 Highlights

  • ⚡ 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.

🎛️ Funktionsübersicht

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

🧩 Modulare Softwarearchitektur

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

🚀 Schnelleinstieg

1. Repository klonen & Virtual Environment anlegen

git clone https://github.com/<username>/<repository>.git
cd "Bild Berabeitung"

# Virtuelle Umgebung erstellen und aktivieren (Windows)
python -m venv venv
venv\Scripts\activate

2. Abhängigkeiten installieren

pip install -r requirements.txt

3. Anwendung starten

python main.py

⚙️ Konfiguration

Standardordner und der TinyPNG API-Key können entweder direkt in der GUI oder über Umgebungsvariablen hinterlegt werden:

# Beispiel-Umgebungsdatei kopieren
copy .env.example .env

Beispiel für .env:

TINYPNG_API_KEY=ihr_tinypng_api_key
COMP_SOURCE_DIR=Bilder_original
COMP_DEST_DIR=Bilder_komprimiert

Hinweis zur Sicherheit: Lokale Einstellungen (settings.json) und Umgebungsvariablen (.env) werden durch .gitignore automatisch vor der Versionskontrolle geschützt.


📦 Standalone Executable erstellen (.exe)

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-cython

Das fertige Paket wird im Ordner dist_<timestamp>/ erstellt.


🧪 Tests & Qualitätssicherung

# 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

🔒 Sicherheitsmerkmale

  • Zero Secret Leaks: Keine hardcodierten Zugangsdaten; strikte Isolation lokaler Einstellungen (settings.json, .env) via .gitignore und automatischer Ausschluss in sichern.py.
  • DoS- & Decompression-Schutz: Konfigurierte Obergrenzen für Pixeldimensionen (Image.MAX_IMAGE_PIXELS = 120_000_000) sowie Bereichsvalidierung (1 bis 16.384 px).
  • Pfadsicherheit & Path-Traversal-Schutz: Strikte Pfadauflösung via pathlib.Path.resolve() und Isolierung von Dateinamen (Path(filename).name).
  • Atomare Dateispeicherung: settings.json wird über temporäre Swap-Dateien mit fsync atomar geschrieben und mit restriktiven Dateiberechtigungen geschützt.
  • URL- & Command-Sanitization: Browser-Aufrufe sind auf sichere HTTP(S)-Schemata beschränkt; Prozessbeendigung in build.py ist gegen Befehlsinjektionen abgesichert.

📄 Lizenz & Urheberrecht

Dieses Projekt ist unter der GNU General Public License v3.0 (GPLv3) lizenziert. Details finden Sie in der Datei LICENSE.

© Agentur Schölzke

About

Effiziente Stapelverarbeitung zur Bildkomprimierung für Onlineshops und Webseiten. Reduziert Ladezeiten und spart Speicherplatz durch gezielte Qualitätsoptimierung und moderne WebP-Konvertierung – lokal, sicher und ohne externe API-Limits.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages