La CLI de MacWhisper : installer mw, transcrire depuis le Terminal et toutes les options
Par Ryleigh Newman · Publié le
MacWhisper est fourni avec un outil en ligne de commande qui s'appelle mw. Il pilote l'app depuis le Terminal : transcrire des fichiers et des dossiers entiers, détecter les interlocuteurs, écrire des sous-titres ou du JSON, lister les modèles et en changer. Il parle à l'app MacWhisper en cours d'exécution par un socket local, donc il utilise les moteurs, les modèles et les réglages que vous avez déjà configurés, et il lance l'app si elle n'est pas ouverte.
Je crée YapToText, une autre app pour Mac, pour la dictée et la transcription de fichiers, donc lisez ce que je dis de MacWhisper en le sachant. Tous les faits sur MacWhisper viennent de son article d'aide MacWhisper Command-Line Tool, lu le 10 octobre 2026.
Téléchargement gratuit. Sans compte, sans rien de verrouillé, pour macOS 14 ou ultérieur sur un Mac avec puce Apple. Code source sur GitHub.
Ce guide dans d'autres langues : English, العربية, Čeština, Dansk, Deutsch, Ελληνικά, Español, Suomi, עברית, हिन्दी, Magyar, Bahasa Indonesia, Italiano, 日本語, 한국어, Norsk, Nederlands, Polski, Português, Română, Русский, Slovenčina, Svenska, ไทย, Türkçe, Українська, Tiếng Việt, 简体中文, 繁體中文
Sur cette page : 12 sections
Installer mw
- Ouvrez MacWhisper, puis Settings (les réglages), puis Advanced.
- Sous Command-Line Tool, cliquez sur Install.
- Saisissez le mot de passe de votre Mac si macOS le demande. Il sert à écrire dans /usr/local/bin.
- Ouvrez une nouvelle fenêtre du Terminal et exécutez mw version.
L'outil se place dans /usr/local/bin/mw, et le volet des réglages affiche une coche verte quand c'est fait. Si mw version affiche un numéro de version, l'outil fonctionne. Pour le retirer, revenez dans le même volet et cliquez sur Uninstall.
Transcrire un fichier
mw transcribe ~/Desktop/meeting.m4a
mw transcribe meeting.m4a > transcript.txt
mw transcribe meeting.m4a -o transcript.txt
mw transcribe meeting.m4a | pbcopyCe qui se passe : La transcription s'affiche sur la sortie standard. Une ligne de progression part sur la sortie d'erreur, donc un fichier redirigé ne contient que la transcription.
Par défaut, une transcription faite en ligne de commande n'est pas conservée. Elle est affichée puis jetée, et elle n'apparaît dans l'historique de MacWhisper que si vous ajoutez --persist. Ctrl+C interrompt l'exécution. Un fichier de sortie existant n'est jamais remplacé, sauf si vous ajoutez --overwrite.
Les commandes
D'après l'article d'aide de MacWhisper, lu le 10 octobre 2026. Ajoutez --help à n'importe quelle commande pour voir ses options.
| Commande | Ce qu'elle fait |
|---|---|
| mw | Un aperçu de l'état : si l'app est joignable, le modèle sélectionné, les modèles téléchargés et des exemples de commandes |
| mw version | Affiche la version de MacWhisper. Pratique pour vérifier la connexion |
| mw models list | Liste vos modèles de transcription installés, avec un identifiant pour chacun |
| mw models select | Change le modèle actif, dans l'outil en ligne de commande et dans l'app |
| mw transcribe | Transcrit des fichiers audio ou vidéo, ou des dossiers entiers, et affiche le texte |
Les options de mw transcribe
D'après le même article. Une langue que le modèle choisi ne sait pas transcrire provoque une erreur.
| Option | Ce qu'elle fait |
|---|---|
| --speakers, --no-speakers | Active ou désactive la détection des interlocuteurs pour cette exécution. Activée, elle regroupe la transcription par interlocuteur |
| --format | txt, la valeur par défaut, ou srt, vtt, json, csv, md, html ou avid |
| --style | transcript, subtitles ou segments, les mêmes styles que le panneau d'export de l'app |
| --model | Utilise un modèle pour cette exécution sans changer la sélection de l'app |
| --language | Un code ISO comme en ou de, ou auto, ou multilingual |
| --output, -o | Écrit la transcription dans un fichier |
| --output-dir | Mode par lot. Écrit une transcription par fichier d'entrée dans un dossier |
| --recursive | Inclut les sous-dossiers quand vous passez un dossier |
| --stream | Affiche les segments au fur et à mesure qu'ils sont terminés. Moteurs locaux uniquement |
| --persist | Conserve la transcription dans l'historique de MacWhisper |
| --timestamps, --milliseconds, --group, --max-chars-per-line, --fps | Affinent la mise en page |
Les formats, et ceux qui demandent Pro
D'après le même article. La page des tarifs de MacWhisper explique ce que coûte l'offre Pro.
| Format | Ce que vous obtenez | Licence |
|---|---|---|
| txt | Texte brut | Tout le monde |
| srt | Sous-titres SubRip | Tout le monde |
| vtt | Sous-titres WebVTT | Tout le monde |
| csv | Des lignes avec début, fin et transcription, plus l'interlocuteur quand il est détecté | Tout le monde |
| json | Horodatage à la milliseconde, interlocuteurs par segment et durées des mots | Pro |
| md | Markdown avec des blocs horodatés et des titres d'interlocuteurs | Pro |
| html | Un document HTML autonome | Pro |
| avid | Texte de sous-titres Avid avec timecodes SMPTE | Pro |
Des dossiers entiers
mw transcribe ~/Recordings --recursive --output-dir ~/Transcripts
mw transcribe ~/Videos --output-dir ~/Subs --format srt
mw transcribe interview.m4a --speakers -o interview.txtCe qui se passe : Chaque fichier d'entrée obtient son propre fichier de sortie, qui porte son nom, et l'arborescence des dossiers est reproduite. Un fichier qui échoue est signalé puis ignoré, et l'exécution continue.
La détection des interlocuteurs demande un modèle qui la prend en charge. La page sur la reconnaissance des interlocuteurs traite de ce côté de l'app.
Quand ça ne fonctionne pas
- mw: command not found. Ouvrez une nouvelle fenêtre du Terminal, ou ajoutez /usr/local/bin à votre PATH.
- Il se bloque. Quittez MacWhisper et rouvrez-le, puis essayez mw version.
- Un identifiant de modèle n'est pas reconnu. Exécutez mw models list pour obtenir les identifiants exacts, et téléchargez d'abord le modèle dans l'app.
- Une erreur Pro sur un format. json, md, html et avid demandent une licence Pro.
- Une erreur de sandbox. Un programme en sandbox, dont certains outils de programmation à base d'IA, peut se voir bloquer l'accès au socket de MacWhisper. Exécutez mw directement dans le Terminal.
La page de dépannage de MacWhisper traite de l'app elle-même.
Les solutions gratuites depuis le Terminal
YapToText n'a pas d'outil en ligne de commande. Il transcrit un fichier que vous déposez dessus, un à la fois, en texte brut, gratuitement. Si vous voulez le Terminal sans rien acheter, whisper.cpp est open source et c'est le moteur sur lequel YapToText est construit. Le guide de Whisper en local donne les commandes, et la page sur les logiciels de transcription open source compare quatre outils gratuits.
Téléchargement gratuit. Sans compte, sans rien de verrouillé, pour macOS 14 ou ultérieur sur un Mac avec puce Apple. Code source sur GitHub.
En bref
- Installation. Settings, Advanced, Command-Line Tool, Install.
- Exécution. mw transcribe, puis un fichier ou un dossier.
- Formats gratuits. txt, srt, vtt et csv.
- Formats Pro. json, md, html et avid.
- Historique. Rien n'est conservé sans --persist.
Si MacWhisper modifie l'outil et que cette page n'est plus à jour, ouvrez une issue sur GitHub. Je les lis toutes.
Téléchargement gratuit. Sans compte, sans rien de verrouillé, pour macOS 14 ou ultérieur sur un Mac avec puce Apple. Code source sur GitHub.
Guides
Autres guides, en anglais
Sources
- https://docs.macwhisper.com/article/57-macwhisper-command-line-tool (consulté le 10 octobre 2026)
- https://github.com/ryleighnewman/YapToText (consulté le 10 octobre 2026)
- https://apps.apple.com/us/app/yaptotext/id6786382289 (consulté le 10 octobre 2026)
Questions
MacWhisper a-t-il un outil en ligne de commande ?
Oui. Il s'appelle mw, et vous l'installez depuis les réglages de MacWhisper, sous Advanced, Command-Line Tool.
Comment transcrire un fichier avec MacWhisper depuis le Terminal ?
Exécutez mw transcribe suivi du chemin du fichier. La transcription s'affiche sur la sortie standard, ou dans un fichier avec -o.
La CLI de MacWhisper est-elle gratuite ?
Son article d'aide indique que les sorties txt, srt, vtt et csv sont disponibles pour tout le monde, et que json, md, html et avid demandent une licence Pro.
La CLI de MacWhisper peut-elle transcrire un dossier entier ?
Oui. Passez un dossier à mw transcribe, ajoutez --recursive pour les sous-dossiers et --output-dir pour écrire une transcription par fichier.
mw demande-t-il que MacWhisper soit ouvert ?
Il parle à l'app en cours d'exécution, et lance MacWhisper automatiquement s'il n'est pas ouvert.