Fehlerbehebung

SmartScreen blockiert den Installer#

Nutze nach Möglichkeit den Microsoft Store. Beim direkten GitHub-Installer ist die Warnung „Unbekannter Herausgeber“ bekannt. Lade die Datei nur aus dem offiziellen TypeWhisper-Release und vergleiche vor dem Start ihre SHA-256-Prüfsumme mit der veröffentlichten Prüfsumme.

Get-FileHash .\TypeWhisper-win-x64-Setup.exe -Algorithm SHA256

Kein oder falsches Mikrofon#

1. Prüfe Windows-Einstellungen > Datenschutz & Sicherheit > Mikrofon und erlaube Desktop-Apps den Zugriff.
2. Wähle unter TypeWhisper > Einstellungen > Diktat das gewünschte Gerät oder „Standard“.
3. Ordne bei wechselnden Headsets die Mikrofon-Prioritätsliste; TypeWhisper nimmt das erste verfügbare Gerät.
4. Öffne das Onboarding über das Dashboard erneut und prüfe den Pegel in Schritt 2.

Tastenkürzel reagiert nicht#

1. Öffne Einstellungen > Tastenkürzel und zeichne die Kombination erneut auf.
2. Wähle eine Kombination, die weder Windows noch eine andere App global registriert.
3. Prüfe auch workflow-spezifische Tastenkürzel. TypeWhisper verhindert Konflikte innerhalb der App, aber nicht mit fremden Programmen.
4. Beende die konkurrierende App oder ändere eines der beiden Kürzel, dann starte TypeWhisper neu.

Text wird nicht eingefügt#

TypeWhisper kopiert das fertige Ergebnis zuerst in die Zwischenablage und sendet für automatisches Einfügen Ctrl+V. Manche erhöht gestarteten, geschützten oder ungewöhnlichen Textfelder blockieren simulierte Eingaben.

1. Drücke direkt nach dem Diktat selbst Ctrl+V. Der Text sollte noch in der Zwischenablage liegen.
2. Prüfe Einstellungen > Diktat > Nach der Transkription automatisch einfügen.
3. Teste ein normales Textfeld wie Editor. Funktioniert es dort, liegt die Grenze am Zielprogramm.
4. Starte TypeWhisper nicht mit niedrigeren Rechten als das Zielprogramm; Windows blockiert Eingaben über diese Berechtigungsgrenze.

Modell oder Erweiterung ist nicht bereit#

1. Öffne Einstellungen > Diktat und prüfe, ob Engine und Modell installiert und ausgewählt sind.
2. Öffne die Seite des Add-ons in der Seitenleiste der Einstellungen und prüfe seinen Status, etwa „Bereit“, „Einrichtung erforderlich“ oder „Aktion erforderlich“, und seine Konfiguration. Ist ein Update verfügbar, zeigt die Seite „Aktualisieren“.
3. Starte TypeWhisper neu, wenn ein Add-on „Neustart erforderlich“ anzeigt oder du die lokale Modellbeschleunigung geändert hast.
4. Wenn Auto-Beschleunigung fehlschlägt, teste CPU. Nutze CUDA, Vulkan oder ROCm nur mit passender Hardware und Laufzeit.

API oder CLI erreicht TypeWhisper nicht#

1. Prüfe Einstellungen > Erweitert > API-Server: „HTTP-API aktivieren“ ist eingeschaltet, der Status lautet „Lauscht auf http://127.0.0.1:<Port>“, und der Port passt zu deinem Client.
2. Teste curl.exe http://localhost:8978/v1/status oder den tatsächlich angezeigten Port.
3. Lösche Discovery-Dateien nicht während die App läuft. Starte TypeWhisper neu, wenn Port oder Token nicht zum Client passen.
4. Wenn „API-Token verlangen“ aktiv ist, bleibt /v1/status frei; alle anderen API-Routen brauchen Authorization: Bearer oder X-TypeWhisper-API-Token.

Einstellung ist von der Organisation gesperrt#

Deine IT hat die Einstellung über eine Richtlinie festgelegt. Einstellungen > Erweitert > Verwaltete Einstellungen zeigt die auf diesem Gerät wirksamen Werte und mögliche Probleme in der Richtlinie. Den Wert ändert nur deine IT; in TypeWhisper lässt er sich nicht überschreiben.

Diagnose exportieren#

Öffne Einstellungen > Erweitert > Support-Diagnose und klicke beim Supportbericht auf „Diagnose exportieren…“. Der Bericht enthält App- und Systemdetails, Mikrofonnamen und -zugriff, Modelle, Plugins, Workflow-Metadaten, Einstellungen und ein gespeichertes Diagnoseprotokoll, falls vorhanden. API-Schlüssel, Audio, Transkripte, Prompt-Inhalte und Dateipfade sind nicht enthalten, und nichts wird automatisch gesendet. Mikrofonnamen können Personennamen enthalten; lies den Bericht vor dem Teilen durch und sende ihn nur an einen vertrauenswürdigen Support-Kanal.