Dir Sync bl  v2.1.2

Schnellstart

Es gibt zwei Wege, Dir Sync bl zu starten. Normaler Start ist die eigenständige DirSyncBL.exe — kein Python auf dem Zielsystem nötig, kein Konsolenfenster, startet und beendet sich am schnellsten und zuverlässigsten. Der Start über den Python-Quellcode (start.bat) ist die Alternative für Entwicklung oder wenn kein Build-Schritt gewünscht ist.

Normaler Start — DirSyncBL.exe empfohlen

1. Einmalig: EXE bauen
   build_exe.bat per Doppelklick starten (benötigt einmalig Python 3.10+, siehe Systemvoraussetzungen). Installiert automatisch alle Abhängigkeiten sowie PyInstaller und erzeugt dist\DirSyncBL.exe. Dauert 1–3 Minuten.
2. dist\DirSyncBL.exe per Doppelklick starten
   Ab jetzt reicht das — auf diesem PC und jedem anderen Windows-PC, auch ganz ohne installiertes Python. Kein Konsolenfenster, kein Bootstrap-Schritt, sauberes Beenden.
3. Quell- und Zielordner wählen, synchronisieren
   Ordner über die 📁-Schaltfläche auswählen oder per Drag & Drop in die Felder ziehen, dann „⟳ Synchronisieren" klicken.

Alternative: direkt aus dem Python-Quellcode

Für Entwicklung oder wenn kein Build-Schritt gewünscht ist, lässt sich das Programm auch ohne vorherigen Build direkt aus dem mitgelieferten Quellcode starten — dafür mit einmaliger automatischer Paketinstallation beim allerersten Start.

1. Python installieren (einmalig, falls noch nicht vorhanden)
   https://www.python.org/downloads/ — Python 3.10 oder neuer herunterladen und installieren.
   ⚠ Wichtig: Beim Installer den Haken bei „Add Python to PATH" setzen!
2. start.bat per Doppelklick starten
   Beim allerersten Start erscheint ein kleines Einrichtungsfenster: Das Programm legt automatisch eine lokale Python-Umgebung (venv) an und installiert alle benötigten Pakete. Eine Internetverbindung ist dazu erforderlich.
   Ab dem zweiten Start entfällt dieser Schritt vollständig.
3. Quell- und Zielordner wählen, synchronisieren
   Ordner über die 📁-Schaltfläche auswählen oder per Drag & Drop in die Felder ziehen, dann „⟳ Synchronisieren" klicken.

Systemvoraussetzungen

Automatisch installierte Pakete

Ordnerstruktur

DirSyncBL/
├── DirSyncBL.py          Hauptprogramm (mit Konsolenfenster)
├── DirSyncBL.pyw         Hauptprogramm (kein Konsolenfenster) ← wird von start.bat genutzt
├── build_exe.bat         Baut dist\DirSyncBL.exe (normaler Start, einmalig ausführen)
├── DirSyncBL.spec        PyInstaller-Bauplan für build_exe.bat
├── start.bat             Programm aus dem Quellcode starten (Alternative, Doppelklick)
├── setup.bat             Manuelle Erstinstallation für den Quellcode-Weg (optional)
├── requirements.txt      Paketliste
├── icon.ico              Programm-Icon (wird beim ersten Start erzeugt)
├── README.md             Kurzanleitung
├── data/
│   ├── config.json       Alle Einstellungen (automatisch gespeichert)
│   └── sync.log          Vollständiges Protokoll aller Aktionen
├── venv/                 Lokale Python-Umgebung (nur Quellcode-Weg, nach erstem Start)
└── dist/
    └── DirSyncBL.exe     Eigenständige EXE (normaler Start, nach build_exe.bat)

Ordnerauswahl

Im oberen Bereich des Fensters befinden sich zwei Eingabefelder für Quelle (der Ordner, aus dem synchronisiert wird) und Ziel (der Ordner, in den synchronisiert wird).

Möglichkeiten zur Auswahl

• 📁-Schaltfläche rechts neben dem Feld → Ordner-Dialog öffnet sich
• Pfad direkt eintippen ins Textfeld
• Drag & Drop: Ordner aus dem Windows-Explorer in das Textfeld ziehen (erfordert tkinterdnd2)

Der zuletzt verwendete Pfad wird beim Beenden automatisch gespeichert und beim nächsten Start wiederhergestellt.

Synchronisierungs-Modi

Optionen

Filter (Ausschlüsse) NEU v1.4.0

Mit der Filter-Leiste können bestimmte Dateien und Ordner von Vergleich und Synchronisierung ausgeschlossen werden. Filter werden mit dem Job gespeichert.

Datei-Filter

