Guida Utente
Come usare koedesk — voce-a-testo per il tuo desktop.
1. Per Iniziare
Installazione
- Scarica dalla pagina di download
- macOS Apri il DMG e trascina koedesk in Applications
- Windows Esegui l'installer (.exe). SmartScreen potrebbe avvisarti — clicca "Ulteriori informazioni" → "Esegui comunque"
Configurazione Iniziale (macOS)
- Concedi il permesso Accessibility quando richiesto (Impostazioni di Sistema → Privacy & Sicurezza → Accessibilità → attiva koedesk)
- Imposta il tasto Fn su "Non fare nulla" (Impostazioni di Sistema → Tastiera → "Premi il tasto Fn per" → "Non fare nulla")
Accesso
- Al primo avvio, una schermata di accesso appare automaticamente. Clicca Log in per aprire il browser
- Accedi con Google, GitHub, Microsoft o email
2. Modalità di Registrazione
Push-to-Talk (tieni premuto per registrare)
- macOS Tieni premuto il tasto Fn sinistro mentre parli. Rilascia per interrompere e trascrivere.
- Windows Tieni premuto il tasto Alt destro mentre parli. Rilascia per interrompere e trascrivere.
Annulla Registrazione
- Premi Esc durante la registrazione per annullare senza trascrivere
La barra a pillola nella parte inferiore dello schermo mostra lo stato corrente: inattivo (punto piccolo), registrazione (barra espansa con forma d'onda) o elaborazione (animazione luminosa).
3. Output del Testo
- Dopo la trascrizione, il testo viene automaticamente copiato negli appunti
- koedesk incolla automaticamente il testo nell'app attualmente attiva (Cmd+V su macOS / Ctrl+V su Windows)
- Se l'incolla automatico non funziona in alcune app, incolla manualmente — il testo è già nei tuoi appunti
4. Modello AI
koedesk utilizza ElevenLabs Scribe v2 — il modello di riconoscimento vocale più preciso al mondo (2.3% WER). Le parole di riempimento vengono rimosse automaticamente a livello STT. Supporta 36 lingue con precisione di livello Eccellente.
Lingue supportate
Bahasa Indonesia, Bahasa Melayu, Bosanski, Català, Čeština, Dansk, Deutsch, Eesti, English, Español, Français, Galego, Hrvatski, Íslenska, Italiano, Latviešu, Magyar, Nederlands, Norsk, Polski, Português, Română, Slovenčina, Suomi, Svenska, Tiếng Việt, Türkçe, Ελληνικά, Беларуская, Български, Македонски, Русский, Українська, ಕನ್ನಡ, മലയാളം, 日本語
5. Dashboard
- Settings — Lingua, dispositivo di input e preferenze
- Account — Accesso/disconnessione, visualizza il tuo piano
- Logs — Visualizza la cronologia delle trascrizioni con dettaglio latenza (encode / API / inject)
- Dictionary — Aggiungi vocabolario personalizzato per migliorare l'accuratezza della trascrizione
- Developer — Sovrascrivi il modello STT, abilita la post-elaborazione LLM, info di debug
6. Risoluzione dei Problemi
macOS Il tasto Fn non risponde
- Verifica Impostazioni di Sistema → Tastiera → "Premi il tasto Fn per" sia impostato su "Non fare nulla"
- Verifica Impostazioni di Sistema → Privacy & Sicurezza → Accessibilità → koedesk sia ATTIVO
Windows SmartScreen blocca l'installazione
- L'app è firmata digitalmente, ma SmartScreen potrebbe comunque avvisare alla prima installazione. Clicca "Ulteriori informazioni" → "Esegui comunque".
L'incolla automatico non funziona
- Alcune app bloccano l'incolla simulato. Il testo è già nei tuoi appunti — premi Cmd+V / Ctrl+V manualmente.
La trascrizione sembra imprecisa
- Prova un modello AI diverso (scheda Settings)
- Aggiungi termini specifici del settore al Dictionary
- Parla chiaramente e riduci al minimo il rumore di fondo