Risoluzione dei problemi

“Local Transcriber non puo essere aperto”

Questo e il Gatekeeper di macOS. L’app e firmata e autenticata da Apple, ma Gatekeeper potrebbe comunque mostrare questo messaggio al primo avvio.

Soluzione: Fai clic destro sull’app in Applicazioni → seleziona Apri → fai clic su Apri nella finestra di dialogo. Devi farlo solo una volta.

Nessun audio viene catturato

Se l’app inizia a registrare ma non appare alcun testo:

1. Verifica l’autorizzazione del microfono. Vai in Impostazioni di Sistema → Privacy e sicurezza → Microfono e assicurati che Local Transcriber sia attivato.
2. Verifica l’autorizzazione del riconoscimento vocale. Vai in Impostazioni di Sistema → Privacy e sicurezza → Riconoscimento vocale e assicurati che Local Transcriber sia attivato.
3. Riavvia l’app dopo aver concesso le autorizzazioni — macOS a volte non rileva le modifiche alle autorizzazioni finche l’app non viene riavviata.
4. Verifica l’uscita audio. L’app cattura l’audio di sistema dall’uscita audio del tuo Mac. Se stai instradando l’audio tramite un dispositivo esterno che macOS non riconosce come uscita predefinita, la cattura dell’audio di sistema potrebbe non funzionare.

Viene catturato solo un lato della chiamata

Se vedi la tua voce ma non quella dell’altra persona (o viceversa):

• Audio di sistema (l’altra persona) proviene dall’uscita audio del tuo Mac. Assicurati che l’audio della chiamata venga riprodotto tramite gli altoparlanti del Mac o delle cuffie collegate al Mac.
• Audio del microfono (la tua voce) proviene dal microfono utilizzato dal tuo Mac. Verifica in Impostazioni di Sistema → Suono → Ingresso che sia selezionato il microfono corretto.

La trascrizione e imprecisa

Il riconoscimento vocale on-device e performante ma non perfetto. Ecco cosa puo aiutare:

• Parla chiaramente ed evita di borbottare.
• Riduci il rumore di fondo — chiudi le finestre, disattiva le notifiche.
• Usa cuffie con microfono — questo fornisce il segnale audio piu pulito.
• Attendi il post-processing — la trascrizione in diretta e una bozza. Il post-processing (che viene eseguito automaticamente all’interruzione) migliora significativamente la precisione.

Il post-processing sembra bloccato

Il post-processing richiede generalmente da 10 a 30 secondi per una riunione di 30 minuti. Se sembra bloccato:

1. Verifica lo stato. Guarda la barra laterale — mostra “Elaborazione in corso” con un indicatore rotante durante il lavoro.
2. Verifica il log. Apri il Terminale ed esegui:

   tail -f ~/.transcriber/engine.log

   Questo mostra cosa sta facendo l’app in tempo reale.
3. La prima esecuzione e piu lenta. La prima volta che registri, l’app scarica i modelli vocali (~50 MB). Questo avviene solo una volta.

I modelli non si caricano

Al primo avvio, l’app scarica i modelli di riconoscimento vocale e di diarizzazione on-device. Questo richiede una connessione internet. Se i modelli non si caricano:

1. Verifica la connessione internet — i modelli vengono scaricati dai server Apple.
2. Verifica lo spazio disponibile su disco — i modelli richiedono circa 200 MB di spazio libero.
3. Riavvia l’app — il download ripartira al prossimo avvio.

Una volta scaricati, i modelli vengono memorizzati nella cache e l’app funziona completamente offline.

L’app non appare nella barra dei menu

Local Transcriber mostra un’icona del microfono nella barra dei menu di macOS. Se non la vedi:

• Verifica l’overflow della barra dei menu. Se hai molti elementi nella barra dei menu, macOS potrebbe nasconderne alcuni. Cerca un chevron > nella barra dei menu.
• Assicurati che l’app sia in esecuzione. Verifica in Monitoraggio Attivita che “Local Transcriber” o “Transcriber” sia presente.

Il CLI non funziona

Se il comando transcriber non viene trovato dopo l’installazione:

1. Apri una nuova finestra del terminale — l’aggiornamento del PATH richiede una nuova sessione della shell.
2. Reinstalla — vai su Transcriber → Installa CLI e skill agente… nel menu dell’app.
3. Verifica il link simbolico — esegui ls -la /usr/local/bin/transcriber per verificare che esista e punti al bundle dell’app.

Hai bisogno di ulteriore aiuto?

Consulta il log del motore per diagnostica dettagliata:

tail -100 ~/.transcriber/engine.log

Se riscontri ancora problemi, apri una segnalazione su GitHub con l’output di log pertinente.