Guida all'installazione su macOS

Questa guida vi accompagnera nell'installazione di Sokuji sui sistemi macOS. Sokuji e disponibile come installer .pkg firmato e notarizzato che include un driver audio virtuale per capacita avanzate di elaborazione audio.

Scarica per macOS

Requisiti di sistema

macOS 13 (Ventura) o successivo (da v0.42.2; su macOS 12 continuate a usare v0.42.1)
Processore Apple Silicon (M1/M2/M3/M4) o Intel (x86_64)
4 GB di RAM minimo (8 GB consigliati)
200 MB di spazio su disco disponibile
Privilegi di amministratore (necessari per l'installazione del driver audio virtuale)
Connessione Internet per i servizi di traduzione con IA
Microfono e altoparlanti/cuffie

Passaggi dell'installazione

Passaggio 1: Scaricare Sokuji

Visitate la pagina ufficiale delle release su GitHub per scaricare l'ultima versione di Sokuji per macOS.

Scaricare l'installer PKG

Sokuji-x.x.x-arm64.pkg - Per Mac con Apple Silicon (M1/M2/M3/M4)
Sokuji-x.x.x-x64.pkg - Per Mac con Intel
Ogni installer include l'applicazione Sokuji e il driver audio virtuale
La dimensione del file e di circa 150-200 MB

Suggerimento: Non siete sicuri di quale scaricare? Cliccate sul menu Apple () → "Informazioni su questo Mac" per verificare il tipo di chip. Se vedete "Apple M1/M2/M3/M4", scegliete la versione arm64. Se vedete "Intel", scegliete la versione x64.

Dalla versione 0.46.5 l'installer PKG è firmato e notarizzato, quindi macOS lo apre senza passaggi aggiuntivi.

Passaggio 2: Installare il PKG

Installate Sokuji e il suo driver audio virtuale.

Processo di installazione

Individuate il file .pkg scaricato nella cartella Download (es., Sokuji-x.x.x-arm64.pkg o Sokuji-x.x.x-x64.pkg)
Fate doppio clic sul file PKG per avviare l'installazione
L'installer di macOS si aprira - cliccate su "Continua" per procedere
Esaminate i dettagli dell'installazione e cliccate su "Installa"
Inserite la password di amministratore quando richiesto (necessaria per l'installazione del driver)
Attendete il completamento dell'installazione (di solito 1-2 minuti)
Cliccate su "Chiudi" al termine dell'installazione

Cosa viene installato

Sokuji.app - Installato in /Applications
SokujiVirtualAudio.driver - Driver audio virtuale installato in /Library/Audio/Plug-Ins/HAL
L'installer riavviera automaticamente CoreAudio per caricare il driver

La password di amministratore e necessaria perche l'installer deve installare un driver audio a livello di sistema. Il driver audio virtuale abilita funzionalita avanzate di elaborazione audio.

Passaggio 3: Primo avvio

Aprite Sokuji dalla cartella Applicazioni. Non servono passaggi di sicurezza aggiuntivi.

Passaggio 4: Configurare Sokuji

Ora che Sokuji e in esecuzione, configuriamolo per il primo utilizzo:

Configurazione iniziale

Concedete i permessi del microfono quando macOS lo richiede
Selezionate la vostra lingua dell'interfaccia preferita
Scegliete il vostro fornitore di IA (OpenAI, Google Gemini, ecc.)
Inserite la vostra chiave API per il fornitore selezionato
Selezionate le lingue di origine e di destinazione per la traduzione
Selezionate il microfono e, nel blocco Voce, scegliete i vostri altoparlanti o le cuffie come Dispositivo di riproduzione predefinito. Sokuji non elenca lì il proprio dispositivo audio virtuale: Traduzione che sente l'altra parte vi invia la vostra traduzione, è il microfono virtuale che scegliete nell'app per riunioni
Testate la configurazione del microfono e degli altoparlanti

Congratulazioni! Sokuji e ora pronto per l'uso. Il driver audio virtuale e stato installato ed e disponibile nel vostro elenco dei dispositivi audio. Cliccate sul pulsante del microfono per avviare la traduzione in tempo reale.

Risoluzione dei problemi

Il microfono non funziona

Se Sokuji non riesce ad accedere al microfono:

Aprite Preferenze di Sistema → Sicurezza e Privacy → Privacy
Selezionate Microfono dalla barra laterale sinistra
Assicuratevi che Sokuji sia selezionato nell'elenco
Se non e nell'elenco, riavviate Sokuji e concedete il permesso quando richiesto

Nessuna uscita audio

Se non riuscite a sentire l'audio tradotto:

Aprite Preferenze di Sistema → Suono → Uscita
Selezionate il dispositivo di uscita preferito
Verificate che il volume di uscita non sia disattivato
Nel blocco Voce di Sokuji, controllate il dispositivo della riga che vi aspettate di sentire: Lo sento anche io per la vostra traduzione (disattivato per impostazione predefinita), Traduzione che sento io per quella dell'altra parte e Dispositivo di riproduzione predefinito per tutto il resto

L'app si blocca su Mac Intel o problemi di prestazioni

Assicuratevi di aver scaricato l'installer corretto per il vostro Mac:

Apple Silicon (M1/M2/M3/M4): Usate Sokuji-x.x.x-arm64.pkg
Intel: Usate Sokuji-x.x.x-x64.pkg
Verificate il tipo di chip: menu Apple () → "Informazioni su questo Mac"
Se avete usato l'installer sbagliato, scaricate la versione corretta dalla pagina delle release
Se i crash persistono con l'installer corretto, controllate Console.app per i log dei crash e segnalateli su GitHub

Il driver audio virtuale non viene visualizzato

Se non vedete "SokujiVirtualAudio" nei vostri dispositivi audio:

Lasciate prima che Sokuji lo ripari: quando il driver è installato ma macOS non lo ha caricato, Sokuji lo segnala all'avvio e propone Ripara. Inserite la password di amministratore e Sokuji riavvia Core Audio per caricare il driver, senza bisogno di riavviare Sokuji
Verificate se il driver e installato: ls /Library/Audio/Plug-Ins/HAL/
Se non presente, potrebbe essere necessario reinstallare Sokuji
Se presente e Ripara non ha aiutato, provate a riavviare CoreAudio: sudo killall coreaudiod, oppure riavviate il Mac
Controllate Impostazioni di Sistema → Suono per vedere se il dispositivo appare

L'installazione richiede la password di amministratore

Questo e normale e necessario:

L'installer PKG deve installare un driver audio a livello di sistema
I driver audio di sistema richiedono privilegi di amministratore per l'installazione
Inserite la password quando richiesto - e sicuro e previsto
Se non avete accesso come amministratore, contattate il vostro amministratore di sistema