Doku / Fehlerbehebung
Fehlerbehebung
Sie stoßen auf ein Problem? Unten finden Sie Lösungen für die häufigsten Probleme. Jede Karte behandelt ein bestimmtes Symptom und erklärt, wie Sie es beheben.
Berechtigungen
„BetterStage kann meine Fenster nicht steuern“
BetterStage benötigt die Berechtigung für Bedienungshilfen, um Fenster zu lesen und zu verschieben. Öffnen Sie Systemeinstellungen > Datenschutz & Sicherheit > Bedienungshilfen und vergewissern Sie sich, dass BetterStage aufgeführt und aktiviert ist. War es bereits aktiviert, schalten Sie es aus und wieder ein. Starten Sie BetterStage nach dem Ändern der Berechtigung neu. Wird die Berechtigung entzogen, während BetterStage läuft, weist Sie die App darauf hin und stellt ausgeblendete Fenster wieder her, statt sie außerhalb des Bildschirms zu lassen. Das Entziehen der Bedienungshilfen führt nicht mehr dazu, dass BetterStage Tastatur- oder Mauseingaben festhält. Ein erneutes Erteilen unterbricht keine laufende Wiederherstellung eines gespeicherten Arbeitsbereichs, der Kontinuität oder nach dem Ruhezustand.
„Kurzbefehle funktionieren nicht“
BetterStage verwendet für Tastaturkurzbefehle die native Carbon-Hotkey-API, daher ist keine Berechtigung für die Eingabeüberwachung nötig. Wenn Kurzbefehle nicht funktionieren, prüfen Sie zuerst, ob die Berechtigung für Bedienungshilfen aktiviert ist. Stellen Sie außerdem sicher, dass keine andere App dieselben Tastenkombinationen, Maustasten oder Trackpad-Gesten verwendet – kollidierende Kurzbefehle verhindern, dass BetterStage die Ereignisse empfängt. Belegen Sie Tastatur-, Maus- und Trackpad-Steuerungen unter Einstellungen > Kurzbefehle neu.
„Fenster werden nicht erkannt“
Die Fenstererkennung nutzt die Bedienungshilfen-API von macOS, die durch die Berechtigung für Bedienungshilfen abgedeckt ist. Stellen Sie sicher, dass sie unter Systemeinstellungen > Datenschutz & Sicherheit > Bedienungshilfen aktiviert ist. Beachten Sie, dass manche Apps nicht standardmäßige Fenstertypen verwenden (etwa schwebende Paletten oder eigene Chrome-Fenster), die von der Bedienungshilfen-API möglicherweise nicht erkannt werden.
Fensterverhalten
„Sollte ich BetterStage zusammen mit Stage Manager von macOS verwenden?“
Nein. Deaktivieren Sie Apples integrierten Stage Manager, bevor Sie BetterStage verwenden. Beide Tools steuern die Sichtbarkeit von Fenstern; laufen sie gleichzeitig, kann das zu verwirrenden Wechseln, ausgeblendeten Fenstern oder Fenstern an der falschen Stelle führen. Öffnen Sie Systemeinstellungen > Schreibtisch & Dock > Stage Manager, deaktivieren Sie Stage Manager und starten Sie BetterStage neu, falls der Arbeitsbereich danach noch falsch aussieht.
„Firefox-/Chrome-Fenster werden animiert, statt sofort einzurasten“
Manche Browser (Firefox, Chrome und Electron-basierte Apps) aktivieren ein Bedienungshilfen-Flag namens AXEnhancedUserInterface, durch das Fensterbewegungen animiert werden, statt sofort einzurasten. BetterStage erkennt dieses Flag bei betroffenen Apps automatisch und deaktiviert es. Sehen Sie trotzdem noch animierte Bewegungen, beenden Sie den Browser und öffnen Sie ihn erneut, damit BetterStage die Korrektur wieder anwenden kann.
„Firefox-Fenster flackern, lassen sich schlecht platzieren oder hinken Stage-Wechseln hinterher“
Firefox verwaltet seine Fenster auf nicht standardmäßige Weise und arbeitet daher nicht immer reibungslos mit Fensterverwaltung zusammen – Fenster können kurz aufflackern, sich einer genauen Platzierung widersetzen oder Stage-Wechseln hinterherhinken. Das ist ein bekanntes Problem, und wir verbessern die Kompatibilität mit Firefox weiter.
„Der Finder erscheint beim Wechsel zu einer leeren Stage“
macOS kann den Finder aktivieren, wenn die App im Vordergrund keine sichtbaren Fenster hat. BetterStage 2.2.0 blendet einzelne Fenster in einem privaten Space aus, statt die gesamte App auszublenden. Erscheint auf einer leeren Stage unerwartet ein Fenster, melden Sie uns den Namen der App und die Abfolge der Stage- oder Schreibtischwechsel, die es ausgelöst hat.
„Fenster sind nach dem Ruhezustand oder Bildschirmschoner in der falschen Stage“
Warten Sie, bis sich die Display-Anordnung stabilisiert hat. Das Layout eines bekannten Displays kehrt von selbst zurück; erscheint ein Wiederherstellungshinweis, wählen Sie „Arbeitsbereich wiederherstellen“ oder „Aktuelles Layout beibehalten“. Für Fenster, die nach dem Entfernen eines Schreibtischs ausgeblendet bleiben oder nach einer Display-Änderung außerhalb des Bildschirms gelandet sind, verwenden Sie Fenster retten in der Menüleiste. Meldet BetterStage, dass macOS Spaces nicht verfügbar sind, schließen Sie den Schreibtischwechsel ab und wählen Sie „Erneut versuchen“. Besteht das Problem weiter, starten Sie BetterStage neu.
„Ein Dialog oder schwebendes Fenster hängt hinter TabStack fest“
Öffnen Sie das Snap-Rad und wählen Sie unter „Weitere Aktionen“ Schwebende Fenster nach vorne holen. Damit holen Sie schwebende und nicht erfasste Fenster auf diesem Monitor nach vorne, ohne das Layout zu ändern oder ausgeblendete Tabs einzublenden. „Fenster retten“ stellt außerdem Fenster wieder her, die BetterStage in privaten Spaces ausgeblendet hat – auch solche, deren ursprünglicher Schreibtisch entfernt wurde.
„Nach einem Absturz fehlen Fenster“
BetterStage protokolliert, welche Fenster in private Spaces verschoben wurden, und betreibt einen separaten Wiederherstellungshelfer. Wird BetterStage unerwartet beendet, bringt der Helfer ausgeblendete Fenster anhand dieser Aufzeichnungen auf ihre gespeicherten Schreibtische zurück. Fehlen danach noch Fenster, starten Sie BetterStage erneut und verwenden Sie „Fenster retten“. Bei einem entfernten Schreibtisch oder getrennten Display ist möglicherweise ein erreichbares Ersatzziel erforderlich.
App-Konfiguration
„Start aus dem Terminal vs. .app-Bundle“
Wenn Sie BetterStage per swift run im Terminal starten, ordnet macOS die Berechtigung für Bedienungshilfen Ihrer Terminal-App statt BetterStage selbst zu. Damit die Berechtigung korrekt funktioniert und BetterStage in den Systemeinstellungen mit seinem Namen erscheint, erstellen und starten Sie stattdessen das .app-Bundle.
„Die Stage-Leiste erscheint nicht“
Die Stage-Leiste lässt sich über den aktiven Rand (Zeiger an den oberen Bildschirmrand bewegen) oder mit dem Tastaturkurzbefehl Opt+Up Arrow öffnen. Vergewissern Sie sich, dass der aktive Rand in den Einstellungen aktiviert ist. Erscheint die Stage-Leiste weiterhin nicht, prüfen Sie, ob BetterStage die erforderliche Berechtigung für Bedienungshilfen hat.
Auf integrierten Mac-Displays mit Notch kann Einstellungen > Stages > Stage-Leiste > Display-Aussparung vermeiden die Notch selbst aussparen, während der Rest des oberen Rands aktiv bleibt.
„Monitor wird nach dem erneuten Verbinden nicht erkannt“
BetterStage erkennt Monitore anhand von Hardwaremerkmalen wie Modell und Seriennummer, nicht nur anhand der Display-ID, die macOS vergibt. In seltenen Fällen, etwa nach einem Treiber-Update oder mit einem anderen Anschluss oder Adapter, ändern sich diese Merkmale. Trennen Sie den Monitor und verbinden Sie ihn erneut, und starten Sie dann BetterStage neu. Wird der Monitor weiterhin nicht erkannt, konfigurieren Sie ihn unter Einstellungen > Displays neu.
„⌘Tab zeigt weiterhin den App-Umschalter von macOS“
Der ⌘Tab-Umschalter von BetterStage ist optional und standardmäßig ausgeschaltet. Aktivieren Sie BetterStage ⌘Tab verwenden unter Einstellungen > ⌘Tab-Umschalter und stellen Sie sicher, dass Pro, die Testversion oder eine tägliche Pro-Vorschau aktiv ist. Ohne Vorschauen zeigt er App-Symbole; erlauben Sie die Bildschirmaufnahme für Live-Miniaturen. Siehe die Anleitung zum ⌘Tab-Umschalter.
„Meine Stages werden nach der Rückkehr zu 2.0.x nicht geladen“
Von BetterStage 2.2 gespeicherte Stages lassen sich mit früheren Versionen nicht öffnen. Wenn Sie 2.0.x neu installiert haben, werden Ihre Stages nicht geladen; aktualisieren Sie stattdessen über die Download-Seite auf die neueste Version.
Einen Fehler melden
BetterStage führt ein fortlaufendes Diagnoseprotokoll, das auf 10 MB begrenzt ist, damit es nie Ihren Speicher füllt. Um es einem Fehlerbericht beizufügen, klicken Sie auf das BetterStage-Symbol in der Menüleiste und wählen Sie Diagnoseprotokoll anzeigen… – der Finder zeigt die Protokolldatei, sodass Sie sie in eine Discord-Nachricht, ein GitHub-Issue oder eine E-Mail ziehen können.
Release-Builds verzichten auf ausführliche Protokollierung, die Fenstertitel erfassen würde. Wenn Sie ein Problem nachstellen und eine detailliertere Aufzeichnung möchten, verwenden Sie einen Beta- oder Release-Candidate-Build, erfassen Sie das Protokoll und kehren Sie danach zum Release-Kanal zurück.
Brauchen Sie noch Hilfe?
Wenn Ihr Problem oben nicht behandelt wird, melden Sie sich bei uns – wir helfen Ihnen, alles zum Laufen zu bringen.