Fehlerbehebung

Wählen Sie einen Abschnitt nach Symptom. Jeder enthält eine Checkliste und geordnete Fixes. Gestrichelte Rahmen sind Screenshot-Platzhalter (public/screenshots/ts-*.svg).

Zuerst notieren: diese fünf Punkte

1. macOS-Version
2. VoiceHotkey-Version (Einstellungen → Info)
3. Name der Diktier-Engine
4. Nur-lokal an/aus
5. App-Pfad (Finder → Informationen)

Datenschutz

Niemals API-Schlüssel, Lizenzgeheimnisse oder sensible Transkripte einfügen. Siehe Kontakt.

---

Hotkey reagiert nicht

Kein Overlay, kein Statuswechsel in der Menüleiste, kein Systemfeedback.

Checkliste

• Menüleistensymbol vorhanden (App läuft)
• Bedienungshilfen für den aktuellen App-Pfad aktiviert
• Gestartet aus /Applications oder ~/Applications
• Hotkey kollidiert nicht mit einer anderen App
• Hotkey-Seite warnt nicht wegen Bedienungshilfen

Schritte

1. Prozess — Das Menüleistensymbol sollte ein Menü öffnen. Fehlt es, aus Programme neu starten.
2. Bedienungshilfen — Systemeinstellungen → Datenschutz & Sicherheit → Bedienungshilfen. Ein VoiceHotkey-Eintrag, korrekter Pfad, Schalter an. Duplikate entfernen, App beenden und neu öffnen.
3. Stabiler Pfad — Siehe Installation & Berechtigungen.
4. Neu belegen — Einstellungen → Hotkey → eine seltener genutzte Kombination aufzeichnen.
5. Konflikte — Andere Tools mit ⌥Space beenden und erneut versuchen.

Abb. A · Bedienungshilfen-Liste (Platzhalter · ts-01-accessibility-list.svg)

---

Aufnahme, aber kein Text

Overlay zeigt Zuhören, aber das Feld bleibt leer oder die Verarbeitung endet nicht.

Checkliste

• Demo-Modus aus
• Mikrofon erteilt; korrektes Eingabegerät
• Engine konfiguriert (Schlüssel / Apple bereit)
• Nur-lokal blockiert keine Cloud-Engine
• Netzwerk / Kontingent / Schlüssel gültig
• Einfügemarke in einem normalen Textfeld (sichere Felder können Einfügen blockieren)

Schritte

1. Einstellungen → Allgemein — Demo-Modus ausschalten.
2. Menüleistenstatus lesen — Mikrofon nötig, Engine nicht konfiguriert, Nur-lokal blockiert usw.
3. Mikrofon — für VoiceHotkey aktivieren; Hardware mit Sprachnotizen prüfen.
4. Engine — Apple als Kontrolle versuchen. Funktioniert Apple, Cloud aber nicht → Schlüssel/Netzwerk/Kontingent.
5. Nur-lokal — öffentliche Engines schlagen fehl, wenn Nur-lokal an ist.
6. Ausgabe — Nachbearbeitung Ausgabeaktion sollte an der Einfügemarke einfügen; in Notizen testen, falls Terminal die Injektion blockiert.

Abb. B · Menüleistenstatus (Platzhalter · ts-02-menubar-status.svg)

Abb. C · Nur-lokal (Platzhalter · ts-03-local-only.svg)

---

Berechtigungen gehen immer wieder verloren

Gestern funktioniert; Hotkey heute tot; Bedienungshilfen wirken halb gesetzt.

Häufige Ursachen

Ursache	Hinweise
Pfad geändert	Downloads, anderer Ordner oder anderer Build-Pfad
Signatur / Ersetzen	Überschreibende Installation als neue App behandelt
Doppelte Einträge	Falscher Bedienungshilfen-Eintrag gebunden

Beheben

1. Nur eine App in Programme behalten.
2. VoiceHotkey vollständig beenden.
3. Alle VoiceHotkey-Einträge unter Bedienungshilfen und Mikrofon entfernen.
4. Vom festen Pfad starten und erneut freigeben.
5. Immer denselben Pfad öffnen (Debug- vs. Release-Pakete gelten als unterschiedliche Pfade).

---

Politur / Übersetzung unverändert

• Aufbereitung aktiviert / der Übersetzungs-Hotkey wird genutzt
• LLM-Schlüssel in der Nachbearbeitung konfiguriert
• Nur-lokal blockiert die API nicht
• Fallback kann das Rohtranskript einfügen (bei Fehlern erwartet)

1. Einstellungen → Text-Nachbearbeitung: Aufbereitung an; Übersetzung nutzt eigenen Hotkey.
2. LLM-Anbieterschlüssel konfigurieren.
3. Mit ausgeschaltetem Nur-lokal vergleichen oder Base URL auf localhost zeigen.
4. Sicherstellen, dass reines Diktat funktioniert, bevor die Aufbereitung aktiviert wird.

---

Shell-Befehl läuft nicht

• Trial oder Pro (nicht Free)
• Einstellungen → Sprachbefehle → Shell-Befehle erlauben aktiviert
• Bestätigungsdialog nicht abgebrochen
• Nicht von der Gefahren-Blockliste gesperrt
• Intent-Modell an und konfiguriert

Siehe Shell-Befehle und Pläne.

Abb. D · Lizenz (Platzhalter · ts-04-license.svg)

---

Schnellszenarien

Frische Installation

1. Pfad + beide Berechtigungen
2. Demo-Modus aus
3. Eine funktionierende Engine
4. In Notizen testen

Nach Update

1. Neuen Build aus Programme starten
2. Veraltete Bedienungshilfen-Einträge löschen und neu freigeben
3. Version unter Info bestätigen

Arbeitsnetzwerk / Datenschutz

1. Cloud-APIs müssen erreichbar sein
2. Oder Apple / localhost nutzen
3. Nur-lokal pausiert auch Update-Prüfungen

---

Immer noch stecken?

1. Den Ersteinrichtungs-Probelauf erneut ausführen.
2. Die fünf Punkte oben sammeln.
3. Ein Issue über Kontakt melden.

Installation & BerechtigungenDMG, Pfad, Bedienungshilfen, Mikrofon.

ErsteinrichtungDemo-Modus, Engine, Hotkeys, Test.