Onafhankelijke handleiding · Problemen oplossen
Als OpenWhispr niet werkt
Bijna alles wat er misgaat in OpenWhispr gaat mis om dezelfde reden: een toestemming die het systeem geeft en de app niet herkent, of een hulpprogramma dat ontbreekt. Hier staan de echte gevallen met hun oplossing, gescheiden per systeem — want het programma gedraagt zich niet op alle drie hetzelfde.
Begin hier
Kies je eigen systeem: elk gedraagt zich anders en heeft zijn eigen lijst.
Wat er per systeem verschilt
Deze tabel is precies de reden dat de pagina per platform is opgedeeld: dit zijn geen nuances, dit zijn verschillende gedragingen.
| macOS | Windows | Linux | |
|---|---|---|---|
| Ingedrukt houden om op te nemen | ja | ja met het hulpprogramma | nee niet ondersteund |
| Wat de tekst invoert | toestemming voor toegankelijkheid | windows-fast-paste | linux-fast-paste, of xdotool / wtype |
| Waar de modellen staan | ~/.cache/openwhispr/ | %USERPROFILE%\.cache\openwhispr\ | ~/.cache/openwhispr/ |
| Verwijderen wist de modellen | nee handmatig | ja | hangt ervan af ja bij .deb en .rpm, niet bij AppImage |
| Minimaal nodig | macOS 12 · 13.3 om op het apparaat te transcriberen | Windows 10 x64 | x64 met PulseAudio of PipeWire |
GEN-01 Het vaakst voorkomend
Hij transcribeert wel, maar voert geen tekst in
Je dictaat is niet weg. OpenWhispr zet de tekst altijd ook op het klembord, ook als het automatisch plakken mislukt: met ⌘V of Ctrl+V plak je hem handmatig en je gaat verder.
De oorzaak zelf hangt van het systeem af: op macOS is het bijna altijd de toestemming voor toegankelijkheid (MAC-01), op Linux een hulpprogramma dat ontbreekt (LNX-01).
GEN-02 Instellingen
Er wordt geen geluid opgepikt
Drie controles, in deze volgorde:
- Of de microfoontoestemming is gegeven.
- Of in de geluidsinstellingen van het systeem de ingang staat die je echt gebruikt.
- Of in de instellingen van OpenWhispr datzelfde apparaat verschijnt.
Van invoerapparaat wisselen en terugwisselen verhelpt een groot deel van de gevallen. De app heeft daarnaast een debugmodus die het audioniveau bijhoudt: beweegt daar niets, dan zit het probleem vóór het programma.
GEN-03 Instellingen
Hij transcribeert leeg of helemaal niet
Bij lokale transcriptie is het meestal een model dat niet volledig is gedownload — te controleren via Instellingen → Spraakherkenning — of te weinig schijfruimte: de modellen lopen van 75 MB tot 1,6 GB. Gebruik je de cloud, controleer dan of de API-sleutel geldig is en krediet heeft.
Van lokaal naar cloud omschakelen, of omgekeerd, laat snel zien aan welke kant het probleem zit.
GEN-04 Openstaande melding
Er verschijnt tekst die niemand heeft gezegd
In stiltes kan het Whisper-model «hallucineren» en afsluitzinnen uit video's invoegen; het meest gemelde is «Thank you for watching!». Het is geen fout van OpenWhispr maar bekend gedrag van het model, en het staat open als melding.
Wat helpt: de sneltoets loslaten zodra je klaar bent met spreken, in plaats van de opname op stilte te laten doorlopen.
GEN-05 Toetsconflict
De sneltoets reageert niet
Meestal botst hij met een ander programma of met een systeemsneltoets. In de instellingen kun je de combinatie wijzigen of een reservesneltoets instellen.
«Ingedrukt houden en loslaten» werkt niet op alle drie de systemen hetzelfde: op Linux is het niet beschikbaar. Zie LNX-02.
Platform 01
macOS
MAC-01 Openstaande melding
Hij transcribeert maar voert niets in: de toegankelijkheidstoestemming
Dit is hindernis nummer één. macOS geeft de toestemming voor toegankelijkheid en de app herkent die niet, dus transcribeert hij wel maar kan hij niet schrijven in het venster dat je open hebt. Het is een melding die sinds maart openstaat, en dit zijn de stappen van de beheerder:
- Open Systeeminstellingen → Privacy en beveiliging → Toegankelijkheid.
- Zoek OpenWhispr, en ook alle vermeldingen die «Electron» heten, en haal ze weg met de knop −.
- Voeg OpenWhispr opnieuw toe met de knop +, uit de map Programma's.
- Controleer of de schakelaar aan blijft staan.
- Start OpenWhispr opnieuw.
Sleep de app naar de map Programma's voordat je hem de eerste keer opent. Start je hem rechtstreeks vanaf de gemounte .dmg, dan koppelt macOS de toestemming aan een pad dat later verdwijnt — en het probleem komt terug.
MAC-02 Verwacht gedrag
«De ontwikkelaar kan niet worden gecontroleerd»
Het programma is niet met een betaald certificaat ondertekend, dus macOS blokkeert het de eerste keer. Oplossing: rechtsklik op de app → «Open», of hem toestaan via Systeeminstellingen → Privacy en beveiliging.
Het betekent niet dat het bestand verdacht is: ondertekenen kost geld en veel vrije projecten doen het niet.
MAC-03 Vereiste
Je Mac haalt de minimumversie niet
Het project vraagt macOS 12 (Monterey) of nieuwer om te werken, en macOS 13.3 (Ventura) of nieuwer om op het apparaat zelf te transcriberen. Blijft je Mac onder 13.3, dan is de lokale modus geen optie en blijft alleen de cloud over.
MAC-04 Openstaande melding
De Globe- of Fn-toets doet onregelmatig
Op de Mac kun je de Globe- (🌐) of Fn-toets als dicteertoets gebruiken, met een echt voordeel: in de gepakte versies vraagt die optie geen toestemming voor «invoercontrole».
Maar er staan meldingen open over botsingen met systeemsneltoetsen en over combinaties die inconsistent reageren. Gebeurt dat, gebruik dan een normale toetsencombinatie.
MAC-05 Openstaande melding
De klembordinstelling wordt niet gerespecteerd
Er staat een melding open over de klembordinstelling op macOS: die gedraagt zich mogelijk niet zoals ingesteld. Is de inhoud van je klembord belangrijk, ga er dan van uit dat OpenWhispr die tijdens het dicteren overschrijft.
MAC-06 Zo doe je dat
Volledig verwijderen
De app verwijderen wist de modellen niet, en die nemen de ruimte in. Op macOS moeten ze handmatig weg:
- Modellen: ~/.cache/openwhispr/
- Appgegevens: ~/Library/Application Support/OpenWhispr/
Platform 02
Windows
WIN-01 Verwacht gedrag
SmartScreen blokkeert het installatiebestand
Om dezelfde reden als op de Mac: het installatiebestand is niet met een betaald certificaat ondertekend. De waarschuwing verschijnt en je klikt op «Meer informatie» → «Toch uitvoeren». De installatie vraagt geen beheerdersrechten.
WIN-02 Diagnose
Alleen indrukken werkt, ingedrukt houden niet
Windows ondersteunt «ingedrukt houden om op te nemen, loslaten om te stoppen» wel, via een eigen hulpprogramma dat met de app wordt geïnstalleerd (windows-key-listener.exe).
Is dat hulpprogramma niet beschikbaar, dan schakelt de app automatisch over op «indrukken om aan/uit te zetten». Dat verklaart precies waarom ingedrukt houden niets doet. Opnieuw installeren zet het meestal recht.
Complexe combinaties zoals Ctrl+Shift+F11 worden ook ondersteund.
WIN-03 Hoe het werkt
Hij plakt de tekst niet in de terminal
Het plakken doet een ander hulpprogramma (windows-fast-paste) en dat is slimmer dan het lijkt: in normale programma's stuurt het Ctrl+V, maar zodra het een terminal herkent stuurt het Ctrl+Shift+V, wat terminals verwachten.
Het herkent Windows Terminal, cmd, PowerShell, mintty, PuTTY, Alacritty, WezTerm, kitty, Hyper, MobaXterm en ConEmu. Staat jouw terminal niet in de lijst, dan kan het plakken mislukken en blijft de tekst op het klembord.
WIN-04 Vereiste
Hij neemt het systeemgeluid niet op
Om het geluid van de computer zelf op te nemen — en niet alleen de microfoon — is Windows 10 versie 2004 of nieuwer nodig. Het programma vereist de x64-architectuur.
WIN-05 Openstaande melding
GPU-versnelling lijkt aan te staan maar doet niets
Er staat een melding open: de interface laat de Vulkan-versnelling als actief zien terwijl dat niet zo is. Loopt de transcriptie traag en reken je op de GPU, dan is dit het eerste om te bekijken.
Voor computers met meerdere kaarten wordt bovendien gewerkt aan de keuze welke wordt gebruikt.
WIN-06 Openstaande melding
De modellen komen op de verkeerde plek
De modelcache staat in %USERPROFILE%\.cache\openwhispr\. Heb je de gebruikersmappen naar een andere schijf omgeleid, houd dan rekening met deze openstaande melding: de cache negeert die omleiding en schrijft naar het oorspronkelijke pad. Dat telt als de systeemschijf krap zit.
Platform 03
Linux
LNX-01 Er ontbreekt een hulpprogramma
Hij transcribeert maar plakt de tekst niet
Het plakken doet een eigen hulpprogramma (linux-fast-paste) dat X11 en Wayland dekt. Is dat niet beschikbaar, dan zijn de systeemhulpprogramma's nodig:
- X11: xdotool.
- Wayland: wtype, of ydotool — die ook zijn daemon nodig heeft.
Zonder een van beide wordt er wel getranscribeerd, maar blijft de tekst op het klembord.
Op GNOME met Wayland staat een melding open: het plakken mislukt stil, zonder enige waarschuwing.
LNX-02 Niet ondersteund
Ingedrukt houden bestaat hier niet
Dit is het belangrijkste verschil met de andere twee systemen, en het mag gewoon gezegd worden: op GNOME is de modus met ingedrukt houden niet beschikbaar, en op Hyprland ook niet.
Het is geen instelfout en het valt niet te verhelpen: het is niet ondersteund. Je dicteert door één keer te drukken om te beginnen en nog een keer om te stoppen.
LNX-03 Hangt van je desktop af
De sneltoets wordt niet geregistreerd
- GNOME: sneltoetsen worden via D-Bus en gsettings geregistreerd, dus ze staan in de systeeminstellingen. Werkt de normale sneltoets niet, dan is F8 de reserve.
- KDE Plasma: native integratie via D-Bus, verder niets.
- Hyprland: vereist hyprctl — zit erbij — en registreert de sneltoets bij elke start opnieuw, dus die moet in het PATH staan.
LNX-04 Opgelost: bijwerken
Fouten bij de lokale transcriptie
Het is de langste draad van de hele repository: de fouten van lokale Whisper op Linux hebben 32 reacties en zijn opgelost. Dus eerst bijwerken naar de laatste versie voordat je verder zoekt.
Voor de audio is PulseAudio of PipeWire nodig. De ondersteunde architectuur is x64: ondersteuning voor ARM (aarch64) staat op de planning maar is er nog niet.
LNX-05 Zo doe je dat
Welk formaat je installeert, en wat er achterblijft
- .deb — Debian, Ubuntu, Mint, Pop!_OS
- .rpm — Fedora, RHEL, openSUSE
- .AppImage — elke distributie, zonder iets te installeren
- .tar.gz — universeel
Bij verwijderen nemen .deb en .rpm de modelcache mee; bij AppImage en tar.gz moet je ~/.cache/openwhispr/ handmatig wissen.
Als niets hiervan helpt
Deze site is niet de support van het project en kan geen individuele gevallen oplossen. Staat het probleem niet op deze pagina, dan is de juiste plek het meldingenregister, in het Engels, waar de auteurs zelf antwoorden.
Kijk eerst of het al gemeld is — meerdere gevallen van deze pagina waren dat — en noem altijd drie dingen: de versie van OpenWhispr, het systeem en de versie daarvan, en of je lokaal of in de cloud transcribeert.
Geen officiële site.
Deze website is een onafhankelijke Nederlandstalige handleiding en is niet verbonden aan het OpenWhispr-project of zijn auteurs. OpenWhispr is een merk van de respectieve houders en verschijnt onder de MIT-licentie. De officiële site is openwhispr.com en de broncode staat op GitHub.