Ausschlussmuster für Dateinamen — Semikolon als Trennzeichen.

Ordner-Filter

Ordnernamen oder -muster — der Ordner selbst und alle seine Inhalte werden übersprungen.

Wildcard-Zeichen

Symbolleiste

Die Fortschrittsleiste und die Statuszeile darunter zeigen den Fortschritt der laufenden Aktion sowie den Namen der aktuell verarbeiteten Datei.

Tab: Unterschiede

Nach einem Vergleich zeigt dieser Tab alle gefundenen Dateien in einer Tabelle — farblich nach Status markiert.

Farbkodierung

Spalten

Durch Klick auf eine Spaltenüberschrift wird die Liste nach dieser Spalte sortiert. Ein zweiter Klick kehrt die Sortierung um.

Unterhalb der Tabelle zeigt eine Zusammenfassung die Anzahl der Einträge pro Status und wie viele Dateien synchronisiert werden.

Tab: 🗂 Job-Verwaltung erweitert in v2.0.0

Hier lassen sich wiederverwendbare Jobs anlegen, speichern, laden und ausführen — mehrere Jobs können dabei gleichzeitig laufen bzw. Ordner überwachen. Ein Job speichert Quell-/Zielordner, Modus, Optionen und Filter unter einem Namen direkt im Programm (in data/config.json).

Unterschied zu Verlauf

• Job-Verwaltung — benannte, dauerhaft gespeicherte Jobs, die einzeln gestartet/gestoppt werden, parallel zueinander laufen können und optional als .dsync-Datei exportiert/importiert werden.
• Verlauf (Historie) — automatische Aufzeichnung vergangener Sync-Läufe (nur zum Nachschlagen/Wiederladen).

Übersichtstabelle

Schaltflächen

• ➕ Neu … — legt einen neuen Job über einen Dialog an (Name, Ordner, Modus, Optionen, Filter, Auto-Monitor)
• ✏ Bearbeiten … — bearbeitet den ausgewählten Job (auch per Doppelklick auf die Zeile)
• 📄 Duplizieren — kopiert den ausgewählten Job unter neuem Namen
• 🗑 Löschen — entfernt den Job (stoppt ihn zuerst, falls er gerade läuft oder überwacht)
• 📥 Aktuelle Felder als Job speichern … — übernimmt Quelle/Ziel/Modus/Filter aus dem Formular oben als neuen Job
• 📤 In Formular laden — lädt einen Job zurück in das Hauptformular (z. B. für einen manuellen Vergleich)
• 💾 Export … — speichert den ausgewählten Job als portable .dsync-Datei (z. B. zum Sichern oder zur Weitergabe an einen anderen Rechner) — ersetzt das frühere „Profil speichern"
• 📂 Import … — lädt eine .dsync-Datei als neuen Job — akzeptiert auch ältere, mit der früheren Profil-Funktion gespeicherte Dateien (das Dateiformat ist unverändert)
• ▶ Start — startet den ausgewählten Job: bei normalen Jobs ein einmaliger Vergleich + Sync, bei Auto-Monitor-Jobs die dauerhafte Überwachung. Mehrere Jobs können gleichzeitig gestartet werden.
• ⏹ Stop — stoppt den laufenden Job bzw. dessen Überwachung

Mehrere Jobs gleichzeitig

Jeder gestartete Job läuft in einem eigenen Hintergrund-Thread. Es können beliebig viele Jobs parallel synchronisieren oder überwachen — die Übersichtstabelle zeigt den Status jedes Jobs live an. Abgeschlossene Job-Läufe erscheinen zusätzlich im Tab „Verlauf (Historie)".

Voraussetzung für Auto-Monitor

Auto-Monitor je Job benötigt das Paket watchdog (wird beim ersten Start automatisch installiert, siehe Systemvoraussetzungen). Ohne watchdog bleibt die „Auto"-Spalte deaktiviert.

Tab: Protokoll

Das Protokoll zeigt alle Aktionen des Programms in Echtzeit — mit Zeitstempel und farblicher Markierung:

• ■ Rot — Fehler
• ■ Orange — Warnungen
• ■ Schwarz — Informationen und erfolgreiche Aktionen

Die Schaltflächen am unteren Rand des Tabs:

• Leeren — löscht die Anzeige (die Datei data/sync.log bleibt erhalten)
• Speichern… — exportiert das aktuelle Protokoll als .txt-Datei

Das vollständige Protokoll wird dauerhaft in data/sync.log geschrieben.

Tab: Verlauf (Historie)

Die letzten 100 Synchronisierungsjobs werden automatisch gespeichert und in diesem Tab angezeigt.

Einträge in Grün = erfolgreich, in Rot = mit Fehler.

