Dictate with MacWhisper

Ce que fait l’extension

1. Vous appuyez sur ctrl+alt+space (⌃⌥Space). La barre d’état affiche Recording… et ffmpeg enregistre votre micro.
2. Vous appuyez à nouveau. L’enregistrement part vers l’outil en ligne de commande mw de MacWhisper sur votre Mac, qui le transcrit avec le moteur choisi dans l’application.
3. Le texte est inséré à chaque curseur par l’API de l’éditeur et remplace la sélection éventuelle. Comme l’extension tourne sur votre Mac, cela fonctionne aussi dans les fenêtres Remote-SSH, WSL et dev container.

Confidentialité. Par défaut, l’extension n’effectue aucune requête réseau. L’audio va vers mw de MacWhisper sur votre Mac, et MacWhisper utilise le moteur que vous avez choisi dans l’application : avec un moteur local, rien ne quitte le Mac ; avec un moteur cloud, MacWhisper y envoie l’audio, comme pour toute transcription. La passe de nettoyage optionnelle (désactivée par défaut) envoie le texte de la transcription, jamais l’audio, au point d’accès Ollama que vous configurez : avec un Ollama local, il reste sur le Mac ; avec un point d’accès distant, le texte quitte le Mac. Pas de clé API, pas de télémétrie, et l’extension ne télécharge aucun modèle.

Installation

1. MacWhisper depuis macwhisper.com. La version du Mac App Store n’a pas l’outil mw.
2. L’outil en ligne de commande mw : dans MacWhisper, ouvrez Settings → Advanced → Command-Line Tool → Install. L’extension trouve aussi la copie incluse dans MacWhisper.app si vous sautez cette étape.
3. ffmpeg pour la capture du micro : brew install ffmpeg.
4. L’extension depuis le Marketplace ou Open VSX. Appuyez sur ⌃⌥Space dans un éditeur ; macOS demande une fois si Visual Studio Code peut utiliser le micro. Si vous avez refusé, autorisez-le sous Réglages Système → Confidentialité et sécurité → Microphone.

Si vous utilisez plusieurs dispositions de clavier, macOS associe ⌃⌥Space à « Sélectionner la source d’entrée précédente » et intercepte le raccourci. Désactivez-le sous Réglages Système → Clavier → Raccourcis clavier → Sources d’entrée, ou réassignez la commande dans VS Code (Keyboard Shortcuts → « Dictate with MacWhisper: Toggle »).

Le paquet est sous licence MIT. Son code est inclus non minifié dans l’extension installée ; chacun peut le lire dans ~/.vscode/extensions.

Réglages

Tous les réglages sauf macwhisperDictate.language sont des réglages utilisateur : un espace de travail ne peut pas les modifier.

Quel modèle. L’extension utilise le modèle choisi dans MacWhisper, sauf si macwhisperDictate.model est défini. Pour une dictée mêlant polonais et anglais, Whisper Large v3 Turbo avec la langue « Auto Detect » a mieux fonctionné pour moi que Parakeet v3 ; Parakeet v3 est plus rapide.

Nettoyage avec un modèle local

La dictée arrive d’un seul tenant, sans ponctuation. En option, et désactivé par défaut, l’extension envoie la transcription à un petit modèle local auquel on demande d’ajouter uniquement la ponctuation et les majuscules. Testé avec gemma3:4b sur Ollama : une à trois secondes sur un M4 Pro.

brew install ollama && brew services start ollama
ollama pull gemma3:4b

Réglez ensuite macwhisperDictate.cleanup.endpoint sur http://127.0.0.1:11434. La réponse du modèle n’est acceptée que si elle contient exactement les mots dictés dans le même ordre, casse et ponctuation mises à part. Si le modèle a changé, supprimé, ajouté ou déplacé un mot, n’a pas terminé, ou n’a pas répondu dans les 20 secondes, la transcription brute est utilisée et un avertissement le signale. Cette vérification détecte les mots changés, pas un sens modifié par la seule ponctuation. macwhisperDictate.cleanup.model choisit le modèle et macwhisperDictate.cleanup.prompt remplace le prompt intégré.

La dictée intégrée de MacWhisper face à cette extension

Gardez les deux. Le raccourci pour Mail et Slack, l’extension pour l’éditeur.

Questions

Pourquoi l’extension a-t-elle besoin de ffmpeg ?

VS Code n’offre aux extensions aucune API de micro, il faut donc un petit enregistreur : ffmpeg enregistre le micro dans un fichier temporaire sur votre Mac, supprimé à la fin de la dictée. Installation avec brew install ffmpeg ; le réglage par défaut cherche dans /opt/homebrew/bin, /usr/local/bin puis dans le PATH.

L’audio quitte-t-il mon Mac ?

Par défaut, non. L’audio va vers l’outil mw de MacWhisper sur votre Mac, et MacWhisper utilise le moteur choisi dans l’application : avec un moteur local, rien ne quitte le Mac ; avec un moteur cloud, MacWhisper y envoie l’audio, comme pour toute transcription. La passe de nettoyage optionnelle envoie le texte de la transcription, jamais l’audio, au point d’accès Ollama que vous configurez. L’extension n’effectue aucune autre requête réseau et n’a pas de télémétrie.

Cela fonctionne-t-il avec la version Mac App Store de MacWhisper ?

Non. La version du Mac App Store n’a pas l’outil en ligne de commande mw. Installez MacWhisper depuis macwhisper.com, puis l’outil sous Settings → Advanced → Command-Line Tool → Install ; l’extension trouve aussi la copie incluse dans MacWhisper.app.

Le raccourci ne fonctionne pas. Que vérifier ?

Si vous utilisez plusieurs dispositions de clavier, macOS associe ⌃⌥Space à « Sélectionner la source d’entrée précédente » et intercepte le raccourci. Désactivez-le sous Réglages Système → Clavier → Raccourcis clavier → Sources d’entrée, ou réassignez la commande dans VS Code sous Keyboard Shortcuts. Si la barre d’état signale qu’aucun son n’a été capturé, autorisez Visual Studio Code à utiliser le micro sous Réglages Système → Confidentialité et sécurité → Microphone.

Quel modèle utiliser pour le polonais et l’anglais ?

L’extension utilise le modèle choisi dans MacWhisper, sauf si macwhisperDictate.model est défini. Pour une dictée mêlant polonais et anglais, Whisper Large v3 Turbo avec la langue « Auto Detect » a mieux fonctionné pour moi que Parakeet v3. Parakeet v3 est plus rapide.