📖 Guida rapida
Installazione e primi passi con Seaclic, spiegati in modo semplice.
🔧 Installazione
Scarica l'installer
Scarica il file di installazione di Seaclic (ad esempio Seaclic-Setup.exe).
Avvia l'installazione
Fai doppio clic sul file scaricato. Se Windows mostra un avviso di sicurezza ("Windows ha protetto il tuo PC"), clicca su Ulteriori informazioni e poi su Esegui comunque. L'installer ti guiderà passo dopo passo.
Completa l'installazione
Segui le schermate dell'installer: accetta la licenza, scegli dove installare (la posizione predefinita va benissimo) e clicca Installa. Al termine vedrai un'icona di Seaclic sul desktop.
Primo avvio
Fai doppio clic sull'icona Seaclic sul desktop. Al primo avvio il programma scaricherà automaticamente i modelli di intelligenza artificiale necessari (~900 MB). Questa operazione avviene una sola volta e richiede una connessione a Internet. Vedrai una barra di progresso con lo stato del caricamento.
🖥️ La finestra principale
Quando Seaclic si apre, vedrai la finestra principale con questi elementi:
I due pulsanti principali. START avvia l'ascolto vocale, STOP lo ferma. Puoi anche usare un tasto della tastiera come scorciatoia (configurabile nelle impostazioni).
Cinque pulsanti per attivare o disattivare le modalità: 🔍 Trova, 🖱️ Mouse, 🎤 Comandi, 📷 Tracking, 👁 Gaze. Puoi attivarli tutti insieme.
Un pallino colorato mostra lo stato attuale: 🟢 verde = in ascolto, 🟡 giallo = in attesa, 🔴 rosso = fermo.
Apre la finestra con tutte le impostazioni del programma, organizzate in 9 schede. Da qui puoi personalizzare tutto il comportamento di Seaclic.
🚀 Primi passi
Prova la modalità Trova
Attiva la modalità "Trova"
Clicca sul pulsante 🔍 Trova nella finestra principale. Il pulsante si evidenzia quando è attivo.
Premi START
Clicca sul pulsante verde ▶ START. L'indicatore diventa verde: Seaclic è in ascolto.
Pronuncia il nome di un elemento
Guarda lo schermo e pronuncia ad alta voce il nome di qualcosa che vedi — ad esempio il nome di un pulsante, un menu o un'icona. Seaclic lo cercherà e ci cliccherà sopra automaticamente.
Prova la modalità Mouse
Attiva la modalità "Mouse"
Clicca sul pulsante 🖱️ Mouse.
Usa i comandi vocali
Dopo aver premuto START, prova a dire: "destra", "sinistra", "su", "giù" per muovere il cursore. Di' "stop" per fermarlo e "click" per cliccare.
🎧 Modalità di ascolto
Seaclic offre tre modi diversi per ascoltare la tua voce:
| Modalità | Come funziona | Quando usarla |
|---|---|---|
| Continuo | Dopo ogni comando, torna subito in ascolto. Non devi premere nulla tra un comando e l'altro. | Uso quotidiano, navigazione web, programmi. |
| Singolo | Ascolta un solo comando, poi si ferma. Devi premere START di nuovo per il prossimo. | Quando vuoi dare un solo comando alla volta. |
| A pressione | Registra solo mentre tieni premuto il tasto scorciatoia. Rilascia per elaborare. | Ambienti rumorosi, massimo controllo. |
Puoi cambiare la modalità di ascolto nelle impostazioni, nella scheda Ascolto.
⌨️ Tasto scorciatoia (hotkey)
Puoi configurare un tasto della tastiera (ad esempio F5) che funziona come scorciatoia globale: funziona anche quando Seaclic è in secondo piano e stai usando un altro programma.
- In modalità Continuo o A pressione: tieni premuto il tasto per parlare, rilascia per elaborare.
- In modalità Singolo: premi il tasto per avviare l'ascolto (come premere START).
Configura il tasto scorciatoia nelle impostazioni, nella scheda Ascolto.
🗣️ Attivazione vocale (senza toccare nulla)
Se hai configurato un comando di tipo "start" nella modalità Comandi, Seaclic ascolta in sottofondo anche quando è fermo. Quando riconosce la parola di attivazione (ad esempio "ehi Seaclic"), si avvia automaticamente senza che tu debba premere alcun pulsante o tasto.
⚙️ Impostazioni chiave per cominciare
Prima di usare Seaclic sul serio, vale la pena configurare queste poche opzioni fondamentali. Aprile tutte dal pulsante ⚙ Impostazioni nella finestra principale.
Riconoscimento vocale (STT)
| Modalità | Come si imposta | Quando sceglierla |
|---|---|---|
| Locale: Sherpa-ONNX (default) | Impostazioni → Riconoscimento → STT: Locale → Sherpa-ONNX | Nessuna connessione internet, buona qualità, ~98 MB da scaricare al primo avvio |
| Locale: Vosk | Impostazioni → Riconoscimento → STT: Locale → Vosk | Alternativa offline più leggera, ~50 MB |
| Cloud: CapisciAMe | Impostazioni → Riconoscimento → STT: Cloud → CapisciAMe (inserire il Nick) | Parlato atipico, disartria — richiede connessione e nick CINECA |
| Cloud: Google | Impostazioni → Riconoscimento → STT: Cloud → Google | Massima qualità per parlato standard, richiede connessione |
Backend Trova
| Backend | Descrizione | Requisiti |
|---|---|---|
| Locale (default) | OCR (EasyOCR) per testo + GroundingDINO per immagini. Tutto offline. | GPU NVIDIA consigliata; i modelli (~1 GB) vengono scaricati al primo avvio |
| VLM locale | Qwen2.5-VL via Ollama. Capisce l'intento, nessun dato in rete. | GPU NVIDIA con 6+ GB VRAM, Ollama scaricato automaticamente |
| Cloud | GPT-4.1 (Azure/OpenAI). Massima precisione, comprende l'intento vocale. | Connessione internet + API key Azure OpenAI o OpenAI |
Gamepad virtuale
Per usare i comandi gamepad (necessario per Trackig e Comandi gamepad), vai in Impostazioni → Generale → Abilita gamepad virtuale. Il driver ViGEmBus viene installato automaticamente.
Microfono
Se hai più microfoni, puoi specificarne uno in Impostazioni → Riconoscimento. In caso di problemi di riconoscimento, abilita la modalità debug per registrare screenshot e log.
🔗 Combinazioni consigliate
Seaclic è pensato per combinare più modalità insieme. Ecco alcune configurazioni particolarmente potenti, con le istruzioni su come attivarle.
Tracking + Comandi vocali + Gamepad virtuale
Muovi la testa per controllare il joystick sinistro (direzione/mira).
Usa la voce per i pulsanti A, B, X, Y, LT, RT.
Attiva: Tracking (profilo Joystick) + Comandi (profilo gioco) + Gamepad virtuale ON.
Gaze + Eye Button + azioni IR/Alexa/Google Home
Crea Eye Button per i comandi più usati (accendi TV, volume, luci).
Fissa il bottone per 1 secondo per inviare il segnale.
Attiva: Gaze + Eye Button configurati con azione IR o Alexa.
Gaze mouse + blink-click + Comandi vocali
Muovi il cursore con gli occhi, clicca ammiccando, usa la voce per
le scorciatoie da tastiera (copia, incolla, Invio).
Attiva: Gaze (output: mouse) + blink-click ON + Comandi vocali.
Spiega (VLM/Cloud) + Trova
Di' “cosa vedi?” per ottenere una descrizione vocale dello schermo.
Poi usa “trovami il pulsante Salva” per cliccarlo direttamente.
Attiva: Backend Trova = VLM locale o Cloud + modalità Spiega + Trova.
Input binding + azioni Seaclic/gamepad
Collega uno switch fisico (mappato su un tasto). Usa Input mode per rimapparlo
in qualsiasi azione: clic, tasto, pulsante gamepad, avvio/stop Seaclic.
Attiva: modalità Input + profilo con il binding desiderato.
Trova (locale) + Comandi (macro tastiera)
Clicca su qualsiasi elemento dicendo il suo nome. Usa comandi vocali
per Ctrl+C, Ctrl+V, Alt+Tab e le funzioni più usate del tuo programma.
Attiva: Trova + Comandi vocali con profilo per il programma usato.