๐Ÿ’ก Pagina legacy Le impostazioni chiave sono ora documentate nelle pagine di ogni modalitร . Consulta Guida rapida โ†’ Impostazioni chiave per una panoramica dei parametri piรน importanti, oppure la pagina di ogni Modalitร  per i parametri specifici.

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.

๐Ÿ’ก Le impostazioni vengono salvate automaticamente Quando clicchi OK, tutte le modifiche vengono scritte nel file di configurazione. Al prossimo avvio di Seaclic, le impostazioni saranno ripristinate esattamente come le hai lasciate.

๐Ÿ  Scheda 1 โ€” Generale

Impostazioni di base per l'identitร , lo schermo, l'interfaccia e le funzioni globali.

ImpostazioneDescrizione
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.

ImpostazioneDescrizione
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.
โš ๏ธ Riavvio necessario Cambiare il backend Trova, OCR o Immagini richiede il riavvio di Seaclic perchรฉ i modelli di intelligenza artificiale devono essere caricati o scaricati dalla memoria. Seaclic te lo segnalerร  automaticamente.

๐ŸŽง Scheda 3 โ€” Ascolto

Come e quando Seaclic ascolta la tua voce.

ImpostazioneDescrizione
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.

ImpostazioneDescrizione
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.

ElementoDescrizione
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.

ImpostazioneDescrizione
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.
ImpostazioneDescrizione 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). Sensibilitร  Slider 1โ€“100. Quanto deve essere ampio il movimento per generare il massimo input. Dead zone Slider 0โ€“50%. Zona morta attorno alla posizione neutra (ignora piccoli movimenti). Smoothing Slider 1โ€“10. Numero di frame per la media mobile. Piรน alto = piรน fluido ma meno reattivo. 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, 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.

ImpostazioneDescrizione
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 9 โ€” Avanzate

Opzioni per utenti esperti e per la risoluzione dei problemi.

ImpostazioneDescrizione
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.

โš ๏ธ Attenzione Eliminare il file di impostazioni cancella tutte le personalizzazioni. Se vuoi conservare i profili dei comandi, ricorda che quelli sono salvati in un file separato (seaclic_profiles.json).