La CLI di MacWhisper: installare mw, trascrivere da Terminale e tutte le opzioni
Di Ryleigh Newman · Pubblicato il
MacWhisper include uno strumento da riga di comando che si chiama mw. Controlla l'app da Terminale: trascrive file e intere cartelle, riconosce chi parla, scrive sottotitoli o JSON, elenca i modelli e li cambia. Parla con l'app MacWhisper in esecuzione tramite un socket locale, quindi usa i motori, i modelli e le impostazioni che hai già configurato, e avvia l'app se non è aperta.
Io creo YapToText, un'altra app per Mac per la dettatura e la trascrizione di file, quindi leggi ciò che dico su MacWhisper tenendolo presente. Ogni fatto su MacWhisper qui riportato viene dal suo articolo di aiuto MacWhisper Command-Line Tool, letto il 10 ottobre 2026.
Download gratuito. Senza account e senza niente di bloccato, per macOS 14 o versioni successive su un Mac con chip Apple. Codice sorgente su GitHub.
Questa guida in altre lingue: English, العربية, Čeština, Dansk, Deutsch, Ελληνικά, Español, Suomi, Français, עברית, हिन्दी, Magyar, Bahasa Indonesia, 日本語, 한국어, Norsk, Nederlands, Polski, Português, Română, Русский, Slovenčina, Svenska, ไทย, Türkçe, Українська, Tiếng Việt, 简体中文, 繁體中文
In questa pagina: 13 sezioni
Installare mw
- Apri MacWhisper, poi Settings (le impostazioni), poi Advanced (avanzate).
- Sotto Command-Line Tool (lo strumento da riga di comando), fai clic su Install.
- Inserisci la password del Mac se macOS la chiede. Serve per scrivere in /usr/local/bin.
- Apri una nuova finestra di Terminale ed esegui mw version.
Lo strumento viene installato in /usr/local/bin/mw e, a installazione finita, il pannello delle impostazioni mostra un segno di spunta verde. Se mw version stampa un numero di versione, funziona. Per rimuoverlo, torna nello stesso pannello e fai clic su Uninstall.
Trascrivere un file
mw transcribe ~/Desktop/meeting.m4a
mw transcribe meeting.m4a > transcript.txt
mw transcribe meeting.m4a -o transcript.txt
mw transcribe meeting.m4a | pbcopyCosa succede: La trascrizione viene stampata sullo standard output. Una riga di avanzamento va sullo standard error, quindi un file ottenuto con il reindirizzamento contiene solo la trascrizione.
Per impostazione predefinita una trascrizione da riga di comando non viene conservata. Viene stampata e scartata, e compare nella cronologia di MacWhisper solo se aggiungi --persist. Ctrl+C interrompe l'esecuzione. Un file di output già esistente non viene mai sostituito, a meno che tu non aggiunga --overwrite.
I comandi
Dall'articolo di aiuto di MacWhisper, letto il 10 ottobre 2026. Aggiungi --help a qualsiasi comando per vederne le opzioni.
| Comando | Cosa fa |
|---|---|
| mw | Un riepilogo dello stato: se l'app è raggiungibile, il modello selezionato, i modelli scaricati ed esempi di comandi |
| mw version | Stampa la versione di MacWhisper. Utile per verificare la connessione |
| mw models list | Elenca i modelli di trascrizione installati, con un ID per ciascuno |
| mw models select | Cambia il modello attivo, sia nello strumento da riga di comando sia nell'app |
| mw transcribe | Trascrive file audio o video, o intere cartelle, e stampa il testo |
Le opzioni di mw transcribe
Dallo stesso articolo. Una lingua che il modello scelto non sa trascrivere produce un errore.
| Opzione | Cosa fa |
|---|---|
| --speakers, --no-speakers | Attiva o disattiva il riconoscimento di chi parla per questa esecuzione. Se è attivo, la trascrizione è raggruppata per persona che parla |
| --format | txt, il valore predefinito, oppure srt, vtt, json, csv, md, html o avid |
| --style | transcript, subtitles o segments, gli stessi stili del pannello Esporta dell'app |
| --model | Usa un solo modello per questa esecuzione, senza cambiare la selezione dell'app |
| --language | Un codice ISO come en o de, oppure auto, oppure multilingual |
| --output, -o | Scrive la trascrizione in un file |
| --output-dir | Modalità batch. Scrive una trascrizione per ogni file di input in una cartella |
| --recursive | Include le sottocartelle quando indichi una cartella |
| --stream | Stampa i segmenti man mano che sono pronti. Solo con i motori locali |
| --persist | Conserva la trascrizione nella cronologia di MacWhisper |
| --timestamps, --milliseconds, --group, --max-chars-per-line, --fps | Regolano nel dettaglio l'impaginazione |
Formati e quali richiedono Pro
Dallo stesso articolo. La pagina dei prezzi di MacWhisper spiega quanto costa Pro.
| Formato | Cosa ottieni | Licenza |
|---|---|---|
| txt | Testo semplice | Tutti |
| srt | Sottotitoli SubRip | Tutti |
| vtt | Sottotitoli WebVTT | Tutti |
| csv | Righe con inizio, fine e trascrizione, più chi parla quando viene riconosciuto | Tutti |
| json | Marcatori temporali al millisecondo, chi parla per ogni segmento e i tempi delle singole parole | Pro |
| md | Markdown con blocchi con marcatori temporali e titoli per chi parla | Pro |
| html | Un documento HTML autonomo | Pro |
| avid | Testo dei sottotitoli Avid con timecode SMPTE | Pro |
Intere cartelle
mw transcribe ~/Recordings --recursive --output-dir ~/Transcripts
mw transcribe ~/Videos --output-dir ~/Subs --format srt
mw transcribe interview.m4a --speakers -o interview.txtCosa succede: Ogni file di input ottiene un proprio file di output, con lo stesso nome, e la struttura delle cartelle viene riprodotta. Un file che dà errore viene segnalato e saltato, e l'esecuzione continua.
Il riconoscimento di chi parla richiede un modello che lo supporti. La pagina sul riconoscimento di chi parla tratta questo lato dell'app.
Quando non funziona
- mw: command not found. Apri una nuova finestra di Terminale, oppure aggiungi /usr/local/bin al tuo PATH.
- Si blocca. Chiudi e riapri MacWhisper, poi prova mw version.
- Un ID di modello non viene riconosciuto. Esegui mw models list per vedere gli ID esatti e scarica prima il modello nell'app.
- Un errore Pro su un formato. json, md, html e avid richiedono una licenza Pro.
- Un errore di sandbox. Un programma in sandbox, compresi alcuni strumenti di programmazione con IA, può essere bloccato dal socket di MacWhisper. Esegui mw direttamente in Terminale.
La pagina di risoluzione dei problemi di MacWhisper tratta l'app stessa.
Strade gratuite da Terminale
YapToText non ha uno strumento da riga di comando. Trascrive un file che trascini sull'app, uno alla volta, in testo semplice e gratis. Se vuoi usare il Terminale senza comprare nulla, whisper.cpp è open source ed è il motore su cui è costruita YapToText. La guida a Whisper in locale contiene i comandi, e la pagina sui software di trascrizione open source mette a confronto quattro strumenti gratuiti.
Download gratuito. Senza account e senza niente di bloccato, per macOS 14 o versioni successive su un Mac con chip Apple. Codice sorgente su GitHub.
In breve
- Installa. Settings, Advanced, Command-Line Tool, Install.
- Esegui. mw transcribe, poi un file o una cartella.
- Formati gratuiti. txt, srt, vtt e csv.
- Formati Pro. json, md, html e avid.
- Cronologia. Non viene conservato nulla, a meno che tu non aggiunga --persist.
Se MacWhisper cambia lo strumento e questa pagina resta indietro, apri una issue su GitHub. Le leggo tutte.
Download gratuito. Senza account e senza niente di bloccato, per macOS 14 o versioni successive su un Mac con chip Apple. Codice sorgente su GitHub.
Guide
Altre guide, in inglese
Fonti
- https://docs.macwhisper.com/article/57-macwhisper-command-line-tool (consultato il 10 ottobre 2026)
- https://github.com/ryleighnewman/YapToText (consultato il 10 ottobre 2026)
- https://apps.apple.com/us/app/yaptotext/id6786382289 (consultato il 10 ottobre 2026)
Domande
MacWhisper ha uno strumento da riga di comando?
Sì. Si chiama mw e si installa dalle impostazioni di MacWhisper, sotto Advanced, Command-Line Tool.
Come si trascrive un file con MacWhisper da Terminale?
Esegui mw transcribe seguito dal percorso del file. La trascrizione viene stampata sullo standard output, oppure in un file con -o.
La CLI di MacWhisper è gratuita?
Il suo articolo di aiuto dice che l'output txt, srt, vtt e csv è disponibile per tutti e che json, md, html e avid richiedono una licenza Pro.
La CLI di MacWhisper può trascrivere un'intera cartella?
Sì. Indica una cartella a mw transcribe, aggiungi --recursive per le sottocartelle e --output-dir per scrivere una trascrizione per ogni file.
mw ha bisogno che MacWhisper sia aperto?
Parla con l'app in esecuzione e avvia MacWhisper automaticamente se non è aperto.