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.

Sichere Installationswege

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 Integrationen > Installiert und prüfe Status, Konfiguration und verfügbare Updates des Add-ons.
3. Starte TypeWhisper neu, wenn „App-Neustart erforderlich“ erscheint 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: aktiviert, Status „läuft“ und der erwartete Port.
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. Bei aktivem Token-Schutz: /v1/status bleibt frei; alle anderen Routen brauchen Authorization: Bearer oder X-TypeWhisper-API-Token.

API-Setup und Discovery

Diagnose exportieren

Öffne Einstellungen > Über, prüfe zuerst das Fehlerprotokoll und klicke auf „Diagnose exportieren“. Die JSON-Datei enthält App-, Windows- und Laufzeitversion, Gebietsschema sowie protokollierte Fehler. Lies sie vor dem Teilen durch und sende sie nur an einen vertrauenswürdigen Support-Kanal.