Skip to content

Autorizzazioni ​

Vox richiede autorizzazioni di sistema specifiche per funzionare correttamente. Questa guida spiega ogni autorizzazione e come concederla.

Autorizzazioni Richieste ​

Schermata Autorizzazioni

Vai a Impostazioni → Autorizzazioni per visualizzare e gestire tutte le autorizzazioni richieste.

Microfono ​

Stato: Necessario per la registrazione

L'autorizzazione microfono consente a Vox di acquisire audio per la trascrizione.

macOS ​

Come concedere:

  1. Apri Preferenze di Sistema → Sicurezza e Privacy → Privacy
  2. Seleziona "Microfono" nella barra laterale sinistra
  3. Spunta la casella accanto a "Vox"

Windows ​

Come concedere:

  1. Apri Impostazioni → Privacy → Microfono
  2. Assicurati che "Consenti alle app di accedere al microfono" sia attivato
  3. Verifica che Vox appaia nell'elenco e sia attivato

Per cosa viene usato:

  • Registrare la tua voce per la trascrizione
  • Test e verifica audio
  • Memorizzare clip audio per la revisione

Importante

Senza accesso al microfono, Vox non può registrare né trascrivere il tuo parlato.

Accessibilità ​

Stato: Necessario per la simulazione GNVFMT

L'autorizzazione di accessibilità consente a Vox di incollare le trascrizioni direttamente nell'applicazione attiva.

macOS ​

Come concedere:

  1. Apri Preferenze di Sistema → Sicurezza e Privacy → Privacy
  2. Seleziona "Accessibilità" nella barra laterale sinistra
  3. Clicca sull'icona del lucchetto e autenticati
  4. Spunta la casella accanto a "Vox"

Per cosa viene usato:

  • Incollare testo trascritto in qualsiasi applicazione
  • Simulare l'input da tastiera
  • Flusso di lavoro di inserimento testo senza interruzioni

Windows

Su Windows, Vox utilizza le API di sistema standard per l'inserimento del testo e non richiede un'autorizzazione di accessibilità separata.

Alternativa Manuale

Se preferisci non concedere l'autorizzazione di Accessibilità, puoi incollare manualmente le trascrizioni usando ⌘ + V dopo la registrazione. Il testo verrà copiato automaticamente negli appunti.

Keychain ​

Stato: Accesso ai segreti

L'autorizzazione keychain consente a Vox di memorizzare in modo sicuro le tue chiavi API per il miglioramento AI.

macOS ​

Come concedere:

  1. Quando richiesto, clicca su "Consenti" o "Consenti Sempre"
  2. Inserisci la tua password macOS quando richiesto

Windows ​

Vox utilizza automaticamente il Gestore credenziali di Windows. Non è necessaria alcuna autorizzazione manuale.

Per cosa viene usato:

  • Memorizzare in modo sicuro le credenziali AWS Bedrock
  • Proteggere le chiavi API per i provider di miglioramento AI
  • Crittografare dati di configurazione sensibili

Autorizzazione Opzionale

L'accesso al Keychain è necessario solo se abiliti il Miglioramento AI con provider come AWS Bedrock o DeepSeek. Se usi solo la trascrizione locale, questa autorizzazione non è necessaria.

Copia negli Appunti ​

Impostazione Copia negli Appunti

Quando abilitato, il testo trascritto sostituisce il contenuto degli appunti. Quando disabilitato, il testo viene inserito direttamente nel campo attivo e gli appunti vengono preservati. Se il campo di testo non viene trovato, il testo sarà comunque disponibile nella cronologia delle trascrizioni.

Abilita questa impostazione se:

  • Vuoi controllare manualmente dove vanno le trascrizioni
  • Hai bisogno di preservare il contenuto degli appunti
  • Preferisci incollare le trascrizioni tu stesso

Testare le Autorizzazioni ​

Test delle Autorizzazioni ​

Vox include un test integrato per verificare che le autorizzazioni microfono e accessibilità funzionino correttamente.

Per eseguire il test:

  1. Vai a Impostazioni → Autorizzazioni
  2. Clicca su Registra per il Test
  3. Di' una frase breve
  4. Verifica che:
    • L'audio venga acquisito (microfono funzionante)
    • Il testo venga incollato in un campo di test (accessibilità funzionante)

