Guida all'installazione su Windows

Questa guida vi accompagnera nell'installazione di Sokuji sui sistemi Windows. Sokuji e disponibile come programma di installazione .exe per un'installazione semplice su Windows 10 e Windows 11.

Scarica per Windows

Requisiti di sistema

  • Windows 10 (versione 1903 o successiva) o Windows 11
  • Processore a 64 bit
  • 4 GB di RAM minimo (8 GB consigliati)
  • 200 MB di spazio su disco disponibile
  • Connessione Internet per i servizi di traduzione con IA
  • Microfono e altoparlanti/cuffie

Passaggio 1: Scaricare Sokuji

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

Scegliere il programma di installazione corretto

  • Programma di installazione .exe - Programma di installazione standard per Windows
  • Versione portatile - Non richiede installazione (se disponibile)

Passaggio 2: Eseguire il programma di installazione

Una volta scaricato, individuate il file del programma di installazione ed eseguitelo per iniziare l'installazione.

Windows Defender SmartScreen

Quando eseguite il programma di installazione, Windows Defender SmartScreen potrebbe impedire l'avvio dell'app:

Avviso di Windows Defender SmartScreen
  1. Cliccate su "Ulteriori informazioni" nell'avviso SmartScreen
  2. La finestra si espandera per mostrare ulteriori dettagli:
Vista espansa di Windows Defender SmartScreen
  1. Cliccate su "Esegui comunque" per procedere con l'installazione
Windows potrebbe mostrare avvisi di sicurezza per le applicazioni non firmate. Sokuji e sicuro da installare. Questi avvisi appaiono perche l'app non e ancora firmata con un certificato commerciale.

Passaggio 3: Installare il dispositivo audio virtuale VB-CABLE

Sokuji richiede il dispositivo audio virtuale VB-CABLE per instradare l'audio verso altre applicazioni. Il programma di installazione vi chiedera di installarlo automaticamente.

Installazione di VB-CABLE

Dopo aver superato SmartScreen, vedrete il prompt di installazione di VB-CABLE:

Prompt di installazione VB-CABLE
  1. Cliccate su "Install Now" per scaricare e installare VB-CABLE automaticamente
  2. In alternativa, potete cliccare su "Download Manually" per ottenerlo da vb-audio.com/Cable
  3. Quando appare il prompt di Controllo dell'account utente, cliccate su "Si" per consentire l'installazione:
Prompt di Controllo dell'account utente per VB-CABLE
  1. Il programma di installazione di VB-CABLE si aprira. Cliccate su "Install Driver":
Finestra del programma di installazione VB-CABLE
  1. Attendete il completamento dell'installazione. Vedrete un messaggio di successo:
Installazione VB-CABLE completata
  1. Cliccate su "OK" nella finestra di dialogo di installazione completata
  2. Apparira la conferma finale:
Conferma del successo dell'installazione VB-CABLE
  1. Cliccate su "OK" per terminare l'installazione di VB-CABLE
VB-CABLE crea dispositivi audio virtuali che consentono a Sokuji di trasmettere l'audio tradotto alle applicazioni di videoconferenza come Zoom, Teams o Google Meet.

Passaggio 4: Configurazione del primo avvio

Dopo l'installazione di VB-CABLE, Sokuji si avviera automaticamente e vedrete la pagina di configurazione audio:

Verificare i dispositivi audio

Configurazione audio di Sokuji che mostra i dispositivi VB-CABLE

