Fehlerbehebung

Häufige Probleme und ihre Lösungen für MouseCross.

Installationsprobleme

Windows: Warnung „Windows hat Ihren PC geschützt"

Symptom: Windows SmartScreen blockiert die Ausführung von MouseCross.

Lösung:

  1. Klicken Sie auf „Weitere Informationen" im Warndialog
  2. Klicken Sie auf „Trotzdem ausführen"
  3. MouseCross wird normal gestartet

Warum es passiert: Unsignierte Anwendungen lösen SmartScreen aus. Signierte Versionen (bald verfügbar) zeigen diese Warnung nicht an.

macOS: „App ist beschädigt und kann nicht geöffnet werden"

Symptom: macOS Gatekeeper verhindert den Start von MouseCross.

Lösung:

xattr -cr /Applications/MouseCross.app

Starten Sie dann MouseCross erneut.

Alternative Lösung:

  1. Rechtsklick (oder Strg+Klick) auf MouseCross in Programme
  2. Wählen Sie „Öffnen"
  3. Klicken Sie im Bestätigungsdialog auf „Öffnen"

macOS: „Barrierefreiheits-Berechtigungen erforderlich"

Symptom: Fadenkreuz erscheint nicht oder verfolgt keine Mausbewegung.

Lösung:

  1. Systemeinstellungen öffnen
  2. Zu Datenschutz & Sicherheit → Bedienungshilfen gehen
  3. MouseCross in der Liste aktivieren
  4. Falls MouseCross nicht aufgeführt ist, auf die Schaltfläche „+" klicken und hinzufügen
  5. MouseCross neu starten

Berechtigungen überprüfen:

  1. Systemeinstellungen → Datenschutz & Sicherheit → Bedienungshilfen öffnen
  2. MouseCross sollte aufgeführt und mit einem Häkchen versehen sein
  3. Falls ausgegraut, versuchen Sie, es zu entfernen und erneut hinzuzufügen

Fadenkreuz-Anzeigeprobleme

Fadenkreuz nicht sichtbar

Mögliche Ursachen und Lösungen:

1. Fadenkreuz ist deaktiviert

  • Drücken Sie Strg+Alt+Umschalt+C, um es einzuschalten
  • Überprüfen Sie Taskleiste/Menüleiste - Symbol sollte Status „Aktiv" zeigen
  • Überprüfen Sie, ob „Beim Start aktivieren" in den Einstellungen aktiviert ist

2. Deckkraft zu niedrig

  • Einstellungen öffnen
  • Deckkraft-Schieberegler überprüfen - sollte mindestens 50% sein
  • Deckkraft auf 80-100% zum Testen erhöhen

3. Farbe passt zum Hintergrund

  • Einstellungen öffnen
  • Versuchen Sie eine kontrastreiche Farbe (hellrot, cyan, lindgrün)
  • Oder aktivieren Sie den Invertierten Modus für automatischen Kontrast

4. Windows: Desktop Window Manager läuft nicht

  • Drücken Sie Windows+R
  • Geben Sie services.msc ein und drücken Sie Eingabetaste
  • Suchen Sie „Desktop Window Manager Session Manager"
  • Stellen Sie sicher, dass er läuft und auf Automatisch gesetzt ist

5. macOS: Barrierefreiheits-Berechtigungen fehlen

  • Siehe „Barrierefreiheits-Berechtigungen erforderlich" oben

Fadenkreuz erscheint, bewegt sich aber nicht

Windows:

  1. Überprüfen Sie, ob keine anderen Overlay-Anwendungen stören
  2. Überprüfen Sie, ob Maustreiber aktuell sind
  3. Versuchen Sie, als Administrator auszuführen (Rechtsklick → Als Administrator ausführen)

macOS:

  1. Überprüfen Sie, ob Barrierefreiheits-Berechtigungen erteilt wurden
  2. Überprüfen Sie die Konsolen-App auf Fehlermeldungen
  3. MouseCross neu starten

Fadenkreuz flackert oder ruckelt

Windows:

  • Grafiktreiber aktualisieren
  • Überprüfen Sie, ob Windows im Energiesparmodus ist (deaktivieren Sie ihn)
  • Überprüfen Sie, ob DWM (Desktop Window Manager) aktiviert ist
  • Schließen Sie andere Overlay-Anwendungen (Discord-Overlay, OBS usw.)

