Guida indipendente · Risoluzione dei problemi
Quando OpenWhispr non funziona
Quasi tutto ciò che non funziona in OpenWhispr non funziona per lo stesso motivo: un permesso che il sistema concede e l'applicazione non riconosce, o uno strumento che manca. Qui trovi i casi reali con la loro soluzione, divisi per sistema, perché il programma non si comporta allo stesso modo su tutti e tre.
Comincia da qui
Entra dal tuo sistema: ognuno si comporta in modo diverso e ha il suo elenco.
Cosa cambia da un sistema all'altro
Questa tabella è il motivo per cui la pagina è divisa per piattaforme: non sono sfumature, sono comportamenti diversi.
| macOS | Windows | Linux | |
|---|---|---|---|
| Tenere premuto per registrare | sì | sì con il suo ausiliario | no non supportato |
| Cosa scrive il testo | permesso di accessibilità | windows-fast-paste | linux-fast-paste, oppure xdotool / wtype |
| Dove tiene i modelli | ~/.cache/openwhispr/ | %USERPROFILE%\.cache\openwhispr\ | ~/.cache/openwhispr/ |
| Disinstallando cancella i modelli | no a mano | sì | dipende sì con .deb e .rpm, no con AppImage |
| Minimo per funzionare | macOS 12 · 13.3 per trascrivere sul dispositivo | Windows 10 x64 | x64 con PulseAudio o PipeWire |
GEN-01 Il caso più frequente
Trascrive, ma non scrive il testo
Non hai perso quello che hai dettato. OpenWhispr copia sempre il testo negli appunti, anche quando l'incollaggio automatico non riesce: lo incolli a mano con ⌘V o Ctrl+V e vai avanti.
Da lì la causa dipende dal sistema: su macOS è quasi sempre il permesso di accessibilità (MAC-01) e su Linux uno strumento che manca (LNX-01).
GEN-02 Configurazione
Non rileva l'audio
Tre controlli, in questo ordine:
- Che il permesso del microfono sia concesso.
- Che nelle impostazioni audio del sistema sia selezionato l'ingresso che stai davvero usando.
- Che nelle impostazioni di OpenWhispr compaia lo stesso dispositivo.
Cambiare dispositivo di ingresso e tornare indietro risolve buona parte dei casi. L'applicazione ha anche una modalità di debug che registra il livello audio: se lì non si muove nulla, il problema sta prima del programma.
GEN-03 Configurazione
Trascrive vuoto o non trascrive niente
Con la trascrizione locale, di solito il modello non è scaricato del tutto — si verifica in Impostazioni → Riconoscimento vocale — oppure manca spazio su disco: i modelli vanno da 75 MB a 1,6 GB. In modalità cloud, controlla invece che la chiave API sia valida e abbia credito.
Passare da locale a cloud, o viceversa, è il modo rapido di sapere da che lato è il problema.
GEN-04 Segnalazione aperta
Scrive frasi che non hai detto
Nei silenzi il modello Whisper può «allucinare» e infilare frasi di chiusura da video; la più segnalata è «Thank you for watching!». Non è un difetto di OpenWhispr ma un comportamento noto del modello, ed è aperto come segnalazione.
Cosa aiuta: rilasciare la scorciatoia appena hai finito di parlare, invece di lasciare la registrazione aperta sul silenzio.
GEN-05 Conflitto di tasti
La scorciatoia non risponde
Il caso più comune è un conflitto con un altro programma o con una scorciatoia di sistema. Si può cambiare la combinazione nelle impostazioni, o definire una scorciatoia di riserva.
Il «tieni premuto e rilascia» non funziona allo stesso modo sui tre sistemi: su Linux non è disponibile. Lo spiega LNX-02.
Piattaforma 01
macOS
MAC-01 Segnalazione aperta
Trascrive ma non scrive: il permesso di accessibilità
È l'ostacolo numero uno. macOS concede il permesso di accessibilità e l'applicazione non lo riconosce, così trascrive ma non riesce a scrivere nella finestra che hai davanti. È una segnalazione aperta da marzo, e questi sono i passaggi indicati dal manutentore:
- Apri Impostazioni di Sistema → Privacy e sicurezza → Accessibilità.
- Cerca OpenWhispr, e anche qualsiasi voce chiamata «Electron», e rimuovile con il pulsante −.
- Aggiungi di nuovo OpenWhispr con il pulsante +, dalla cartella Applicazioni.
- Controlla che l'interruttore resti attivo.
- Riavvia OpenWhispr.
Trascina l'applicazione nella cartella Applicazioni prima di aprirla la prima volta. Se viene eseguita dal .dmg montato, macOS associa il permesso a un percorso che poi scompare e il problema torna.
MAC-02 Comportamento previsto
«Impossibile verificare lo sviluppatore»
Il programma non è firmato con un certificato a pagamento, quindi la prima volta macOS lo blocca. Si risolve con clic destro sull'applicazione → «Apri», o autorizzandola in Impostazioni di Sistema → Privacy e sicurezza.
Non è un segno che il file sia sospetto: firmare costa, e molti progetti liberi non lo fanno.
MAC-03 Requisito
Il tuo Mac non arriva alla versione minima
Il progetto richiede macOS 12 (Monterey) o successivo per funzionare, e macOS 13.3 (Ventura) o successivo per trascrivere sul dispositivo stesso. Se il tuo Mac resta sotto la 13.3, la modalità locale non è un'opzione e rimane solo il cloud.
MAC-04 Segnalazione aperta
Il tasto Globo o Fn si comporta in modo irregolare
Su Mac si può usare il tasto Globo (🌐) o Fn come scorciatoia di dettatura, con un vantaggio concreto: nelle versioni pacchettizzate non richiede il permesso di «monitoraggio dell'input».
Ci sono però casi aperti di conflitto con scorciatoie di sistema e di combinazioni che rispondono in modo incoerente. Se ti capita, usa una normale combinazione di tasti.
MAC-05 Segnalazione aperta
L'impostazione degli appunti non viene rispettata
C'è una segnalazione aperta sull'impostazione degli appunti su macOS: può non comportarsi come configurato. Se il contenuto degli appunti ti interessa, dai per scontato che OpenWhispr lo sovrascriva mentre detti.
MAC-06 Come si fa
Disinstallarlo del tutto
Cancellare l'applicazione non cancella i modelli, che sono ciò che occupa spazio. Su macOS vanno rimossi a mano:
- Modelli: ~/.cache/openwhispr/
- Dati dell'applicazione: ~/Library/Application Support/OpenWhispr/
Piattaforma 02
Windows
WIN-01 Comportamento previsto
SmartScreen blocca l'installer
Per lo stesso motivo del Mac: l'installer non è firmato con un certificato a pagamento. Compare l'avviso e bisogna premere «Ulteriori informazioni» → «Esegui comunque». L'installazione non chiede permessi di amministratore.
WIN-02 Diagnosi
Funziona solo premere, non tenere premuto
Windows supporta il «tieni premuto per registrare, rilascia per fermare», e lo fa con un programma ausiliario proprio che si installa con l'applicazione (windows-key-listener.exe).
Se quell'ausiliario non è disponibile, l'applicazione passa automaticamente alla modalità «premi per attivare/disattivare». È esattamente ciò che spiega il sintomo di tenere premuto senza risultato. Reinstallare di solito lo rimette a posto.
Accetta anche combinazioni complesse del tipo Ctrl+Maiusc+F11.
WIN-03 Come funziona
Non incolla il testo nel terminale
L'incollaggio lo fa un altro ausiliario (windows-fast-paste) ed è più furbo di quanto sembri: nei programmi normali invia Ctrl+V, ma quando rileva un terminale invia Ctrl+Maiusc+V, che è ciò che i terminali si aspettano.
Riconosce Windows Terminal, cmd, PowerShell, mintty, PuTTY, Alacritty, WezTerm, kitty, Hyper, MobaXterm e ConEmu. Se il tuo terminale non è nell'elenco, l'incollaggio può non riuscire e il testo resta negli appunti.
WIN-04 Requisito
Non cattura l'audio del sistema
Per registrare il suono del computer stesso — e non solo il microfono — serve Windows 10 versione 2004 o successiva. Il programma richiede l'architettura x64.
WIN-05 Segnalazione aperta
L'accelerazione GPU risulta attiva ma non fa nulla
C'è una segnalazione aperta: l'interfaccia mostra l'accelerazione Vulkan come attiva quando in realtà non lo è. Se la trascrizione è lenta e conti sulla GPU, è il primo punto da controllare.
Per i computer con più schede è inoltre in corso il lavoro per poter scegliere quale usare.
WIN-06 Segnalazione aperta
I modelli si scaricano dove non dovrebbero
La cache dei modelli si trova in %USERPROFILE%\.cache\openwhispr\. Se hai reindirizzato le cartelle utente su un'altra unità, tieni presente questa segnalazione aperta: la cache ignora il reindirizzamento e scrive nel percorso originale. Conta quando il disco di sistema è al limite.
Piattaforma 03
Linux
LNX-01 Manca uno strumento
Trascrive ma non incolla il testo
L'incollaggio lo fa un ausiliario proprio (linux-fast-paste) che copre X11 e Wayland. Quando non è disponibile servono gli strumenti di sistema:
- X11: xdotool.
- Wayland: wtype, oppure ydotool — che richiede anche il suo demone in esecuzione.
Senza nessuno dei due la trascrizione avviene comunque, ma il testo resta negli appunti.
Su GNOME con Wayland c'è una segnalazione aperta: l'incollaggio non riesce in silenzio, senza avvisare.
LNX-02 Non supportato
Qui il «tieni premuto» non esiste
È la differenza più importante rispetto agli altri due sistemi, e conviene dirla senza giri di parole: su GNOME la modalità a pressione continua non è disponibile, e su Hyprland nemmeno.
Non è un errore di configurazione e non si sistema: non è supportato. Si detta premendo per iniziare e premendo per finire.
LNX-03 Dipende dal desktop
La scorciatoia non viene registrata
- GNOME: le scorciatoie si registrano tramite D-Bus e gsettings, quindi compaiono nelle impostazioni di sistema. Quando la scorciatoia normale non funziona, quella di riserva è F8.
- KDE Plasma: integrazione nativa via D-Bus, senza altro.
- Hyprland: richiede hyprctl — è incluso — e la scorciatoia viene registrata di nuovo a ogni avvio, quindi deve essere raggiungibile nel PATH.
LNX-04 Risolto: aggiorna
Errori della trascrizione locale
È il thread più lungo di tutto il repository: gli errori di Whisper locale su Linux hanno 32 commenti e sono risolti. Quindi la prima cosa è aggiornare all'ultima versione prima di indagare altro.
Per l'audio servono PulseAudio o PipeWire. L'architettura supportata è x64: il supporto ad ARM (aarch64) è pianificato ma non disponibile.
LNX-05 Come si fa
Quale formato installare, e cosa resta dopo la disinstallazione
- .deb — Debian, Ubuntu, Mint, Pop!_OS
- .rpm — Fedora, RHEL, openSUSE
- .AppImage — qualsiasi distribuzione, senza installare nulla
- .tar.gz — universale
Alla disinstallazione, .deb e .rpm portano via la cache dei modelli; con AppImage e tar.gz va cancellata ~/.cache/openwhispr/ a mano.
Se niente di tutto questo lo risolve
Questo sito non è il supporto del progetto e non può risolvere casi specifici. Quando il problema non è in questa pagina, il posto giusto è il registro delle segnalazioni, in inglese, dove rispondono gli autori stessi.
Cerca prima se è già stata segnalata — diverse di questa pagina lo erano — e indica sempre tre cose: la versione di OpenWhispr, il sistema e la sua versione, e se usi la trascrizione in locale o nel cloud.
Sito non ufficiale.
Questo sito è una guida indipendente in italiano e non è affiliato al progetto OpenWhispr né ai suoi autori. OpenWhispr è marchio dei rispettivi titolari ed è pubblicato con licenza MIT. Il sito ufficiale è openwhispr.com e il codice sorgente è su GitHub.