image-folder-watcher/README.md

Image Folder Watcher

Überwacht einen Ordner. Sobald ein Unterordner mit Bildern hineingeschoben wird, werden alle Bilder automatisch:

1. In einen Backup/-Unterordner kopiert (Originale bleiben erhalten)
2. Web-sicher umbenannt: <ordnername>-00.jpg, <ordnername>-01.jpg, … (Umlaute → ae/oe/ue/ss, Leerzeichen → -, alles klein)
3. Auf 1920 px Breite (proportional) und 72 DPI skaliert
4. Als JPEG unter 1 MB gehalten (Qualität wird bei Bedarf abgesenkt)

Unterstützte Formate: JPEG, PNG, WEBP, TIFF, BMP, GIF, AVIF, HEIC/HEIF.

Läuft auf macOS und Linux (gleiche Codebasis).

Installation

git clone git@git.datenhimmel.work:claude-ai/image-folder-watcher.git
cd image-folder-watcher
./install.sh

Das Script:

• prüft/installiert Python (Homebrew auf macOS, pacman/apt/dnf/zypper auf Linux),
• legt ein virtuelles Environment an (~/image-folder-watcher/.venv) und installiert Pillow, watchdog und pillow-heif darin – kein --break-system-packages nötig,
• erstellt den Überwachungsordner (~/Pictures/Eingang auf macOS, ~/Bilder/Eingang auf Linux),
• bietet optional Autostart an (launchd auf macOS, systemd auf Linux).

Eigenen Pfad festlegen:

WATCH_DIR="$HOME/mein/eingang" ./install.sh

Manuell starten

~/image-folder-watcher/.venv/bin/python ~/image-folder-watcher/watcher.py "<überwachter-ordner>"

Mit Optionen:

... watcher.py "<ordner>" --width 1920 --dpi 72 --format JPEG --quality 92 --delay 5

Option	Bedeutung	Standard
--width	Zielbreite in Pixel	1920
--dpi	Ziel-DPI	72
--format	Ausgabeformat (JPEG/PNG/WEBP)	JPEG
--quality	JPEG-Qualität (1–100)	92
--delay	Wartezeit bis Ordner als "fertig" gilt (s)	5

Bei Netzwerk-/SMB-Kopien (z. B. vom Mac auf einen Linux-Share) --delay höher setzen, damit das Tool wartet, bis wirklich alle Dateien angekommen sind.

Autostart

macOS (launchd):

launchctl print gui/$(id -u)/work.datenhimmel.image-watcher   # Status
launchctl bootout gui/$(id -u)/work.datenhimmel.image-watcher # Stoppen/Entfernen
tail -f ~/image-folder-watcher/watcher.out.log                # Logs

Linux (systemd):

sudo systemctl status image-watcher
journalctl -u image-watcher -f

Plattform-Hinweise

• macOS nutzt FSEvents, Linux nutzt inotify – watchdog wählt das automatisch.
• Auf macOS gibt es keine --break-system-packages-Problematik, weil alles im venv landet.
• Der systemd-Dienst läuft als System-Service unter deinem User; der launchd-Agent läuft als User-Agent (startet beim Login).