Problèmes fréquents

Assure-toi que ton micro est branché et sélectionné comme périphérique par défaut dans les paramètres système.

1. 1Vérifie la connexion physique du micro
2. 2Ouvre les paramètres audio de ton OS et sélectionne le bon périphérique
3. 3Redémarre VoxWave
4. 4Va dans Paramètres > Audio et sélectionne ton micro

En mode local, la première transcription charge le modèle Whisper en mémoire (~5s). Les suivantes sont beaucoup plus rapides.

En mode local, VoxWave utilise le modèle Whisper « small » qui tourne sur ton CPU. L'auto-détection fonctionne bien en mode cloud (Groq), mais le modèle local est moins précis pour détecter la langue — surtout sur les phrases courtes ou dans les environnements bruyants.

1. 1Ouvre Paramètres > Général
2. 2Définis manuellement ta langue de dictée au lieu de « Auto-détection »
3. 3Ça dit à Whisper exactement quelle langue attendre, ce qui améliore drastiquement la précision

Si tu compiles depuis les sources, tu peux aussi passer à un modèle Whisper plus gros pour de meilleurs résultats (au prix de la vitesse) :

# Dans config.yaml, modifie :
# whisper:
#   model: small    → essaie 'medium' pour une meilleure précision
#   language: fr    → définis ta langue explicitement

VoxWave utilise Ctrl+V pour injecter le texte. Assure-toi que l'application cible accepte le collage.

• Certaines apps de sécurité bloquent les raccourcis clavier simulés
• Les champs protégés (mots de passe) n'acceptent pas le collage
• Essaie de coller manuellement (Ctrl+V) pour vérifier

Si VoxWave ne démarre pas ou se comporte bizarrement sur Linux, vérifie les points suivants :

• libxcb-cursor0 manquant : VoxWave crashe au démarrage avec une erreur Qt. Fix : sudo apt install libxcb-cursor0
• Texte qui ne s'injecte pas : VoxWave a besoin de xclip et xdotool pour les opérations clipboard sur X11. Fix : sudo apt install xclip xdotool
• Widget transparent qui s'affiche mal : assure-toi que ton environnement de bureau a le compositing activé (la plupart des desktops modernes l'ont par défaut)
• AppImage qui ne se lance pas : assure-toi qu'il est exécutable (chmod +x VoxWave-x86_64.AppImage) et que FUSE est installé (sudo apt install fuse)

Si tu appuies sur le raccourci sans parler, Whisper peut générer du texte fantôme. VoxWave détecte et rejette automatiquement les hallucinations connues.