← Torna alla documentazione

Guida all'installazione su macOS

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

Scarica per macOS

Requisiti di sistema

  • macOS 10.15 (Catalina) o successivo
  • 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.

L'installer PKG non e firmato, il che significa che dovrete seguire passaggi speciali per installarlo (spiegato nel passaggio successivo).

Passaggio 2: Preparare l'installazione

Poiche l'installer PKG non e firmato, macOS lo blocchera per impostazione predefinita. Dovete rimuovere l'attributo di quarantena prima dell'installazione.

Rimuovere l'attributo di quarantena (obbligatorio)

  1. Aprite Terminale (Applicazioni → Utility → Terminale)
  2. Digitate o incollate il seguente comando (sostituite x.x.x con il numero della vostra versione):

    sudo xattr -d com.apple.quarantine ~/Downloads/Sokuji-x.x.x-arm64.pkg

    Per Mac Intel, usate: sudo xattr -d com.apple.quarantine ~/Downloads/Sokuji-x.x.x-x64.pkg

  3. Premete Invio e inserite la password di amministratore quando richiesto
  4. Il comando si completera silenziosamente (nessun output significa successo)

Cosa fa questo comando? Questo comando rimuove il flag di quarantena che macOS aggiunge ai file scaricati. E sicuro e necessario per gli installer PKG non firmati.

Questo passaggio e fondamentale! Senza rimuovere l'attributo di quarantena, l'installer PKG non riuscira ad aprirsi o installarsi.

Passaggio 3: Installare il PKG

Ora che avete preparato l'installer, potete installare Sokuji e il suo driver audio virtuale.

Processo di installazione

  1. Individuate il file .pkg scaricato nella cartella Download (es., Sokuji-x.x.x-arm64.pkg o Sokuji-x.x.x-x64.pkg)
  2. Fate doppio clic sul file PKG per avviare l'installazione
  3. L'installer di macOS si aprira - cliccate su "Continua" per procedere
  4. Esaminate i dettagli dell'installazione e cliccate su "Installa"
  5. Inserite la password di amministratore quando richiesto (necessaria per l'installazione del driver)
  6. Attendete il completamento dell'installazione (di solito 1-2 minuti)
  7. 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 4: Primo avvio

Dopo l'installazione, potrebbe essere necessario concedere a Sokuji il permesso di esecuzione poiche e stato scaricato al di fuori dell'App Store.

Aprire Sokuji per la prima volta

  1. Navigate alla cartella Applicazioni
  2. Trovate Sokuji nell'elenco
  3. Fate clic con il pulsante destro (o Control-clic) su Sokuji
  4. Selezionate "Apri" dal menu contestuale
  5. Quando appare la finestra di dialogo di sicurezza, cliccate su "Apri" per confermare

Nota: Se avete completato correttamente il Passaggio 2, potreste non vedere avvisi di sicurezza.

Metodo alternativo

Se macOS continua a bloccare Sokuji:
  1. Aprite Preferenze di Sistema → Sicurezza e Privacy
  2. Andate alla scheda Generali
  3. Dovreste vedere un messaggio riguardante il blocco di Sokuji
  4. Cliccate su "Apri comunque"
Questo avviso di sicurezza appare solo al primo avvio. Successivamente, potete aprire Sokuji normalmente dal Launchpad o dalla cartella Applicazioni.

Passaggio 5: Configurare Sokuji

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

Configurazione iniziale

  1. Concedete i permessi del microfono quando macOS lo richiede
  2. Selezionate la vostra lingua dell'interfaccia preferita
  3. Scegliete il vostro fornitore di IA (OpenAI, Google Gemini, ecc.)
  4. Inserite la vostra chiave API per il fornitore selezionato
  5. Selezionate le lingue di origine e di destinazione per la traduzione
  6. Scegliete i vostri dispositivi audio (dovreste vedere "Sokuji Virtual Audio" nell'elenco)
  7. 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 pacchetto e danneggiato e non puo essere aperto" o il PKG non si installa

Questo succede quando l'attributo di quarantena non e stato rimosso dal file PKG:
  1. Aprite Terminale (Applicazioni → Utility → Terminale)
  2. Eseguite: sudo xattr -d com.apple.quarantine ~/Downloads/Sokuji-*.pkg
  3. Inserite la password quando richiesto
  4. Riprovate a installare il PKG
Questo e il problema di installazione piu comune con gli installer PKG non firmati.

"Sokuji non puo essere aperto perche proviene da uno sviluppatore non identificato"

Questo succede se non avete eseguito il comando xattr prima dell'installazione:
  1. Fate clic con il pulsante destro sull'app Sokuji in Applicazioni
  2. Selezionate "Apri" dal menu
  3. Cliccate su "Apri" nella finestra di dialogo che appare
Dovete farlo solo una volta. Approccio migliore: disinstallate e reinstallate dopo aver rimosso l'attributo di quarantena.

Il microfono non funziona

Se Sokuji non riesce ad accedere al microfono:
  1. Aprite Preferenze di Sistema → Sicurezza e Privacy → Privacy
  2. Selezionate Microfono dalla barra laterale sinistra
  3. Assicuratevi che Sokuji sia selezionato nell'elenco
  4. Se non e nell'elenco, riavviate Sokuji e concedete il permesso quando richiesto

Nessuna uscita audio

Se non riuscite a sentire l'audio tradotto:
  1. Aprite Preferenze di Sistema → Suono → Uscita
  2. Selezionate il dispositivo di uscita preferito
  3. Verificate che il volume di uscita non sia disattivato
  4. In Sokuji, verificate che il dispositivo di uscita corretto sia selezionato

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 "Sokuji Virtual Audio" nei vostri dispositivi audio:
  1. Verificate se il driver e installato: ls /Library/Audio/Plug-Ins/HAL/
  2. Se non presente, potrebbe essere necessario reinstallare Sokuji
  3. Se presente, provate a riavviare CoreAudio: sudo killall coreaudiod
  4. Controllate Preferenze 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