Fehlerbehebung

Dieser Leitfaden hilft dir, häufige Probleme mit FloSync zu erkennen und zu beheben. Falls dein Problem hier nicht aufgeführt ist, wirf einen Blick in die FAQ oder wende dich an den Support.

Diagnose-Logs #

FloSync schreibt detaillierte Protokolle mit, die bei der Fehlersuche eine große Hilfe sind. Damit lässt sich nachvollziehen, was während einer Session passiert ist — ob für die eigene Analyse oder im Austausch mit dem Support.

Logs öffnen #

Über das Menü:

• macOS: Hilfe > Protokollordner öffnen
• Windows: Hilfe > Protokollordner öffnen

Manueller Pfad:

• macOS: ~/Library/Application Support/FloSync/logs/
• Windows: %APPDATA%/FloSync/logs/

Log-Struktur #

Die Logs sind nach Datum und Stunde gegliedert:

logs/
├── 2026-01-19/
│   ├── 00.log    (Mitternacht bis 1 Uhr)
│   ├── 01.log    (1 bis 2 Uhr)
│   ├── ...
│   └── 23.log    (23 Uhr bis Mitternacht)
├── 2026-01-18/
│   └── ...

Aufbewahrung #

Logs werden 7 Tage lang aufbewahrt und beim Start von FloSync automatisch bereinigt. So steht genügend Historie für die Fehlersuche zur Verfügung, ohne unnötig Speicherplatz zu belegen.

Inhalt der Logs #

Die Logs enthalten zeitgestempelte Einträge zu:

• App-Start und -Beendigung
• Laden und Wiedergabe von Videos
• Sync-Ereignisse und -Korrekturen
• Netzwerk-Sync-Verbindungen und -Trennungen
• Szenenübergänge bei geplanter Wiedergabe
• Fehler und Warnungen

Logs zur Fehlersuche verwenden #

1. Problem reproduzieren — Notiere die ungefähre Uhrzeit, zu der das Problem aufgetreten ist
2. Log-Ordner öffnen — Über Hilfe > Protokollordner öffnen
3. Passende Datei auswählen — Öffne im Datumsordner die Log-Datei der entsprechenden Stunde
4. Nach Fehlern suchen — Halte Ausschau nach Einträgen mit „ERROR" oder „WARN"
5. Kontext lesen — Lies die Einträge vor und nach dem Fehler, um den Zusammenhang zu verstehen

Wenn du den Support kontaktierst, lege die relevanten Log-Dateien bei — das beschleunigt die Diagnose erheblich.

Probleme beim Laden von Inhalten #

Bild lädt nicht #

Symptome: Ein Bild lässt sich nicht per Drag-and-Drop in FloSync laden, oder es erscheint eine Fehlermeldung.

Mögliche Ursachen und Lösungen:

1. Nicht unterstütztes Format

   • Unterstützte Formate: PNG, JPG/JPEG, GIF, BMP, TIFF, WebP, SVG
   • Prüfe, ob die Datei intakt ist, indem du sie in einem anderen Bildbetrachter öffnest

2. Fehlende Zugriffsrechte

   • Stelle sicher, dass du Lesezugriff auf die Datei hast
   • Liegt die Datei auf einer Netzwerkfreigabe, kopiere sie auf ein lokales Laufwerk

3. SVG-Einschränkungen

   • Komplexere SVG-Funktionen werden unter Umständen nicht korrekt dargestellt
   • Konvertiere die Datei in PNG, falls das SVG nicht richtig angezeigt wird

Webseite lädt nicht #

Symptome: Die Webseite zeigt nur eine leere Fläche oder eine Fehlermeldung.

Mögliche Ursachen und Lösungen:

1. HTTP vs. HTTPS

   • Es werden ausschließlich HTTPS-URLs unterstützt (kein HTTP)
   • Stelle sicher, dass deine URL mit https:// beginnt

2. Netzwerkverbindung

   • Stelle sicher, dass eine Internetverbindung besteht
   • Prüfe, ob die Seite in einem normalen Browser erreichbar ist