Se il test fallisce:

  • Verifica che tutte le autorizzazioni siano concesse nelle Preferenze di Sistema
  • Riavvia Vox e riprova
  • Riavvia il Mac se le autorizzazioni sono state concesse di recente

Risoluzione dei Problemi ​

Risoluzione Problemi macOS ​

L'Autorizzazione Appare Concessa Ma Non Funziona ​

macOS richiede a volte il riavvio dell'applicazione dopo aver concesso le autorizzazioni:

  1. Chiudi completamente Vox (clic destro sull'icona della barra → Esci)
  2. Riavvia Vox da Applicazioni
  3. Testa nuovamente l'autorizzazione

Le Preferenze di Sistema Mostrano uno Stato Diverso ​

Se le Preferenze di Sistema mostrano un'autorizzazione come concessa ma Vox la mostra come negata:

  1. Disattiva e riattiva l'autorizzazione nelle Preferenze di Sistema
  2. Riavvia Vox
  3. Se il problema persiste, riavvia il Mac

Errore di Accesso al Microfono Negato ​

Se vedi ripetuti errori di accesso al microfono negato:

  1. Controlla Preferenze di Sistema → Sicurezza e Privacy → Microfono
  2. Rimuovi Vox dalla lista (clicca sul pulsante -)
  3. Riavvia Vox - ti verrà chiesto di concedere di nuovo l'accesso
  4. Clicca su "OK" o "Consenti" quando richiesto

L'Autorizzazione di Accessibilità Non Ha Effetto ​

Le autorizzazioni di accessibilità possono essere particolarmente difficili da gestire su macOS:

  1. Apri Preferenze di Sistema → Sicurezza e Privacy → Privacy → Accessibilità
  2. Rimuovi Vox dalla lista
  3. Chiudi completamente Vox
  4. Riavvia il Mac
  5. Avvia Vox e concedi l'autorizzazione di accessibilità quando richiesto

Monterey e Versioni Successive

macOS Monterey (12.0) e le versioni successive hanno controlli di autorizzazione più severi. Potresti dover concedere le autorizzazioni più volte o riavviare il Mac dopo averle concesse.

Risoluzione Problemi Windows ​

Microfono Non Rilevato ​

  1. Apri Impostazioni → Privacy → Microfono
  2. Assicurati che "Consenti alle app di accedere al microfono" sia attivato
  3. Verifica che Vox appaia nell'elenco e sia attivato
  4. Riavvia Vox se le autorizzazioni sono state modificate di recente

Il Testo Non Viene Incollato ​

  1. Prova a eseguire Vox come amministratore
  2. Assicurati che l'applicazione di destinazione accetti input da tastiera
  3. Verifica che nessun'altra applicazione stia bloccando la simulazione di input

Privacy e Sicurezza ​

Quali Dati Vengono Acceduti ​

Vox rispetta la tua privacy:

  • Microfono: Acquisisce audio solo quando premi attivamente il tasto di registrazione
  • Accessibilità: Simula solo l'input da tastiera per incollare le trascrizioni
  • Keychain: Memorizza solo chiavi API crittografate - non legge mai altri elementi del keychain

Archiviazione dei Dati ​

  • Registrazioni audio: Archiviate localmente sul tuo dispositivo (vedi Conservazione Audio)
  • Trascrizioni: Salvate localmente nella cartella dell'applicazione Vox
  • Chiavi API: Crittografate nel Portachiavi macOS / Gestore credenziali di Windows
  • Nessuna sincronizzazione cloud: Tutti i dati rimangono sul tuo dispositivo a meno che non abiliti il Miglioramento AI

Revocare le Autorizzazioni ​

Puoi revocare le autorizzazioni in qualsiasi momento:

macOS:

  1. Apri Preferenze di Sistema → Sicurezza e Privacy → Privacy
  2. Seleziona la categoria di autorizzazione pertinente
  3. Deseleziona la casella accanto a "Vox"

Windows:

  1. Apri Impostazioni → Privacy
  2. Seleziona la categoria di autorizzazione pertinente (Microfono)
  3. Disattiva l'interruttore per Vox

Nota: La revoca delle autorizzazioni microfono o accessibilità impedirà a Vox di funzionare normalmente.

Prossimi Passi ​

Una volta concesse tutte le autorizzazioni:

Costruito con 💜 dalla comunità open-source e dai principali collaboratori