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