3. Einbettung durch Website blockiert

   • Manche Websites verhindern die Einbettung in WebViews
   • Verwende eine andere Seite oder eine lokale HTML-Datei

Probleme bei der Videowiedergabe #

Video lädt nicht #

Symptome: Ein Video lässt sich nicht per Drag-and-Drop in FloSync laden, oder es erscheint eine Fehlermeldung.

Mögliche Ursachen und Lösungen:

1. Nicht unterstütztes Format

   • Konvertiere das Video in MP4 (H.264) — siehe Video-Codec-Empfehlungen weiter unten
   • Prüfe, ob die Datei intakt ist, indem du sie in einem anderen Player abspielst

2. Fehlende Codecs

   • FloSync bringt die gängigsten Codecs mit, einige proprietäre Formate werden jedoch nicht unterstützt
   • Konvertiere in ein Standardformat wie MP4

3. Fehlende Zugriffsrechte

   • Stelle sicher, dass du Lesezugriff auf die Datei hast
   • Liegt die Datei auf einer Netzwerkfreigabe, kopiere sie auf ein lokales Laufwerk

Video ruckelt oder verliert Frames #

Symptome: Die Wiedergabe läuft ungleichmäßig oder nicht flüssig.

Lösungen:

1. CPU-/GPU-Auslastung prüfen — Ist die Auslastung am Anschlag, reicht die Hardware für die gewählte Auflösung nicht aus
2. SSD-Speicher verwenden — Herkömmliche Festplatten sind für hohe Bitraten oft zu langsam
3. Auflösung reduzieren — Kodiere das Video in niedrigerer Auflösung neu, wenn die Hardware nicht mitkommt
4. Andere Anwendungen schließen — Damit stehen mehr Systemressourcen zur Verfügung
5. Sync-Toleranz prüfen — Bei aktivem Sync die Toleranz erhöhen, um die Zahl der Korrekturen zu verringern

Bildschirm-Probleme #

Zweiter Bildschirm wird nicht erkannt #

Symptome: FloSync zeigt nur einen Bildschirm an, obwohl mehrere angeschlossen sind.

Lösungen:

1. Anzeigeeinstellungen des Betriebssystems prüfen

   • macOS: Systemeinstellungen > Displays
   • Windows: Einstellungen > System > Display
   • Stelle sicher, dass alle Bildschirme vom Betriebssystem erkannt werden

2. Kabelverbindungen prüfen

   • Teste andere Kabel
   • Verwende andere Anschlüsse am Computer

3. FloSync neu starten, nachdem neue Bildschirme angeschlossen wurden

   • FloSync erkennt Bildschirme beim Start

Bildschirmanordnung stimmt nicht #

Symptome: Im Modus „Übergreifend" erscheinen Videoabschnitte auf den falschen Bildschirmen.

Lösungen:

1. Bildschirmanordnung im Betriebssystem konfigurieren

   • macOS: Systemeinstellungen > Displays > Arrange
   • Windows: Einstellungen > System > Display (Bildschirme per Drag-and-Drop anordnen)
   • Die virtuelle Anordnung muss dem physischen Aufbau entsprechen

2. FloSync neu starten, nachdem die Anordnung geändert wurde

Sync-Probleme #

Lokale Bildschirme laufen nicht synchron #

Symptome: In den Modi „Gespiegelt" oder „Übergreifend" zeigen die Bildschirme unterschiedliche Frames.

Lösungen:

1. Automatische Korrektur abwarten — FloSync gleicht dauerhafte Drift selbständig aus
2. Statusleiste beachten — Im Live-Modus zeigt der Zähler für Sync-Korrekturen an, wie oft korrigiert wurde:
   • Niedrige Werte sind bei langen Sessions normal
   • Wiederholte oder schnell steigende Werte deuten auf ein Problem im Setup hin
