VoiceVoix
Talk to the global session: listening modes, confirmation, words, vocabulary, engines and the wake phrase.Parler à la session globale : modes d'écoute, confirmation, mots, vocabulaire, moteurs et phrase de réveil.
The voice is optional and local by default: [voice] enabled = true. It uses the tools voice-listen (speech to text, sherpa-onnx) and voice-say (text to speech, Piper); the palette action Voice: what is missing lists what to set up (tools, enrolment, voices, models, API keys).
La voix est optionnelle et locale par défaut : [voice] enabled = true. Elle utilise les outils voice-listen (parole vers texte, sherpa-onnx) et voice-say (texte vers parole, Piper) ; l'action de palette Voice: what is missing liste ce qu'il reste à installer (outils, enrôlement, voix, modèles, clés d'API).
1. Listening modesModes d'écoute
Mode ([voice] mode) | Listening | Prompt |
|---|---|---|
push | push-to-talk: F5 starts, F5 again stops | every sentence heard while listening |
auto | always; F5 pauses / resumes | every sentence heard |
wake | always | only after the wake phrase (wake_word = "ok claude"): ok claude, list the sessions sends it; the phrase alone arms the listening for wake_seconds |
--voice auto|wake|push sets it for one run. The speech model loads at start (about 10 s); only_me = true accepts only your enrolled voice (voice-enroll).
Mode ([voice] mode) | Écoute | Prompt |
|---|---|---|
push | appuyer pour parler : F5 démarre, F5 arrête | chaque phrase entendue pendant l'écoute |
auto | toujours ; F5 met en pause / reprend | chaque phrase entendue |
wake | toujours | seulement après la phrase de réveil (wake_word = "ok claude") : ok claude, liste les sessions l'envoie ; la phrase seule arme l'écoute pendant wake_seconds |
--voice auto|wake|push le fixe pour une exécution. Le modèle de parole se charge au démarrage (environ 10 s) ; only_me = true n'accepte que votre voix enrôlée (voice-enroll).
2. ConfirmationConfirmation
What is heard shows live in the voice bar, then waits confirm_seconds (3) with its target and a countdown, with the buttons Send now, Drop, Correct (or Enter, Esc, Ctrl+C). Say a send word (envoie, valide, go, send) or a cancel word (annule, stop, cancel) alone and it acts at once. The words are in voice-words.txt of the config folder (settings Voice > Voice words), one per line under [cancel] and [send]. <session>: ... addresses one session by its exact name.
The global session receives the text marked [voice] and asks again when a word looks misheard or the request is ambiguous.
Ce qui est entendu s'affiche en direct dans la barre de voix, puis attend confirm_seconds (3) avec sa cible et un compte à rebours, avec les boutons Send now, Drop, Correct (ou Entrée, Échap, Ctrl+C). Dites seul un mot d'envoi (envoie, valide, go, send) ou un mot d'annulation (annule, stop, cancel) et il agit aussitôt. Les mots sont dans voice-words.txt du dossier de config (réglages Voice > Voice words), un par ligne sous [cancel] et [send]. <session>: ... s'adresse à une session par son nom exact.
La session globale reçoit le texte marqué [voice] et redemande quand un mot semble mal entendu ou que la demande est ambiguë.
3. VocabularyVocabulaire
Proper names that recognition bends are written back before the sentence is shown: vocabulary.txt (settings Voice > Vocabulary) maps a name to the ways it is heard (libutils = lib utils, lib you tils). The names of your sessions, the projects of the map of your computer and your own names are added by themselves.
Les noms propres que la reconnaissance déforme sont réécrits avant l'affichage de la phrase : vocabulary.txt (réglages Voice > Vocabulary) associe un nom aux façons dont il est entendu (libutils = lib utils, lib you tils). Les noms de vos sessions, les projets de la carte de votre ordinateur et vos propres noms sont ajoutés tout seuls.
4. Answers aloudRéponses à voix haute
The global session's answers are spoken as a short summary in their language (speak, summary_chars). F6 or Ctrl+C stops it. say_engine picks the engine (local piper, kokoro, or the free-tier elevenlabs / cartesia; a failing engine falls back to Piper) and say_voices the voice per language.
Les réponses de la session globale sont lues en résumé court, dans leur langue (speak, summary_chars). F6 ou Ctrl+C l'arrête. say_engine choisit le moteur (piper local, kokoro, ou elevenlabs / cartesia en offre gratuite ; un moteur en échec retombe sur Piper) et say_voices la voix par langue.
5. EnginesMoteurs
listen_model chooses the recogniser: local parakeet (French, English, mixed), whisper (99 languages, slower), kroko-fr (French only, live, fastest), or the free-tier APIs groq and deepgram (a key stored by claude-cluster auth login groq). claude-cluster engines lists each engine with its limits, free use and whether it is ready.
listen_model choisit le reconnaisseur : parakeet local (français, anglais, mélangé), whisper (99 langues, plus lent), kroko-fr (français seul, en direct, le plus rapide), ou les API gratuites groq et deepgram (clé stockée par claude-cluster auth login groq). claude-cluster engines liste chaque moteur avec ses limites, son usage gratuit et s'il est prêt.
6. The web page and the phoneLa page web et le téléphone
The web page uses the microphone of the browser (https is required): tap to talk or hands-free, each sentence recognised by the speech model of the computer. See Interfaces.
La page web utilise le micro du navigateur (https obligatoire) : tap to talk ou hands-free, chaque phrase reconnue par le modèle de parole de l'ordinateur. Voir Interfaces.
7. Wake phrase while closedPhrase de réveil fenêtre fermée
claude-cluster service enable installs a user systemd unit whose light detector hears the wake phrase and opens claude-cluster with the voice on. Nothing heard is kept: the audio goes through a ring of 0.5 s that is overwritten in place. See Settings.
claude-cluster service enable installe une unité systemd utilisateur dont le détecteur léger entend la phrase de réveil et ouvre claude-cluster avec la voix active. Rien de ce qui est entendu n'est gardé : l'audio passe par un anneau de 0,5 s écrasé sur place. Voir Réglages.