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

Nel pannello Impostazioni Audio, dovreste vedere:

  • CABLE Output (VB-Audio Virtual Cable) - Elencato nei Dispositivi di ingresso disponibili
  • CABLE Input (VB-Audio Virtual Cable) - Elencato nei Dispositivi di monitoraggio disponibili

Questi dispositivi virtuali confermano che VB-CABLE e stato installato con successo.

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 come dispositivo di ingresso audio
  6. Scegliete i vostri altoparlanti/cuffie come dispositivo di monitoraggio dell'altoparlante virtuale
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

Se il microfono non viene rilevato:
  1. Aprite Impostazioni di Windows → Privacy → Microfono
  2. Assicuratevi che "Consenti alle app di accedere al microfono" sia abilitato
  3. Assicuratevi che Sokuji sia elencato e abilitato nella lista delle app
  4. 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

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