macOS:

  • Überprüfen Sie die Aktivitätsanzeige auf hohe CPU-Auslastung durch andere Apps
  • Aktualisieren Sie macOS auf die neueste Version
  • Versuchen Sie, die Deckkraft leicht zu reduzieren

Fadenkreuz verschwindet bei bestimmten Anwendungen

Windows: Einige Vollbildanwendungen oder Spiele können Overlays verhindern:

  • Versuchen Sie, die Anwendung im Fenstermodus auszuführen
  • Versuchen Sie, MouseCross als Administrator auszuführen
  • Einige Spiele mit Anti-Cheat können Overlays blockieren (dies ist zu erwarten)

macOS: Einige Vollbild-Apps können das Overlay ausblenden:

  • Verwenden Sie die App stattdessen im Fenstermodus
  • Überprüfen Sie, ob die App eigene Barrierefreiheitseinschränkungen hat

Einstellungsprobleme

Einstellungen werden nicht gespeichert

Windows:

  • Stellen Sie sicher, dass Sie auf „Übernehmen" oder „OK" klicken (nicht nur den Dialog schließen)
  • Überprüfen Sie die Registry-Berechtigungen für HKEY_CURRENT_USER\Software\MouseCross
  • Versuchen Sie, einmal als Administrator auszuführen, um Registry-Schlüssel zu erstellen

macOS:

  • Klicken Sie auf „OK" zum Speichern (nicht nur das Fenster schließen)
  • Überprüfen Sie die Konsole auf UserDefaults-Fehler
  • Überprüfen Sie, ob die Festplattenberechtigungen korrekt sind

Tastenkombination kann nicht geändert werden

Windows:

  1. Klicken Sie in das Tastenkombinationsfeld
  2. Drücken Sie Ihre gewünschte Tastenkombination
  3. Muss mindestens einen Modifikator enthalten (Strg, Alt, Umschalt)
  4. Vermeiden Sie system-reservierte Kombinationen

Ungültige Kombinationen werden abgelehnt (z.B. Strg+Alt+Entf)

Standardwerte funktionieren nicht

Windows:

  1. Klicken Sie in den Einstellungen auf „Standardwerte"
  2. Muss auf „Übernehmen" oder „OK" klicken, um zu speichern
  3. Falls das fehlschlägt, führen Sie kill_and_reset.bat aus, um die Einstellungen manuell zu löschen

macOS:

defaults delete com.mousecross.MouseCross

Starten Sie dann MouseCross neu.

Leistungsprobleme

Hohe CPU-Auslastung

Normale Nutzung: MouseCross sollte auf modernen Systemen <1% CPU verwenden.

Falls CPU-Auslastung hoch ist:

  1. Überprüfen Sie, ob andere Anwendungen Konflikte verursachen
  2. Grafiktreiber aktualisieren
  3. Reduzieren Sie die Fadenkreuz-Aktualisierungsfrequenz (falls Option verfügbar)
  4. Überprüfen Sie auf Malware oder andere Probleme

Hohe Speicherauslastung

Normale Nutzung: ~10 MB RAM

Falls Speicherauslastung hoch ist:

  • MouseCross neu starten
  • Auf Speicherlecks prüfen (selten, bitte melden, falls gefunden)
  • Auf die neueste Version aktualisieren

Langsamer Start

Windows:

  • Überprüfen Sie, ob Antivirus die ausführbare Datei scannt
  • Verschieben Sie MouseCross.exe an einen ausgeschlossenen Speicherort
  • Stellen Sie sicher, dass die SSD nicht voll ist (wenig Festplattenspeicher verlangsamt den Start)

macOS:

  • Überprüfen Sie die Konsolen-App auf Fehler beim Start
  • Überprüfen Sie, ob macOS nicht indiziert (Spotlight)

Tastenkombinationsprobleme

Globale Tastenkombination funktioniert nicht

Windows:

  1. Überprüfen Sie, ob keine andere Anwendung dieselbe Tastenkombination verwendet
  2. Versuchen Sie eine andere Tastenkombination
  3. Überprüfen Sie, ob die Tastenkombinationsregistrierung Fehler in der Ereignisanzeige zeigt
  4. MouseCross neu starten