Per verificare che VB-CABLE sia stato installato correttamente, aprite le Impostazioni audio di Windows (clic destro sull'icona dell'altoparlante nell'area di notifica → "Impostazioni audio"):

  • CABLE Output (VB-Audio Virtual Cable) - Dovrebbe comparire tra i dispositivi di registrazione
  • CABLE Input (VB-Audio Virtual Cable) - Dovrebbe comparire tra i dispositivi di riproduzione

Nota: questi dispositivi CABLE non compaiono nell'elenco dei dispositivi di Sokuji, ed è voluto. Sokuji li nasconde per evitare loop di feedback audio accidentali, e rileva e usa VB-CABLE automaticamente in background.

Completare la configurazione

  1. Configurate il vostro fornitore di IA preferito (OpenAI, Google Gemini, ecc.)
  2. Inserite la vostra chiave API per il fornitore selezionato
  3. Selezionate le lingue di origine e di destinazione
  4. Testate i dispositivi di ingresso/uscita audio
  5. Selezionate il vostro microfono fisico in Microfono
  6. Nel blocco Voce, scegliete i vostri altoparlanti o le cuffie come Dispositivo di riproduzione predefinito. Lo sento anche io e Traduzione che sento io possono suonare ciascuna su un proprio dispositivo; Traduzione che sente l'altra parte va nel microfono virtuale, CABLE Output (VB-Audio Virtual Cable)
Sokuji e ora pronto per l'uso! Potete avviare la traduzione in tempo reale cliccando sul pulsante di avvio sessione.

Risoluzione dei problemi

Windows Defender blocca l'installazione

Se Windows Defender SmartScreen blocca l'installazione:
  1. Cliccate su "Ulteriori informazioni" nell'avviso SmartScreen
  2. Cliccate su "Esegui comunque" per procedere con l'installazione
Questo e un problema comune con le applicazioni non firmate e non indica un problema di sicurezza.

Microfono non rilevato o non si apre

Se all'avvio il microfono non si apre, Sokuji ne indica il motivo:
  • "Il microfono «…» è in uso da parte di …": un'altra app lo sta usando. Chiudete l'app indicata e avviate di nuovo, oppure cliccate su Impostazioni e scegliete un altro microfono.
  • "Windows non è riuscito ad aprire il microfono «…»": potrebbe usarlo un'altra app, oppure il suo driver ha smesso di rispondere. Chiudete le app che lo usano o ricollegatelo, poi avviate di nuovo; da Impostazioni potete anche scegliere un altro microfono.
  • "Windows non consente a Sokuji di usare il microfono": le impostazioni di privacy di Windows impediscono alle app desktop di usare il microfono. Cliccate su Apri Impostazioni di Sistema, attivate l'accesso al microfono per le app desktop, poi avviate di nuovo.
Se il microfono non compare affatto nell'elenco:
  1. Aprite Impostazioni di Windows → Privacy e sicurezza → Microfono
  2. Assicuratevi che "Accesso al microfono" e "Consenti alle app desktop di accedere al microfono" siano attivi
  3. Verificate che il microfono sia correttamente collegato e impostato come dispositivo predefinito

Nessuna uscita audio

Se non sentite alcun audio:
  1. Fate clic con il pulsante destro del mouse sull'icona dell'altoparlante nella barra delle applicazioni
  2. Selezionate "Apri impostazioni audio"
  3. Verificate che il dispositivo di uscita sia selezionato correttamente
  4. Verificate che i livelli del volume non siano disattivati
  5. 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'applicazione non si avvia

Se Sokuji non si avvia:
  • Provate a eseguire come Amministratore (clic destro → Esegui come amministratore)
  • Verificate se il software antivirus sta bloccando l'applicazione
  • Reinstallate l'applicazione
  • Assicuratevi di avere gli ultimi aggiornamenti di Windows installati

Dispositivi VB-CABLE non rilevati

Se non vedete i dispositivi CABLE Output/Input in Sokuji:
  1. Riavviate il computer - Questo spesso risolve i problemi di riconoscimento dei dispositivi
  2. Verificate le Impostazioni Audio di Windows:
    • Fate clic con il pulsante destro del mouse sull'icona dell'altoparlante nella barra delle applicazioni
    • Selezionate "Impostazioni audio"
    • Cercate "CABLE Input" nei dispositivi di riproduzione
    • Cercate "CABLE Output" nei dispositivi di registrazione
  3. Reinstallate VB-CABLE manualmente:
    • Scaricate da vb-audio.com/Cable
    • Estraete il file ZIP
    • Eseguite VBCABLE_Setup_x64.exe come Amministratore
    • Riavviate il computer dopo l'installazione
  4. Verificate Gestione dispositivi:
    • Aprite Gestione dispositivi (Win+X → Gestione dispositivi)
    • Guardate sotto "Controller audio, video e giochi"
    • Verificate che "VB-Audio Virtual Cable" sia elencato senza errori