Unabhängige Anleitung · Fehlerbehebung
Wenn OpenWhispr nicht funktioniert
Fast alles, was an OpenWhispr scheitert, scheitert an derselben Sache: an einer Berechtigung, die das System erteilt und die App nicht erkennt, oder an einem fehlenden Werkzeug. Hier stehen die echten Fälle mit ihrer Lösung, getrennt nach System — denn das Programm verhält sich nicht überall gleich.
Hier anfangen
Steig bei deinem System ein: jedes verhält sich anders und hat seine eigene Liste.
Was sich von System zu System unterscheidet
Diese Tabelle ist die Begründung dafür, dass die Seite nach Plattformen getrennt ist: das sind keine Nuancen, das sind unterschiedliche Verhaltensweisen.
| macOS | Windows | Linux | |
|---|---|---|---|
| Gedrückthalten zum Aufnehmen | ja | ja mit dem Hilfsprogramm | nein nicht unterstützt |
| Wer den Text schreibt | Berechtigung «Bedienungshilfen» | windows-fast-paste | linux-fast-paste, oder xdotool / wtype |
| Wo die Modelle liegen | ~/.cache/openwhispr/ | %USERPROFILE%\.cache\openwhispr\ | ~/.cache/openwhispr/ |
| Deinstallieren löscht die Modelle | nein von Hand | ja | unterschiedlich ja bei .deb und .rpm, nicht beim AppImage |
| Mindestens erforderlich | macOS 12 · 13.3 für die Transkription auf dem Gerät | Windows 10 x64 | x64 mit PulseAudio oder PipeWire |
GEN-01 Der häufigste Fall
Es wird transkribiert, aber kein Text eingefügt
Das Diktierte ist nicht verloren. OpenWhispr legt den Text immer auch in die Zwischenablage, selbst wenn das automatische Einfügen scheitert: mit ⌘V oder Strg+V von Hand einfügen und weiterarbeiten.
Die Ursache selbst hängt vom System ab: unter macOS sind es fast immer die Bedienungshilfen (MAC-01), unter Linux ein fehlendes Werkzeug (LNX-01).
GEN-02 Konfiguration
Kein Ton wird erkannt
Drei Prüfungen, in dieser Reihenfolge:
- Dass die Mikrofon-Berechtigung erteilt ist.
- Dass in den Toneinstellungen des Systems das Eingabegerät ausgewählt ist, das tatsächlich benutzt wird.
- Dass in den Einstellungen von OpenWhispr dasselbe Gerät erscheint.
Das Eingabegerät zu wechseln und zurückzuwechseln löst einen guten Teil der Fälle. Die App hat zudem einen Debug-Modus, der den Audiopegel protokolliert: bewegt sich dort nichts, liegt das Problem vor dem Programm.
GEN-03 Konfiguration
Transkribiert leer oder gar nicht
Bei lokaler Transkription ist meist das Modell nicht vollständig heruntergeladen — zu prüfen unter Einstellungen → Spracherkennung — oder der Speicherplatz reicht nicht: die Modelle reichen von 75 MB bis 1,6 GB. Im Cloud-Modus stattdessen prüfen, ob der API-Schlüssel gültig ist und Guthaben hat.
Von lokal auf Cloud umschalten (oder umgekehrt) zeigt schnell, auf welcher Seite der Fehler liegt.
GEN-04 Offene Meldung
Es erscheinen Sätze, die niemand gesagt hat
In Pausen kann das Whisper-Modell «halluzinieren» und Abschlussfloskeln aus Videos einschieben; am häufigsten gemeldet ist «Thank you for watching!». Das ist kein Fehler von OpenWhispr, sondern ein bekanntes Verhalten des Modells, und es ist als Meldung offen.
Was hilft: die Taste direkt nach dem Sprechen loslassen, statt die Aufnahme still weiterlaufen zu lassen.
GEN-05 Tastenkonflikt
Die Tastenkombination reagiert nicht
Meist kollidiert sie mit einem anderen Programm oder einem Systemkürzel. In den Einstellungen lässt sich die Kombination ändern oder ein Ersatzkürzel festlegen.
«Gedrückthalten und loslassen» funktioniert nicht in allen drei Systemen gleich: unter Linux ist es nicht verfügbar. Erklärt in LNX-02.
Plattform 01
macOS
MAC-01 Offene Meldung
Transkribiert, fügt aber nicht ein: die Bedienungshilfen
Die Hürde Nummer eins. macOS erteilt die Berechtigung für die Bedienungshilfen, die App erkennt sie nicht — also wird transkribiert, aber nicht in das Fenster geschrieben, das gerade offen ist. Der Fall ist seit März offen, und das sind die Schritte des Maintainers:
- Systemeinstellungen → Datenschutz & Sicherheit → Bedienungshilfen öffnen.
- OpenWhispr suchen — und auch alle Einträge namens «Electron» — und mit der Schaltfläche − entfernen.
- OpenWhispr mit + erneut hinzufügen, aus dem Ordner «Programme».
- Prüfen, dass der Schalter aktiviert bleibt.
- OpenWhispr neu starten.
Die App vor dem ersten Start in den Ordner «Programme» ziehen. Wird sie direkt vom gemounteten .dmg ausgeführt, verknüpft macOS die Berechtigung mit einem Pfad, der später verschwindet — und das Problem kommt wieder.
MAC-02 Erwartetes Verhalten
«Der Entwickler kann nicht überprüft werden»
Das Programm ist nicht mit einem kostenpflichtigen Zertifikat signiert, deshalb blockiert macOS es beim ersten Start. Lösung: mit der rechten Maustaste auf die App klicken und «Öffnen» wählen, oder sie unter Systemeinstellungen → Datenschutz & Sicherheit freigeben.
Das ist kein Hinweis darauf, dass die Datei verdächtig wäre: Signieren kostet Geld, und viele freie Projekte tun es nicht.
MAC-03 Voraussetzung
Der Mac erreicht die Mindestversion nicht
Das Projekt verlangt macOS 12 (Monterey) oder neuer zum Betrieb und macOS 13.3 (Ventura) oder neuer für die Transkription auf dem Gerät selbst. Liegt der Mac unter 13.3, ist der lokale Modus keine Option und es bleibt nur die Cloud.
MAC-04 Offene Meldung
Die Globus- oder Fn-Taste verhält sich unzuverlässig
Unter macOS lässt sich die Globus- (🌐) bzw. Fn-Taste als Diktattaste verwenden, mit einem echten Vorteil: in den gepackten Releases verlangt sie keine Berechtigung zur «Eingabeüberwachung».
Es gibt aber offene Fälle zu Konflikten mit Systemkürzeln und zu Kombinationen, die inkonsistent reagieren. Wenn das auftritt: eine normale Tastenkombination verwenden.
MAC-05 Offene Meldung
Die Einstellung für die Zwischenablage wird ignoriert
Zur Zwischenablage-Einstellung unter macOS gibt es eine offene Meldung: sie verhält sich möglicherweise nicht wie eingestellt. Wenn der Inhalt der Zwischenablage wichtig ist, sollte man damit rechnen, dass OpenWhispr ihn beim Diktieren überschreibt.
MAC-06 So geht es
Vollständig deinstallieren
Die App zu löschen entfernt die Modelle nicht, und die belegen den Platz. Unter macOS müssen sie von Hand weg:
- Modelle: ~/.cache/openwhispr/
- Anwendungsdaten: ~/Library/Application Support/OpenWhispr/
Plattform 02
Windows
WIN-01 Erwartetes Verhalten
SmartScreen blockiert den Installer
Aus demselben Grund wie beim Mac: der Installer ist nicht mit einem kostenpflichtigen Zertifikat signiert. Es erscheint die Warnung, und man klickt auf «Weitere Informationen» → «Trotzdem ausführen». Die Installation verlangt keine Administratorrechte.
WIN-02 Diagnose
Es funktioniert nur Drücken, nicht Gedrückthalten
Windows unterstützt «gedrückt halten zum Aufnehmen, loslassen zum Beenden» — und zwar über ein eigenes Hilfsprogramm, das mit der App installiert wird (windows-key-listener.exe).
Ist dieses Hilfsprogramm nicht verfügbar, fällt die App automatisch in den Modus «Drücken zum Umschalten». Genau das erklärt das Symptom, dass Gedrückthalten nichts bewirkt. Eine Neuinstallation bringt es meist zurück.
Komplexe Kombinationen wie Strg+Umschalt+F11 werden ebenfalls unterstützt.
WIN-03 So funktioniert es
Im Terminal wird der Text nicht eingefügt
Das Einfügen übernimmt ein weiteres Hilfsprogramm (windows-fast-paste), und es ist klüger als es aussieht: in normalen Programmen sendet es Strg+V, erkennt es aber ein Terminal, sendet es Strg+Umschalt+V — das, was Terminals erwarten.
Erkannt werden Windows Terminal, cmd, PowerShell, mintty, PuTTY, Alacritty, WezTerm, kitty, Hyper, MobaXterm und ConEmu. Steht das eigene Terminal nicht auf der Liste, kann das Einfügen scheitern und der Text bleibt in der Zwischenablage.
WIN-04 Voraussetzung
Der Systemton wird nicht mitgeschnitten
Um den Ton des Rechners selbst aufzunehmen — und nicht nur das Mikrofon — ist Windows 10 Version 2004 oder neuer nötig. Das Programm braucht die x64-Architektur.
WIN-05 Offene Meldung
Die GPU-Beschleunigung erscheint aktiv, tut aber nichts
Es gibt eine offene Meldung: die Oberfläche zeigt die Vulkan-Beschleunigung als aktiv an, obwohl sie es nicht ist. Wenn die Transkription träge läuft und man mit der GPU rechnet, ist das der erste Kandidat.
Für Rechner mit mehreren Grafikkarten ist außerdem in Arbeit, dass man auswählen kann, welche verwendet wird.
WIN-06 Offene Meldung
Die Modelle landen am falschen Ort
Der Modell-Cache liegt unter %USERPROFILE%\.cache\openwhispr\. Wer die Benutzerordner auf ein anderes Laufwerk umgeleitet hat, sollte diese offene Meldung kennen: der Cache ignoriert die Umleitung und schreibt an den ursprünglichen Pfad. Relevant, wenn die Systemplatte knapp ist.
Plattform 03
Linux
LNX-01 Ein Werkzeug fehlt
Transkribiert, fügt aber nicht ein
Das Einfügen übernimmt ein eigenes Hilfsprogramm (linux-fast-paste), das X11 und Wayland abdeckt. Ist es nicht verfügbar, braucht es die Systemwerkzeuge:
- X11: xdotool.
- Wayland: wtype, oder ydotool — das zusätzlich einen laufenden Daemon braucht.
Ohne eines davon wird trotzdem transkribiert, der Text bleibt aber in der Zwischenablage.
Unter GNOME mit Wayland gibt es eine offene Meldung: das Einfügen scheitert stillschweigend, ohne Hinweis.
LNX-02 Nicht unterstützt
Gedrückthalten gibt es hier nicht
Das ist der wichtigste Unterschied zu den anderen beiden Systemen, und man sollte ihn ohne Umschweife sagen: unter GNOME ist der Modus zum Gedrückthalten nicht verfügbar, und unter Hyprland ebenfalls nicht.
Das ist kein Konfigurationsfehler und lässt sich nicht einstellen: es ist nicht unterstützt. Diktiert wird mit Drücken zum Starten und Drücken zum Beenden.
LNX-03 Je nach Desktop
Die Tastenkombination wird nicht registriert
- GNOME: Kürzel werden über D-Bus und gsettings registriert und erscheinen daher in den Systemeinstellungen. Scheitert das normale Kürzel, ist F8 das Ersatzkürzel.
- KDE Plasma: native Integration über D-Bus, ohne weiteres Zutun.
- Hyprland: braucht hyprctl — ist enthalten — und registriert das Kürzel bei jedem Start neu, es muss also im PATH erreichbar sein.
LNX-04 Behoben: aktualisieren
Fehler bei der lokalen Transkription
Es ist der längste Thread des ganzen Repositorys: die Fehler von lokalem Whisper unter Linux haben 32 Kommentare und sind behoben. Also zuerst auf die neueste Version aktualisieren, bevor man irgendetwas untersucht.
Für den Ton braucht es PulseAudio oder PipeWire. Unterstützt wird x64: die Unterstützung für ARM (aarch64) ist geplant, aber nicht verfügbar.
LNX-05 So geht es
Welches Format, und was beim Deinstallieren zurückbleibt
- .deb — Debian, Ubuntu, Mint, Pop!_OS
- .rpm — Fedora, RHEL, openSUSE
- .AppImage — jede Distribution, ohne Installation
- .tar.gz — universell
Beim Deinstallieren nehmen .deb und .rpm den Modell-Cache mit; bei AppImage und tar.gz muss ~/.cache/openwhispr/ von Hand gelöscht werden.
Wenn nichts davon hilft
Diese Seite ist nicht der Support des Projekts und kann keine Einzelfälle lösen. Steht das Problem nicht hier, ist der richtige Ort das Meldungsregister — auf Englisch, dort antworten die Autoren selbst.
Zuerst nachsehen, ob der Fall schon gemeldet ist — mehrere von dieser Seite waren es — und immer drei Dinge nennen: die Version von OpenWhispr, das System und seine Version, und ob lokal oder in der Cloud transkribiert wird.
Keine offizielle Seite.
Diese Website ist eine unabhängige deutschsprachige Anleitung und steht in keiner Verbindung zum OpenWhispr-Projekt oder seinen Autoren. OpenWhispr ist Marke der jeweiligen Inhaber und erscheint unter MIT-Lizenz. Die offizielle Seite ist openwhispr.com, der Quellcode liegt auf GitHub.