macOS:

  1. Überprüfen Sie Systemeinstellungen → Tastatur → Tastaturkurzbefehle
  2. Überprüfen Sie auf Konflikte mit System-Tastenkombinationen
  3. Versuchen Sie eine andere Kombination
  4. MouseCross neu starten

Tastenkombination funktioniert zeitweise

Mögliche Ursachen:

  • Andere Anwendungen erfassen die Tastenkombination
  • Tastatur-Treiberprobleme
  • System steht unter starker Last

Lösungen:

  • Wählen Sie eine eindeutige Tastenkombination
  • Tastatur-Treiber aktualisieren
  • Konflikt verursachende Anwendungen schließen

Autostart-Probleme

Autostart funktioniert nicht (Windows)

Registry-Eintrag überprüfen:

  1. Drücken Sie Windows+R
  2. Geben Sie regedit ein und drücken Sie Eingabetaste
  3. Navigieren Sie zu HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Run
  4. Suchen Sie nach „MouseCross"-Eintrag
  5. Wert sollte der vollständige Pfad zu MouseCross.exe sein

Falls fehlend:

  1. MouseCross-Einstellungen öffnen
  2. „Automatisch mit Windows starten" aktivieren
  3. Übernehmen/OK klicken

Falls immer noch nicht funktionierend:

  • Überprüfen Sie, ob Antivirus Startobjekte blockiert
  • Überprüfen Sie, ob Task-Manager → Autostart MouseCross als „Aktiviert" zeigt

Autostart funktioniert nicht (macOS)

Anmeldeobjekte überprüfen:

  1. Systemeinstellungen öffnen
  2. Zu Allgemein → Anmeldeobjekte gehen
  3. MouseCross sollte in der Liste sein

Falls fehlend:

  1. MouseCross-Einstellungen öffnen
  2. Autostart aktivieren
  3. OK klicken

Falls immer noch nicht funktionierend:

  • MouseCross manuell aus Anmeldeobjekten entfernen
  • Autostart in MouseCross-Einstellungen erneut aktivieren
  • Konsolen-App auf Fehler überprüfen

Deinstallationsprobleme

Kann MouseCross.exe nicht löschen (Windows)

Symptom: Fehler „Datei wird verwendet" beim Löschen.

Lösung:

  1. Rechtsklick auf Taskleistensymbol
  2. „Beenden" wählen
  3. Überprüfen Sie im Task-Manager, dass MouseCross.exe nicht läuft
  4. Datei löschen

Falls immer noch gesperrt:

  1. Windows neu starten
  2. Löschen, bevor MouseCross erneut ausgeführt wird

Registry-Einträge bleiben (Windows)

Nach der Deinstallation können Registry-Einträge verbleiben:

Manuell entfernen:

  1. Drücken Sie Windows+R
  2. Geben Sie regedit ein
  3. Navigieren Sie zu HKEY_CURRENT_USER\Software
  4. Löschen Sie den „MouseCross"-Schlüssel

Oder verwenden Sie das enthaltene kill_and_reset.bat Skript.

Fehlermeldungen

„Fehler beim Erstellen des Overlay-Fensters"

Windows:

  • Desktop Window Manager (DWM) muss laufen
  • Grafiktreiber aktualisieren
  • Stellen Sie sicher, dass Windows Aero aktiviert ist (Windows 7)
  • Versuchen Sie, als Administrator auszuführen

„Barrierefreiheits-Berechtigungen verweigert"

macOS:

  • Folgen Sie der Barrierefreiheits-Berechtigungseinrichtung
  • Entfernen und fügen Sie MouseCross in den Systemeinstellungen erneut hinzu
  • MouseCross nach Erteilung der Berechtigungen neu starten

„Fehler beim Registrieren der Tastenkombination"

Mögliche Ursachen:

  • Eine andere Anwendung verwendet dieselbe Tastenkombination
  • System-reservierte Kombination gewählt
  • Tastenkombinationsregistrierungsdienst nicht verfügbar