3. Sync-Toleranz verringern — In den Einstellungen eine engere Toleranz einstellen
4. Sync-Log prüfen — Halte Ausschau nach Drift-Warnungen und Korrekturen
5. Wiedergabe neu starten — Pausieren und erneut abspielen

Netzwerk-Sync funktioniert nicht #

Symptome: Der Client findet den Server nicht, oder der Sync funktioniert nach dem Verbinden nicht.

Lösungen:

1. Gemeinsames Netzwerk sicherstellen

   • Beide Computer müssen sich im selben lokalen Netzwerk befinden
   • Zur Kontrolle einen Ping zwischen den Geräten ausführen

2. Gleiche Videodatei verwenden

   • Auf allen Clients muss dasselbe Video geladen sein
   • Unterschiedliche Videolängen führen zu Sync-Fehlern

3. Firewall prüfen

   • FloSync auf beiden Rechnern in der Firewall freigeben
   • UDP-Port 9201 zulassen

4. Server-Status prüfen

   • Das Server-Symbol (Turm) in der oberen Leiste muss grün leuchten
   • In der Statusleiste sollte „Server" stehen
   • Klicke auf das Symbol, um den Server-Modus kurz zu beenden und neu zu starten

5. Einschwingphase abwarten

   • Der Netzwerk-Sync braucht nach dem Verbinden einen kurzen Moment zum Einpendeln
   • Erste Korrekturen sind dabei völlig normal
   • Sobald sich der Sync stabilisiert hat, läuft die Wiedergabe stabil und visuell synchron

Schleichende Sync-Drift nach tagelangem Betrieb #

Symptome: Der Netzwerk-Sync lief einwandfrei, doch nach mehreren Tagen Dauerbetrieb liegt der Client dauerhaft 50–100 ms daneben und korrigiert sich nicht mehr vollständig.

Ursache: Die Systemuhr jedes Computers driftet aufgrund von Oszillator-Toleranzen und Temperaturschwankungen mit leicht unterschiedlicher Geschwindigkeit. Nach Tagen ununterbrochener Laufzeit kann sich diese Drift so weit aufschaukeln, dass eine Echtzeitkorrektur sie nicht mehr ausgleichen kann. Das betrifft alle uhrenbasierten Synchronisationssysteme — nicht nur FloSync.

Lösung: Starte beide Computer neu. Bei unbeaufsichtigten Installationen empfiehlt sich ein täglicher Neustart außerhalb der Betriebszeiten — siehe Regelmäßige Neustarts einplanen im Leitfaden zur Sync-Optimierung.

Sync-Korrekturen verursachen Ruckler #

Symptome: Das Video springt oder ruckelt während der Wiedergabe auffällig häufig.

Lösungen:

1. Sync-Toleranz in den Einstellungen erhöhen
2. Netzwerkqualität prüfen (bei Netzwerk-Sync)
3. Systemlast reduzieren — unnötige Anwendungen schließen
4. Sync-Log auf wiederkehrende Muster prüfen

Go-Live-Probleme #

Vollbildfenster erscheinen nicht #

Symptome: Nach dem Klick auf „Live starten" öffnen sich keine Vollbildfenster auf den Bildschirmen.

Lösungen:

1. Bildschirmerkennung prüfen

   • Stelle sicher, dass deine Bildschirme erkannt wurden (sie müssen im Anordnungsbereich sichtbar sein)
   • Trenne die Bildschirme kurz und schließe sie erneut an
   • Starte FloSync nach dem Anschließen neuer Bildschirme neu

2. Videoladen prüfen

   • Vor dem „Live starten" muss mindestens ein Video geladen sein
   • Achte auf Hinweise zu fehlenden Videos

3. Berechtigungen prüfen

   • Unter macOS benötigt FloSync unter Umständen die Berechtigung zur Steuerung deines Computers (Systemeinstellungen > Datenschutz & Sicherheit > Bedienungshilfen)
   • Unter Windows FloSync als Administrator starten

ESC beendet den Live-Modus nicht #