Schaltflächen

• Job laden — Stellt Quell-/Zielordner und Modus des ausgewählten Eintrags wieder her
• Verlauf löschen — Löscht den gesamten Verlauf unwiderruflich

Auto-Monitor

Der Auto-Monitor überwacht einen Quellordner kontinuierlich im Hintergrund und löst automatisch eine Synchronisierung aus, wenn Änderungen erkannt werden.

Aktivieren

1. Job im Tab 🗂 Job-Verwaltung anlegen (Quelle, Ziel, Modus, Optionen)
2. Häkchen in der Spalte Auto für diesen Job setzen — per Klick in der Übersicht, oder im Job-Dialog die Checkbox „Auto-Monitor (dauerhaft überwachen)" aktivieren
3. Status in der Übersicht wechselt auf ● Überwacht

Verhalten

• Erkennt neue, geänderte und gelöschte Dateien im Quellordner des jeweiligen Jobs
• Wartet 2,5 Sekunden nach der letzten Änderung, bevor synchronisiert wird (verhindert unnötige Syncs bei schnellen Änderungsfolgen)
• Unterordner werden immer überwacht, unabhängig von der Option „Unterordner"
• Bleibt nach einem Neustart des Programms aktiv (auch beim Windows-Autostart, siehe „Programmstart")

Speicherprüfung

Sobald ein Zielordner eingetragen ist, zeigt das Programm unterhalb der Ordnerfelder den freien und belegten Speicherplatz des Ziel-Laufwerks:

• ■ Grün — genug Platz vorhanden (unter 75 % belegt)
• ■ Orange — Laufwerk zu über 75 % belegt
• ■ Rot — Laufwerk zu über 90 % belegt

Vor jeder Synchronisierung wird außerdem geprüft, ob genug Platz für alle zu kopierenden Dateien vorhanden ist. Reicht der Platz nicht aus, wird die Synchronisierung mit einer Fehlermeldung abgebrochen.

Einstellungen

Öffnen über ⚙ Einstellungen in der Symbolleiste. Alle Änderungen werden sofort angewendet und dauerhaft in data/config.json gespeichert.

Der Dialog ist in fünf Tabs gegliedert:

🎨 Farben

Folgende Farben sind einzeln anpassbar — Klick auf den farbigen Button öffnet den Windows-Farbauswahl-Dialog:

• Fensterhintergrund und Textfarbe
• Farbmarkierungen für die vier Differenz-Status (Nur Quelle, Nur Ziel, Geändert, Identisch)

Die Schaltfläche „Standard" setzt alle Einstellungen auf die Werkseinstellungen zurück.

🔤 Schrift

• Schriftgröße: 6 bis 22 pt — mit Live-Vorschau
• Schriftart: Segoe UI, Arial, Calibri, Tahoma, Verdana, Courier New, Consolas, Lucida Console

⚙ Verhalten

🔍 Filter

Legt die Standard-Vorgaben für neue Sitzungen und Jobs fest:

• Dateien: Standardmäßig ausgeschlossene Dateimuster (z. B. *.tmp;*.bak;Thumbs.db)
• Ordner: Standardmäßig ausgeschlossene Ordnermuster (z. B. .git;__pycache__)
• Standard-Sync-Modus: Neu/Geändert, Spiegel oder Bidirektional
• Unterordner: Ob Unterordner standardmäßig einbezogen werden

Diese Werte werden beim nächsten Programmstart übernommen. Laufende Einstellungen im Hauptfenster bleiben unberührt.

📋 Log & Verlauf

Programmstart (Autostart) NEU v1.6.0

Über ⚙ Einstellungen ▸ Verhalten ▸ „Programmstart" lässt sich festlegen, ob Dir Sync bl automatisch mit Windows startet und ob das Fenster dabei minimiert bleibt.

Mit Windows starten

Legt eine kleine Startdatei DirSyncBL_autostart.bat im Windows-Autostart-Ordner des aktuellen Benutzers an:

%APPDATA%\Microsoft\Windows\Start Menu\Programs\Startup\DirSyncBL_autostart.bat

Diese Datei wechselt beim Anmelden lediglich in den Programmordner und ruft start.bat auf — also den Python-Quellcode-Weg (inkl. automatischer venv-Erkennung), unabhängig davon, ob im Alltag sonst DirSyncBL.exe verwendet wird. Beim Deaktivieren der Option wird die Datei wieder entfernt.

Fenster minimiert starten

Gilt für jeden Programmstart, nicht nur den Windows-Autostart — auch beim manuellen Doppelklick startet das Fenster dann minimiert in der Taskleiste.

Typische Kombination

Für einen unauffälligen Hintergrunddienst: „Mit Windows starten" und „Fenster minimiert starten" zusammen aktivieren, zusätzlich die gewünschten Jobs im Tab „Job-Verwaltung" mit dem Häkchen „Auto" versehen. Nach dem nächsten Windows-Start läuft die Überwachung dann automatisch an, ohne das Fenster in den Vordergrund zu holen.

In den Systray minimieren NEU v2.1.0

Bis einschließlich v2.0.4 legte Dir Sync bl bewusst kein Systray-Icon an — „minimiert" bedeutete minimiert in der Windows-Taskleiste, nicht versteckt. Ab v2.1.0 ist das über die zusätzliche Checkbox „In den Systray minimieren" optional aktivierbar (Standard: aus, bestehende Konfigurationen verhalten sich unverändert).

Ist die Option aktiv, verschwindet das Fenster beim Minimieren (Fenster-Button oder in Kombination mit „Fenster minimiert starten") nicht in die Taskleiste, sondern in ein Symbol im Windows-Infobereich (Systray, unten rechts neben der Uhr). Von dort aus:

• Doppelklick auf das Symbol oder Rechtsklick ▸ „Öffnen" blendet das Fenster wieder ein.
• Rechtsklick ▸ „Beenden" beendet das Programm vollständig — inklusive der gleichen Sicherheitsabfrage wie beim [X], falls gerade etwas läuft (siehe Beenden).

Als Auto-Monitor markierte Jobs (Tab „🗂 Job-Verwaltung") laufen dabei unabhängig vom Fensterzustand unverändert im Hintergrund weiter.

Beenden

Ein Klick auf das [X] in der Titelleiste beendet das Programm immer direkt und vollständig — das gilt unabhängig davon, ob „In den Systray minimieren" aktiv ist: es gibt kein „Schließen in den Tray", nur das Minimieren kann optional über den Systray laufen (siehe oben).

• Alle Einstellungen (Ordner, Modus, Filter, Fenstergröße und -position) werden automatisch gespeichert.
• Falls gerade eine Aktion (Vergleich oder Synchronisierung) läuft, erscheint eine Sicherheitsabfrage — auch beim Beenden über das Tray-Menü „Beenden".
• Ohne aktivierte Systray-Option läuft das Programm nach dem Schließen nicht im Hintergrund weiter, wie bisher.

Gespeicherte Dateien

Fehlerbehebung

„Python wurde nicht gefunden"

Python ist nicht installiert oder nicht im PATH. Lösung: Python 3.10+ von python.org herunterladen. Beim Installer unbedingt „Add Python to PATH" aktivieren. Danach start.bat erneut starten.

Pakete können nicht installiert werden

Internetverbindung prüfen. Firewall oder Proxy kann die Installation blockieren. setup.bat als Administrator ausführen kann helfen. Das Programm startet auch ohne optionale Pakete — mit eingeschränkten Funktionen.

Drag & Drop funktioniert nicht

tkinterdnd2 konnte nicht installiert werden. Ordner über die 📁-Schaltfläche oder durch direktes Eintippen des Pfades angeben.

Speicheranzeige fehlt / Auto-Monitor nicht verfügbar

psutil bzw. watchdog fehlt. setup.bat erneut ausführen oder manuell installieren:

venv\Scripts\pip install psutil watchdog

Kein Icon in der Titelleiste

Pillow fehlt. setup.bat erneut ausführen. Das Programm arbeitet ohne Icon vollständig normal.

Oberfläche wirkt klassisch statt modern

sv-ttk konnte nicht installiert werden. setup.bat erneut ausführen oder manuell installieren:

venv\Scripts\pip install sv-ttk

Das Programm funktioniert auch ohne modernes Theme uneingeschränkt.

„In den Systray minimieren" ist ausgegraut

pystray konnte nicht installiert werden. setup.bat erneut ausführen oder manuell installieren:

venv\Scripts\pip install pystray

Das Programm funktioniert auch ohne diese Option uneingeschränkt — Minimieren geht dann wie gewohnt in die Taskleiste.

Filter schließen zu viel / zu wenig aus

Muster prüfen: Wildcards * und ? beachten. Groß-/Kleinschreibung bei Dateinamen prüfen (Windows ist nicht case-sensitiv, das Programm vergleicht den tatsächlichen Dateinamen). Im Protokoll-Tab wird die Anzahl gefilterter Einträge angezeigt.

Synchronisierung mit Fehlern abgebrochen

Protokoll-Tab öffnen — rote Einträge zeigen den genauen Fehler. Häufige Ursachen: Datei von anderem Programm gesperrt, fehlende Schreibrechte, Speicherplatz erschöpft.

Versionshistorie