Musikdateien-Syncer
Bedienungsanleitung - Version 1.1

UNTERSTÜTZTE DATEITYPEN: MP3, MP4, WAV

1. Aufgabe der App
------------------
Der Musikdateien-Syncer gleicht ausschließlich MP3-, MP4- und WAV-Dateien zwischen zwei getrennten Ordnern ab. Unterordner werden vollständig berücksichtigt. Andere Dateitypen bleiben unangetastet.
Vor jeder Änderung zeigt die App eine Vorschau. Erst nach Ihrer ausdrücklichen Bestätigung werden die vorausgewählten Aktionen ausgeführt.

2. Die Vergleichsregel
----------------------
Existiert derselbe relative Dateipfad in beiden Ordnern, gewinnt immer die größere Datei. Sie ersetzt die kleinere Datei - auch dann, wenn die größere Datei ein älteres Änderungsdatum besitzt.
Eine kleinere Datei überschreibt niemals eine größere. Sind beide Dateien gleich groß, erfolgt kein Austausch. Ein neueres Datum allein reicht daher nicht zum Überschreiben.
Damit ist die Anforderung für neuere Dateien sicher erfüllt: Eine neuere Datei kann nur dann die ältere Gegenseite ersetzen, wenn sie zugleich größer ist.

3. Schritt für Schritt
----------------------
1. Wählen Sie links Ordner A und rechts Ordner B aus.
2. Klicken Sie auf 'Ordner einlesen'. Die App durchsucht beide Ordner samt Unterordnern.
3. Prüfen Sie oben die Liste 'Zu ersetzende Dateien'. Dort stehen Größenkonflikte und die vorgesehene Richtung.
4. Prüfen Sie unten 'Fehlt auf einer Seite'. Dort stehen Dateien, die nur in A oder nur in B vorhanden sind.
5. Entfernen Sie bei Bedarf einzelne Häkchen oder verwenden Sie 'Alle' und 'Keine'. Alle Vorschläge sind zunächst ausgewählt.
6. Klicken Sie auf 'Auswahl synchronisieren' und bestätigen Sie die Zusammenfassung. Erst jetzt beginnt der Kopiervorgang.
7. Nach Abschluss lesen Sie beide Ordner erneut ein. Bei vollständiger Übereinstimmung bleiben beide Listen leer.

4. Bedeutung der Spalten
------------------------
Auswahl: Bestimmt, ob die Aktion beim bestätigten Lauf ausgeführt wird.
Richtung: A nach B oder B nach A.
Dateiname: Name der Quelldatei einschließlich Erweiterung.
Pfad (relativ): Unterordner innerhalb des gewählten Stammordners.
Größe: Dateigröße der gewinnenden beziehungsweise fehlenden Quelle.
Angelegt: Datei-Anlagedatum der Quelle.
Geändert: Letztes Änderungsdatum der Quelle.
Bitrate: Von Windows gelieferte Audio-Bitrate, sofern verfügbar.
Begründung/Aktion: Warum ersetzt wird oder ob eine fehlende Datei kopiert wird.

5. Helle und dunkle Darstellung
-------------------------------
Über die Schaltfläche oben rechts wechseln Sie jederzeit zwischen 'Dunkel' und 'Hell'. Der Wechsel wirkt sofort auf das gesamte Hauptfenster.
Der Dark Mode umfasst Fensterrahmen, Karten, Eingabefelder, Tabellen, Rasterlinien, Auswahlzustände, Ladeanzeige sowie alle app-eigenen Hinweis-, Fehler- und Bestätigungsdialoge.
Die gewählte Darstellung wird automatisch gespeichert und beim nächsten Start wiederhergestellt. Windows-Ordnerauswahldialoge folgen der Darstellung des Betriebssystems.

6. Sicherheitsfunktionen
------------------------
Vorschaupflicht: Ohne aktuelle Vorschau kann keine Synchronisierung gestartet werden.
Bestätigung: Vor dem Kopieren erscheint eine Zusammenfassung der ausgewählten Aktionen.
Erneute Prüfung: Unmittelbar vor jedem Ersetzen kontrolliert die App nochmals, ob die Quelle weiterhin größer ist.
Sichere Übertragung: Jede Datei wird zuerst vollständig in eine temporäre Datei im Zielordner kopiert. Erst nach erfolgreicher Größenprüfung ersetzt sie das Ziel.
Zeitstempel: Anlage- und Änderungsdatum der Quelldatei werden auf die übertragene Datei übernommen.
Schutz vor Schleifen: Identische oder ineinander verschachtelte Stammordner werden abgewiesen. Verknüpfungsordner werden nicht verfolgt.

7. Hinweise
-----------
Die Bitrate wird aus den Windows-Medieneigenschaften gelesen. Wenn Windows für eine Datei keine Bitrate liefert, zeigt die App einen Gedankenstrich.
Gleichnamig bedeutet: gleicher relativer Pfad innerhalb von Ordner A und Ordner B. Dateien mit gleichem Namen in unterschiedlichen Unterordnern gelten als verschiedene Dateien.
Die App löscht keine Dateien. Fehlende Dateien werden kopiert; bestehende Dateien werden ausschließlich nach der Größenregel ersetzt.
Wenn Dateien während der Vorschau verändert, entfernt oder neu angelegt werden, kann die betroffene Aktion aus Sicherheitsgründen fehlschlagen. Lesen Sie die Ordner anschließend neu ein.
