Guide indépendant · Dépannage
Quand OpenWhispr ne fonctionne pas
Presque tout ce qui échoue dans OpenWhispr échoue pour la même raison : une autorisation que le système accorde et que l'application ne reconnaît pas, ou un outil qui manque. Voici les cas réels, avec leur solution, séparés par système — car le programme ne se comporte pas de la même façon sur les trois.
Commencez par ici
Entrez par votre système : chacun se comporte différemment et a sa propre liste.
Ce qui change d'un système à l'autre
Ce tableau est la raison pour laquelle cette page est séparée par plateformes : ce ne sont pas des nuances, ce sont des comportements différents.
| macOS | Windows | Linux | |
|---|---|---|---|
| Maintenir la touche pour enregistrer | oui | oui avec son utilitaire | non non pris en charge |
| Ce qui écrit le texte | autorisation d'accessibilité | windows-fast-paste | linux-fast-paste, ou xdotool / wtype |
| Où sont stockés les modèles | ~/.cache/openwhispr/ | %USERPROFILE%\.cache\openwhispr\ | ~/.cache/openwhispr/ |
| La désinstallation supprime les modèles | non à la main | oui | selon le format oui en .deb et .rpm, non en AppImage |
| Minimum requis | macOS 12 · 13.3 pour transcrire sur l'appareil | Windows 10 x64 | x64 avec PulseAudio ou PipeWire |
GEN-01 Le cas le plus fréquent
Il transcrit, mais n'écrit pas le texte
Vous n'avez pas perdu votre dictée. OpenWhispr copie toujours le texte dans le presse-papiers, même quand le collage automatique échoue : collez-le à la main avec ⌘V ou Ctrl+V et continuez.
Ensuite, la cause dépend du système : sur macOS c'est presque toujours l'autorisation d'accessibilité (MAC-01), et sur Linux un outil qui manque (LNX-01).
GEN-02 Configuration
Aucun son détecté
Trois vérifications, dans cet ordre :
- Que l'autorisation du micro soit bien accordée.
- Que dans les réglages de son du système, l'entrée sélectionnée soit celle que vous utilisez réellement.
- Que dans les réglages d'OpenWhispr ce même périphérique apparaisse.
Changer de périphérique d'entrée puis revenir règle une bonne partie des cas. L'application dispose en plus d'un mode de débogage qui journalise le niveau audio : si rien n'y bouge, le problème se situe avant le programme.
GEN-03 Configuration
Il transcrit vide, ou ne transcrit rien
En transcription locale, le plus courant est que le modèle ne soit pas entièrement téléchargé — cela se vérifie dans Réglages → Reconnaissance vocale — ou qu'il manque de l'espace disque : les modèles vont de 75 Mo à 1,6 Go. En mode cloud, vérifiez plutôt que la clé d'API est valide et créditée.
Basculer de local à cloud, ou l'inverse, est le moyen rapide de savoir de quel côté est la panne.
GEN-04 Signalement ouvert
Il écrit des phrases que vous n'avez pas dites
Dans les silences, le modèle Whisper peut « halluciner » et glisser des formules de fin de vidéo ; la plus signalée est « Thank you for watching ! ». Ce n'est pas un défaut d'OpenWhispr mais un comportement connu du modèle, et il est ouvert comme signalement.
Ce qui aide : relâcher le raccourci dès que vous avez fini de parler, plutôt que de laisser l'enregistrement tourner sur du silence.
GEN-05 Conflit de touches
Le raccourci ne répond pas
Le plus courant est un conflit avec un autre programme ou avec un raccourci du système. On peut changer la combinaison dans les réglages, ou définir un raccourci de secours.
Le « maintenir puis relâcher » ne fonctionne pas de la même façon sur les trois systèmes : sur Linux il n'est pas disponible. Voir LNX-02.
Plateforme 01
macOS
MAC-01 Signalement ouvert
Il transcrit mais n'écrit pas : l'autorisation d'accessibilité
C'est l'obstacle numéro un. macOS accorde l'autorisation d'accessibilité et l'application ne la reconnaît pas : elle transcrit, mais ne peut pas écrire dans la fenêtre ouverte devant vous. C'est un signalement ouvert depuis mars, et voici les étapes données par le mainteneur :
- Ouvrez Réglages Système → Confidentialité et sécurité → Accessibilité.
- Cherchez OpenWhispr, ainsi que toute entrée nommée « Electron », et retirez-les avec le bouton −.
- Rajoutez OpenWhispr avec le bouton +, depuis le dossier Applications.
- Vérifiez que l'interrupteur reste activé.
- Redémarrez OpenWhispr.
Glissez l'application dans le dossier Applications avant de l'ouvrir la première fois. Si elle est lancée depuis le .dmg monté, macOS associe l'autorisation à un chemin qui disparaît ensuite, et le problème revient.
MAC-02 Comportement attendu
« Le développeur ne peut pas être vérifié »
Le programme n'est pas signé avec un certificat payant, donc macOS le bloque au premier lancement. La solution : clic droit sur l'application → « Ouvrir », ou l'autoriser dans Réglages Système → Confidentialité et sécurité.
Ce n'est pas un signe que le binaire soit suspect : signer coûte de l'argent, et beaucoup de projets libres ne le font pas.
MAC-03 Prérequis
Votre Mac n'atteint pas la version minimale
Le projet demande macOS 12 (Monterey) ou plus récent pour fonctionner, et macOS 13.3 (Ventura) ou plus récent pour transcrire sur l'appareil lui-même. Si votre Mac reste sous 13.3, le mode local n'est pas une option et il ne reste que le cloud.
MAC-04 Signalement ouvert
La touche Globe ou Fn se comporte de façon irrégulière
Sur Mac, on peut utiliser la touche Globe (🌐) ou Fn comme raccourci de dictée, avec un avantage réel : dans les versions empaquetées, elle n'exige pas l'autorisation de « surveillance de la saisie ».
Mais il existe des cas ouverts de conflit avec des raccourcis du système et de combinaisons qui répondent de manière incohérente. Si cela vous arrive, utilisez une combinaison de touches normale.
MAC-05 Signalement ouvert
Le réglage du presse-papiers n'est pas respecté
Il existe un signalement ouvert sur le réglage du presse-papiers sous macOS : il peut ne pas se comporter comme configuré. Si le contenu de votre presse-papiers compte, partez du principe qu'OpenWhispr va l'écraser en dictant.
MAC-06 Comment faire
Désinstaller complètement
Supprimer l'application ne supprime pas les modèles, et ce sont eux qui occupent de la place. Sur macOS il faut les retirer à la main :
- Modèles : ~/.cache/openwhispr/
- Données de l'application : ~/Library/Application Support/OpenWhispr/
Plateforme 02
Windows
WIN-01 Comportement attendu
SmartScreen bloque l'installateur
Pour la même raison que sur Mac : l'installateur n'est pas signé avec un certificat payant. L'avertissement apparaît et il faut cliquer sur « Informations complémentaires » → « Exécuter quand même ». L'installation ne demande pas de droits d'administrateur.
WIN-02 Diagnostic
Seul l'appui simple fonctionne, pas le maintien
Windows prend bien en charge le « maintenir pour enregistrer, relâcher pour arrêter », via un utilitaire propre installé avec l'application (windows-key-listener.exe).
Si cet utilitaire n'est pas disponible, l'application bascule automatiquement en mode « appuyer pour activer/désactiver ». C'est précisément ce qui explique que maintenir la touche ne fasse rien. Réinstaller le remet généralement en place.
Elle accepte aussi des combinaisons complexes du type Ctrl+Maj+F11.
WIN-03 Comment ça marche
Il ne colle pas le texte dans le terminal
Le collage est assuré par un autre utilitaire (windows-fast-paste), plus fin qu'il n'y paraît : dans les programmes normaux il envoie Ctrl+V, mais lorsqu'il détecte un terminal il envoie Ctrl+Maj+V, ce que les terminaux attendent.
Il reconnaît Windows Terminal, cmd, PowerShell, mintty, PuTTY, Alacritty, WezTerm, kitty, Hyper, MobaXterm et ConEmu. Si votre terminal n'est pas dans la liste, le collage peut échouer et le texte reste dans le presse-papiers.
WIN-04 Prérequis
Il ne capture pas le son du système
Pour enregistrer le son de la machine elle-même — et pas seulement le micro — il faut Windows 10 version 2004 ou plus récent. Le programme nécessite l'architecture x64.
WIN-05 Signalement ouvert
L'accélération GPU s'affiche comme active mais ne fait rien
Il y a un signalement ouvert : l'interface affiche l'accélération Vulkan comme active alors qu'elle ne l'est pas. Si la transcription est lente et que vous comptez sur le GPU, c'est le premier point à regarder.
Pour les machines à plusieurs cartes, un travail est en cours pour pouvoir choisir laquelle est utilisée.
WIN-06 Signalement ouvert
Les modèles se téléchargent au mauvais endroit
Le cache des modèles se trouve dans %USERPROFILE%\.cache\openwhispr\. Si vous avez redirigé les dossiers utilisateur vers un autre disque, tenez compte de ce signalement ouvert : le cache ignore cette redirection et écrit dans le chemin d'origine. Cela compte quand le disque système est juste.
Plateforme 03
Linux
LNX-01 Un outil manque
Il transcrit mais ne colle pas le texte
Le collage est assuré par un utilitaire propre (linux-fast-paste) qui couvre X11 et Wayland. Quand il n'est pas disponible, il faut les outils du système :
- X11 : xdotool.
- Wayland : wtype, ou ydotool — qui exige en plus son démon en marche.
Sans aucun des deux, la transcription se fait quand même et le texte reste dans le presse-papiers.
Sous GNOME avec Wayland, il existe un signalement ouvert : le collage échoue en silence, sans rien signaler.
LNX-02 Non pris en charge
Le maintien de touche n'existe pas ici
C'est la différence la plus importante avec les deux autres systèmes, et autant le dire sans détour : sous GNOME le mode de maintien n'est pas disponible, et sous Hyprland non plus.
Ce n'est pas une erreur de configuration et cela ne se règle pas : ce n'est pas pris en charge. On dicte en appuyant pour commencer et en appuyant pour terminer.
LNX-03 Selon le bureau
Le raccourci ne s'enregistre pas
- GNOME : les raccourcis sont enregistrés via D-Bus et gsettings, ils apparaissent donc dans les réglages du système. Quand le raccourci normal échoue, celui de secours est F8.
- KDE Plasma : intégration native via D-Bus, sans plus.
- Hyprland : nécessite hyprctl — fourni — et le raccourci est réenregistré à chaque démarrage, il doit donc être accessible dans le PATH.
LNX-04 Résolu : mettez à jour
Erreurs de la transcription locale
C'est le fil le plus long de tout le dépôt : les erreurs de Whisper local sous Linux cumulent 32 commentaires et sont résolues. La première chose est donc de mettre à jour vers la dernière version avant d'enquêter.
Pour l'audio il faut PulseAudio ou PipeWire. L'architecture prise en charge est x64 : la prise en charge d'ARM (aarch64) est prévue mais pas disponible.
LNX-05 Comment faire
Quel format installer, et ce qui reste après désinstallation
- .deb — Debian, Ubuntu, Mint, Pop!_OS
- .rpm — Fedora, RHEL, openSUSE
- .AppImage — n'importe quelle distribution, sans rien installer
- .tar.gz — universel
À la désinstallation, .deb et .rpm emportent le cache des modèles ; avec AppImage et tar.gz il faut supprimer ~/.cache/openwhispr/ à la main.
Si rien de tout cela ne le règle
Ce site n'est pas le support du projet et ne peut pas résoudre de cas particuliers. Quand le problème n'est pas sur cette page, le bon endroit est le registre des signalements, en anglais, où répondent les auteurs eux-mêmes.
Cherchez d'abord si le cas est déjà signalé — plusieurs de ceux de cette page l'étaient — et indiquez toujours trois choses : la version d'OpenWhispr, le système et sa version, et si vous transcrivez en local ou dans le cloud.
Site non officiel.
Ce site est un guide indépendant en français et n'est pas affilié au projet OpenWhispr ni à ses auteurs. OpenWhispr est une marque de ses titulaires respectifs et est publié sous licence MIT. Le site officiel est openwhispr.com et le code source se trouve sur GitHub.