Symptome: Die ESC-Taste auf einem Vollbildfenster beendet den Live-Modus nicht.

Lösungen:

1. Fenster fokussieren — Klicke zunächst auf das Vollbildfenster
2. Schaltfläche „Live stoppen" verwenden — Wechsle zurück zum Bedienfeld und klicke auf „Live stoppen"
3. Notfalls erzwingen — Cmd+Q (macOS) oder Alt+F4 (Windows) als letzten Ausweg nutzen

Anwendungs-Probleme #

FloSync startet nicht #

macOS-Lösungen:

1. Sicherheitseinstellungen

   • Rechtsklick auf FloSync und „Open" wählen
   • Oder: Systemeinstellungen > Datenschutz & Sicherheit > FloSync erlauben

2. Einstellungen zurücksetzen

   • Lösche: ~/Library/Application Support/com.tentekio.flosync/
   • Starte FloSync erneut

Windows-Lösungen:

1. Als Administrator ausführen

   • Rechtsklick auf FloSync > Run as administrator

2. Einstellungen zurücksetzen

   • Lösche: %APPDATA%\Tentekio\FloSync\
   • Starte FloSync erneut

3. Visual C++ Redistributable neu installieren

   • Lade die aktuelle Version von Microsoft herunter

Hohe CPU- oder Speicher-Auslastung #

Symptome: FloSync beansprucht übermäßig viele Systemressourcen.

Lösungen:

1. Zu erwarten — Videowiedergabe ist grundsätzlich ressourcenintensiv
2. Videoauflösung reduzieren — 1080p statt 4K verwenden, wenn die Maschine an ihre Grenzen kommt
3. Weniger Videos gleichzeitig abspielen — Im Modus „Unabhängig"
4. Sync-Log-Panel schließen — Das fortlaufende Protokollieren verbraucht etwas Ressourcen
5. Auf hängende Prozesse prüfen — FloSync neu starten, wenn die Auslastung nach dem Stoppen der Videos nicht zurückgeht

Video-Codec-Probleme #

Wenn du beim Netzwerk-Sync Drift oder ungleichmäßige Wiedergabe feststellst, kann der verwendete Video-Codec die Ursache sein.

Schnelle Abhilfe: Transkodiere dein Video in H.264 All-Intra — das liefert zuverlässige Sync-Leistung auf allen Plattformen. Als professionelle Alternativen eignen sich ProRes LT (macOS) und DNxHD (Windows).

Ausführliche Hinweise zu Videoformaten, empfohlenen Codecs, Testdateien und FFmpeg-Befehlen findest du im Leitfaden zur Videovorbereitung.

Bekannte Einschränkungen #

Aktuelle Limitierungen #

• Im Modus „Übergreifend" ist die Ausrichtung an den Bildschirmrändern nicht immer pixelgenau
• Netzwerk-Sync über WLAN ist weniger zuverlässig als über Kabel
• Manche DRM-geschützten Inhalte lassen sich nicht abspielen
• Sehr hohe Auflösungen (8K+) laufen nicht auf jeder Hardware flüssig
• Der Bildschirm-Modus lässt sich im Live-Modus nicht wechseln (zuerst den Live-Modus beenden)
• Webseiten können nicht über mehrere Bildschirme gespannt werden (im Modus „Übergreifend" werden sie gespiegelt)
• Für Webseiten werden ausschließlich HTTPS-URLs unterstützt (kein HTTP)
• Netzwerk-Sync funktioniert nur mit Videoinhalten (Bilder und Webseiten werden nicht synchronisiert)

Tipps für optimale Leistung #

• Verwende für den Netzwerk-Sync kabelgebundene Netzwerkverbindungen
• Speichere Inhaltsdateien auf lokalen Laufwerken (nicht auf Netzlaufwerken)
• Nutze über Sessions hinweg eine konsistente Bildschirm-Konfiguration
• Teste dein Setup vor wichtigen Präsentationen
• Wenn du Zeitpläne verwendest, teste Übergänge zunächst mit kurzen Szenen