Lösungen:

  • Wählen Sie eine andere Tastenkombination
  • Schließen Sie Anwendungen, die möglicherweise kollidieren
  • Windows/macOS neu starten

Screenreader-Probleme

Steuerelemente werden nicht angesagt (Windows)

NVDA:

  1. Stellen Sie sicher, dass NVDA läuft
  2. Drücken Sie NVDA+N zur Überprüfung
  3. Navigieren Sie mit Tab zum Einstellungsdialog
  4. Überprüfen Sie, ob „Linienbreite"-Schieberegler korrekt angesagt wird

Falls Steuerelemente stumm sind:

  • NVDA auf die neueste Version aktualisieren
  • Überprüfen Sie, ob NVDA im Schlafmodus ist (NVDA+Umschalt+S)
  • NVDA neu starten

JAWS:

  • Auf neueste Version aktualisieren
  • Überprüfen Sie, ob JAWS in der Anwendung aktiv ist
  • JAWS-Cursor-Einstellungen überprüfen

Sprachausgabe:

  • Stellen Sie sicher, dass die Sprachausgabe läuft (Windows+Strg+Eingabetaste)
  • Windows auf die neueste Version aktualisieren

Schieberegler-Werte werden nicht angesagt

Überprüfen:

  1. Fokussieren Sie den Schieberegler (Tab oder Alt+Tastenkombination)
  2. Drücken Sie Pfeiltasten zum Anpassen
  3. Wert sollte gesprochen werden

Falls Werte stumm sind:

  • Screenreader muss möglicherweise aktualisiert werden
  • Versuchen Sie zum Testen einen anderen Screenreader
  • Melden Sie das Problem mit Ihrer Screenreader-Version

Probleme melden

Falls Sie auf ein hier nicht behandeltes Problem stoßen:

Einzuschließende Informationen

  1. Version: MouseCross-Versionsnummer (im Info-Dialog überprüfen)
  2. Plattform: Windows-Version oder macOS-Version
  3. Schritte zur Reproduktion: Detaillierte Schritte zum Auslösen des Problems
  4. Erwartetes Verhalten: Was sollte passieren
  5. Tatsächliches Verhalten: Was tatsächlich passiert
  6. Screenshots: Falls zutreffend
  7. Fehlermeldungen: Exakten Fehlertext kopieren

Windows-Diagnoseinformationen

Sammeln Sie diese Informationen vor der Meldung:

# Windows-Version
winver

# DWM-Status überprüfen
Get-Service -Name "uxsms"

# Registry-Schlüssel überprüfen
reg query "HKCU\Software\MouseCross"

macOS-Diagnoseinformationen

# macOS-Version
sw_vers

# Konsole auf Fehler überprüfen
# Konsolen-App öffnen, nach „MouseCross" filtern

# UserDefaults überprüfen
defaults read com.mousecross.MouseCross

Wo melden

  • GitHub Issues: github.com/slohmaier/MouseCross/issues
  • Entsprechend taggen: Verwenden Sie „bug", „accessibility" oder „help" Labels
  • Geduldig sein: Wir antworten so schnell wie möglich

Hilfe erhalten

Falls Sie zusätzliche Unterstützung benötigen:

  1. Überprüfen Sie die Installationsanleitung
  2. Lesen Sie die Einstellungen-Referenz
  3. Siehe Barrierefreiheits-Features für Screenreader-Hilfe
  4. Überprüfen Sie Tastenkombinationen für Navigationshilfe
  5. Melden Sie ein Problem auf GitHub

Bekannte Probleme

Windows 7-Einschränkungen

  • Einige Transparenz-Features funktionieren möglicherweise nicht unter Windows 7
  • Stellen Sie sicher, dass Windows Aero aktiviert ist
  • Windows 10/11 empfohlen für vollständige Features

macOS Catalina und früher

  • Barrierefreiheits-Berechtigungsdialoge können unterschiedlich sein
  • Einige Features erfordern möglicherweise macOS 11 Big Sur oder neuer

Multi-Monitor-Probleme

  • Fadenkreuz kann sich auf Monitoren mit unterschiedlichen DPI-Einstellungen anders verhalten
  • Verbesserungen der Pro-Monitor-DPI-Bewusstheit kommen in zukünftigen Updates

Nächste Schritte