โ๏ธ Impostazioni
Guida completa a tutte le opzioni di Seaclic, scheda per scheda.
Per aprire le impostazioni, clicca sul pulsante โ Impostazioni nella finestra principale di Seaclic. La finestra รจ organizzata in 9 schede. Quando hai finito, clicca OK per salvare oppure Annulla per tornare indietro senza modificare nulla.
๐ Scheda 1 โ Generale
Impostazioni di base per l'identitร , lo schermo, l'interfaccia e le funzioni globali.
| Impostazione | Descrizione |
|---|---|
| Nick CapisciAMe | Il tuo nickname per il servizio di riconoscimento vocale CapisciAMe (CINECA). Ti viene fornito al momento della registrazione. Se usi Google, puoi lasciare quello predefinito. |
| Parola di avvio | Se il motore di riconoscimento sente questa parola, la ignora e continua ad ascoltare. Predefinita: "start". Utile se vuoi dire "start" senza che Seaclic si fermi. |
| Parola di stop | Quando Seaclic sente questa parola, si ferma (come premere STOP). Predefinita: "stop". |
| Monitor | Quale schermo usare per la ricerca (modalitร Trova). Se hai un solo monitor, lascia "1". Con piรน monitor puoi scegliere quale usare o selezionare "Tutti i monitor" per cercare su tutti. |
| Mostra indicatore | Mostra o nasconde il pallino colorato sempre visibile sullo schermo. Il pallino indica lo stato: ๐ข in ascolto, ๐ก in attesa, ๐ด fermo. |
| Suoni di feedback | Se attivo, Seaclic riproduce un suono quando inizia e finisce l'ascolto. Utile per sapere quando parlare. |
| ๐ฎ Gamepad virtuale | Abilita il controller XBox 360 virtuale. Necessario per i comandi di tipo Gamepad e per il tracking con output gamepad. Disattivalo se non ti serve o se crea conflitti con i giochi. |
| Avvio automatico ascolto | Se attivo, Seaclic inizia ad ascoltare automaticamente all'apertura (solo in modalitร Continuo). Non devi premere START manualmente. |
๐๏ธ Scheda 2 โ Riconoscimento
Scegli il motore vocale e le tecnologie di ricerca visiva.
| Impostazione | Descrizione |
|---|---|
| Motore vocale |
CapisciAMe: servizio italiano di CINECA, ottimizzato per l'italiano. Richiede il nickname configurato. Google: riconoscimento di Google, funziona senza registrazione. Lo switch ti permette di passare da uno all'altro. |
| Backend Trova |
Scegli come la modalitร Trova cerca gli elementi sullo schermo: Locale (default): OCR + GroundingDINO. Tutto sul tuo PC, funziona anche senza Internet (dopo il primo avvio). Consigliato con GPU NVIDIA. Azure Vision: invia uno screenshot a un LLM multimodale cloud (es. GPT-4.1). Piรน intelligente (capisce l'intento), ma richiede Internet e credenziali Azure. |
| Endpoint Azure | URL dell'endpoint Azure OpenAI (o compatibile). Visibile solo con backend Azure. Le credenziali sono criptate sul tuo PC con Windows DPAPI e non vengono mai salvate in chiaro. |
| API Key Azure | Chiave API per l'endpoint Azure. Criptata come l'endpoint. Il pulsante ๐ permette di mostrare/nascondere la chiave. |
| Testa connessione | Pulsante per verificare che le credenziali Azure funzionino. Mostra โ se la connessione รจ riuscita o โ con il messaggio di errore. |
| Usa OCR (ricerca testo) | Se attivo, la modalitร Trova (backend locale) cerca il testo visibile sullo schermo. Disattivare solo se non ti serve (riduce l'uso di risorse). โ ๏ธ Richiede riavvio di Seaclic. |
| Usa Immagini (ricerca oggetti) | Se attivo, la modalitร Trova (backend locale) usa l'intelligenza artificiale per cercare oggetti descritti a parole. โ ๏ธ Richiede riavvio di Seaclic. |
๐ง Scheda 3 โ Ascolto
Come e quando Seaclic ascolta la tua voce.
| Impostazione | Descrizione |
|---|---|
| Modalitร di ascolto |
Continuo: ascolta un comando dopo l'altro, senza fermarsi. Singolo: ascolta un solo comando, poi si ferma. A pressione: ascolta solo mentre tieni premuto il tasto scorciatoia. |
| Avvio automatico | In modalitร Continuo, avvia l'ascolto appena Seaclic si apre. |
| Tasto scorciatoia (hotkey) | Un tasto della tastiera che funziona come START/STOP globale, anche quando un altro programma รจ in primo piano. Clicca nel campo e premi il tasto desiderato. Puoi cancellare la scorciatoia con il pulsante "Cancella" accanto. |
๐ฑ๏ธ Scheda 4 โ Mouse
Personalizza i comandi vocali per il controllo del cursore.
| Impostazione | Descrizione |
|---|---|
| Parole trigger | 12 campi di testo, uno per ogni azione del mouse: destra, sinistra, su, giรน, stop, click, click destro, doppio click, mantieni, rilascia, scorri su, scorri giรน. Puoi cambiare ciascuna parola con quella che preferisci. |
| Sensibilitร riconoscimento | Quanto deve essere precisa la corrispondenza tra ciรฒ che dici e la parola del comando. Slider da basso (tollerante) ad alto (preciso). |
| Velocitร cursore | Quanto velocemente si muove il cursore quando dai un comando direzionale. Slider da lento a veloce. |
๐ค Scheda 5 โ Comandi
Gestione completa dei profili e dei comandi vocali personalizzati. Per una guida dettagliata, vedi la pagina Comandi e Gamepad.
| Elemento | Descrizione |
|---|---|
| Selettore profilo | Scegli il profilo attivo e gestiscilo (nuovo, rinomina, duplica, elimina, esporta, importa). |
| Lista comandi | Tutti i comandi del profilo attivo, ciascuno con la sua card configurabile. |
| ๏ผ Aggiungi comando | Crea un nuovo comando vuoto nel profilo corrente. |
| Slider sensibilitร | Soglia di corrispondenza per il riconoscimento dei comandi vocali. |
๐ท Scheda 6 โ Tracking
Configurazione del tracciamento facciale. Per una guida dettagliata, vedi la pagina Face Tracking.
| Impostazione | Descrizione |
|---|---|
| Webcam | Indice del dispositivo webcam da usare (0 = prima webcam, 1 = seconda, ecc.). |
| Calibrazione | Pulsante per avviare il wizard di calibrazione in 5 passi. |
| Mostra overlay tracking | Mostra/nasconde la finestra di anteprima con il video della webcam e i landmarks. |
| Profilo tracking | Seleziona il profilo tracking attivo. Ogni profilo ha parametri e comandi indipendenti. Puoi creare, rinominare, duplicare, eliminare, esportare e importare profili. Profili predefiniti: Default (WASD), Mouse (puntatore), Corse (trigger), 3D-Movement (joystick). |
| Sensibilitร | Slider 1โ100. Quanto deve essere ampio il movimento per generare il massimo input. Salvata per profilo. |
| Dead zone | Slider 0โ50%. Zona morta attorno alla posizione neutra (ignora piccoli movimenti). Salvata per profilo. |
| Smoothing | Slider 1โ10. Numero di frame per la media mobile. Piรน alto = piรน fluido ma meno reattivo. Salvato per profilo. |
| Velocitร mouse | Slider 1โ100. Velocitร del cursore quando il tipo di azione รจ "Puntatore mouse". Visibile solo se almeno una direzione usa il tipo mouse. Salvata per profilo. |
| Auto-drift | Attiva/disattiva la compensazione automatica dei cambi di postura. |
| Velocitร drift | Slider per la velocitร di correzione dell'auto-drift. |
| Secondi inattivitร | Dopo quanti secondi fermi il drift accelera la correzione. |
| Soglia freeze drift | Oltre quale % di movimento il drift si congela per non interferire. |
| Comandi direzionali | 4 card (su, giรน, sinistra, destra) con tipo di azione (tastiera, puntatore mouse, pulsante gamepad, trigger, joystick), valore e soglia per ciascuna. |
| Tasto ricentratura | Hotkey globale per ricentrare istantaneamente il punto neutro del tracking. |
๐ Scheda 7 โ Gaze (Eye Tracking)
Configurazione del tracciamento oculare.
| Impostazione | Descrizione |
|---|---|
| Dispositivo | Seleziona la sorgente per l'eye tracking: una webcam (MediaPipe Iris) o un Tobii Eye Tracker 5. Il pulsante "๐ Scan" cerca i dispositivi disponibili. |
| Calibrazione | Stato della calibrazione e pulsanti per avviarla (wizard fullscreen a 9 punti) o cancellarla. La calibrazione รจ necessaria per la webcam; per il Tobii รจ gestita dal software Tobii. |
| Modalitร output | Come viene usato lo sguardo: Mouse (sposta il cursore), Joystick gamepad (controlla uno stick analogico), Pulsanti gamepad (D-Pad digitale), Nessuno (solo Eye Button, nessun output diretto). |
| Stick gamepad | Se il modo output รจ gamepad, scegli quale stick controllare (sinistro o destro). |
| Smoothing | Slider per la finestra di smoothing (media mobile esponenziale). Piรน alto = piรน fluido ma meno reattivo. |
| Dwell time | Quanto tempo (in ms) devi fissare un Eye Button prima che si attivi. Default: 800 ms. |
| Cooldown | Pausa dopo l'attivazione di un Eye Button prima che possa riattivarsi. Default: 500 ms. |
| Eye Button (lista) | Lista dei bottoni a schermo attivabili con lo sguardo. Ogni bottone ha un nome, un tipo di azione (gli stessi dei comandi vocali: tastiera, mouse, gamepad, azione Seaclic, IR), un toggle abilita/disabilita e un pulsante elimina. |
| Aggiungi Eye Button | Crea un nuovo Eye Button con azione predefinita (click sinistro). |
| Mostra/Nascondi a schermo | Toggle che mostra i bottoni sullo schermo in modalitร di modifica (trascinabili e ridimensionabili). Le posizioni vengono salvate in tempo reale. |
| Blink-click | Se attivo, ammiccando un singolo occhio si simula un click sinistro alla posizione dello sguardo. |
| Soglia blink | Slider per la sensibilitร del rilevamento ammiccamento (0โ1). |
| Mostra heatmap | Overlay debug che mostra i punti recenti dello sguardo come mappa di calore. Solo in modalitร debug. |
๐ก Scheda 8 โ Broadlink (Domotica IR)
Configurazione del dispositivo Broadlink RM4 Mini per il controllo domotica a infrarossi.
| Impostazione | Descrizione |
|---|---|
| Abilita Broadlink | Attiva/disattiva il bridge IR. Se disattivato, i comandi IR non funzioneranno. |
| IP dispositivo | Indirizzo IP del Broadlink RM4 Mini sulla rete locale. Se lasciato vuoto, Seaclic cercherร automaticamente il dispositivo sulla rete (auto-discover). |
| Timeout | Secondi di attesa per la scoperta/connessione del dispositivo. Default: 5 secondi. |
| Cerca | Pulsante per cercare e connettere il dispositivo con le impostazioni attuali. |
| Stato | Mostra lo stato della connessione: โ Connesso (con modello e IP) oppure โ Non connesso. |
๐ง Scheda 9 โ Avanzate
Opzioni per utenti esperti e per la risoluzione dei problemi.
| Impostazione | Descrizione |
|---|---|
| Modalitร debug | Se attiva, Seaclic mostra informazioni dettagliate nella console e salva screenshot di debug. Attivala solo se hai problemi e ti viene chiesto dal supporto tecnico. |
๐ Ripristinare le impostazioni predefinite
Se vuoi ricominciare da zero, puoi eliminare il file seaclic_settings.json che si trova nella cartella di installazione di Seaclic (o nella cartella AppData). Al prossimo avvio, il programma ricreerร il file con tutti i valori predefiniti.