fr CLI Reference

🌐 Langue : English | Français

Référence CLI

Référence complète pour chaque commande livrée par dictée. Toutes les commandes sont installées sous /usr/bin/ (système) ou ~/.local/bin/ (install utilisateur).

Trois catégories : entrypoints shell (dictee, dictee-setup, dictee-switch-backend), helpers Python (dictee-tray, dictee-postprocess, dictee-test-rules), et binaires Rust (transcribe, transcribe-daemon, transcribe-client, transcribe-diarize, transcribe-stream-diarize, transcribe-diarize-batch).

Table des matières

• Entrypoints shell
  • dictee
  • dictee-setup
  • dictee-switch-backend
  • dictee-ptt
• Helpers Python
  • dictee-tray
  • dictee-postprocess
  • dictee-test-rules
• Binaires Rust
• Variables d'environnement
• Codes de sortie
• Fichiers d'état

---

Entrypoints shell

dictee

Entrypoint principal. Bascule la dictée on/off, ou lance des modes one-shot via flags.

Synopsis :

dictee [--translate] [--meeting] [--cancel] [--setup] [--reset]

Flags :

Flag	Description
(aucun)	Basculer la dictée — appuyer une fois pour démarrer, re-appuyer pour arrêter
--translate	Transcrire + traduire vers $DICTEE_LANG_TARGET
--meeting	Transcrire avec diarisation (labels locuteurs)
--cancel	Annuler l'enregistrement en cours
--setup	Lancer dictee-setup (équivalent à lancer l'assistant de configuration)
--reset	Effacer les fichiers d'état dans /dev/shm — à utiliser si dictée est bloquée
--help	Afficher l'aide

Exemples :

# Dictée simple
dictee

# Traduire FR → EN
DICTEE_LANG_SOURCE=fr DICTEE_LANG_TARGET=en dictee --translate

# Mode meeting (diarisation)
dictee --meeting

# Annuler l'enregistrement en cours
dictee --cancel

---

dictee-setup

GUI PyQt6 pour la configuration complète. Lance l'assistant au premier run, ou ouvre le panneau de configuration principal aux runs suivants.

Synopsis :

dictee-setup [--wizard] [--postprocess] [--translation]

Flags :

Flag	Description
(aucun)	Ouvrir panneau config principal
--wizard	Forcer mode assistant (même si déjà configuré)
--postprocess	Ouvrir directement le dialogue post-traitement
--translation	Ouvrir sur la section configuration traduction

---

dictee-switch-backend

Basculer le backend ASR ou traduction sans redémarrage.

Synopsis :

dictee-switch-backend <sous-commande> [args]

Sous-commandes :

Commande	Description
status	Afficher les backends ASR + traduction actuels
list	Lister tous les backends disponibles
asr <nom>	Basculer l'ASR sur parakeet / canary / whisper / vosk
translate <nom>	Basculer la traduction sur canary / libretranslate / ollama / google / bing

---

dictee-ptt

Daemon push-to-talk qui écoute /dev/input/event* pour les keycodes et déclenche la dictée. Alternative aux raccourcis natifs KDE/GNOME.

Synopsis :

dictee-ptt [--mode=toggle|hold|double-tap] [--key=<code>] [--key-translate=<code>] [--mod-translate=alt|ctrl|shift|super] [--double-tap-ms=<ms>]

Voir Keyboard-Shortcuts#daemon-dictee-ptt pour usage détaillé. Normalement géré par le service systemd utilisateur dictee-ptt.service.

---

Helpers Python

dictee-tray

Icône systray. Voir Tray-Icon.

Synopsis :

dictee-tray [--debug] [--no-autostart]

Normalement démarré via l'unité systemd utilisateur dictee-tray.service.

---

dictee-postprocess

Exécute le pipeline de post-traitement en 12 étapes sur stdin ou un texte donné, sort le résultat sur stdout.

Synopsis :

dictee-postprocess --lang <xx> [--llm-position=first|last|hybrid|off]
                   [--no-translate] [--rules=<chemin>] [--dict=<chemin>]

Exemples :

echo "Bonjour virgule comment allez-vous" | dictee-postprocess --lang fr
# → "Bonjour, comment allez-vous"

# Désactiver LLM pour un test
echo "rough asr output" | dictee-postprocess --lang en --llm-position=off

# Fichier de règles personnalisé
echo "texte" | dictee-postprocess --lang fr --rules ~/mes-regles.conf

---

dictee-test-rules

Harnais de test interactif pour règles regex. Voir Rules-and-Dictionary#tester-les-règles-en-direct.

Synopsis :

dictee-test-rules [--loop] [--wav <fichier>] [--rules <chemin>] [--lang <xx>]

---

Binaires Rust

Binaire	But
transcribe	Transcription CLI one-shot d'un fichier WAV
transcribe-daemon	Garde le modèle en mémoire, écoute sur socket Unix
transcribe-client	Client daemon + enregistrement micro
transcribe-diarize	Sortformer + Parakeet-TDT en un appel
transcribe-stream-diarize	Sortformer + Nemotron (EN seul) en streaming
transcribe-diarize-batch	Pipeline chunked pour audio long (auto-utilisé par dictee-transcribe depuis v1.3.4)

Socket path : $XDG_RUNTIME_DIR/transcribe.sock (défaut /run/user/$UID/transcribe.sock).

Exemple daemon :

transcribe-daemon [--parakeet|--canary|--nemotron] [--model <chemin>] [--lang <xx>]

Exemple client :

transcribe-client <audio.wav>            # transcrire un fichier
transcribe-client --record               # enregistrer depuis micro et transcrire

---

Variables d'environnement

Configuration runtime. Définir via dictee.conf ou exporter dans votre shell :

Mode dictée

Var	Valeurs	Défaut	Description
DICTEE_ASR_BACKEND	parakeet, canary, whisper, vosk	parakeet	Backend ASR actif
DICTEE_LANG_SOURCE	ISO 639-1	$LANG	Langue source
DICTEE_LANG_TARGET	ISO 639-1	en	Cible de traduction
DICTEE_TRANSLATE	0 / 1	0	Jamais persisté — éphémère uniquement
DICTEE_MEETING	0 / 1	0	Mode meeting (diarisation)

Post-traitement

Var	Valeurs	Description
DICTEE_PP_LLM	0 / 1	Désactiver correction LLM pour cette dictée
DICTEE_PP_NUMBERS	0 / 1	Toggle conversion nombres
DICTEE_LLM_MIN_WORDS	entier	Sauter LLM pour dictées plus courtes que N mots

Backends

Var	Défaut	Description
DICTEE_OLLAMA_HOST	http://localhost:11434	Endpoint Ollama
DICTEE_OLLAMA_MODEL	gemma3:4b	Tag modèle Ollama
DICTEE_LIBRETRANSLATE_HOST	http://localhost:5000	Endpoint LibreTranslate
DICTEE_WHISPER_MODEL	large-v3-turbo	Modèle faster-whisper
DICTEE_VOSK_MODEL	(auto)	Chemin modèle Vosk

Runtime

Var	Défaut	Description
DICTEE_FORCE_CPU	0	Forcer CPU même si GPU disponible
DICTEE_INTRA_THREADS	(auto)	Nombre de threads intra-op ONNX Runtime (défaut : min(8, nproc)). Diminuer (2-4) pour économiser la batterie ou partager le CPU avec d'autres tâches. Ne pas dépasser le nombre de threads CPU.
DICTEE_PARAKEET_QUANT	(auto)	Variante du modèle Parakeet : int8 (~670 Mo, ~34 % plus rapide sur CPU avec AVX-VNNI) ou fp32 (~2,4 Go, plus rapide sur GPU). Les deux variantes peuvent cohabiter sur disque ; cette variable choisit laquelle charger. Défaut : auto-détecté selon VRAM (int8 si < 4 Go ou CPU uniquement, sinon fp32).
DICTEE_DEBUG	0	Logging verbeux
DICTEE_STATE_DIR	/dev/shm	Override emplacement fichiers d'état

---

Codes de sortie

Code	Signification
0	Succès
1	Erreur générique
2	Arguments invalides
3	Daemon non lancé / connexion refusée
4	Fichier modèle manquant
5	Capture audio échouée
6	Transcription échouée
7	Traduction échouée
8	Erreur post-traitement
126	Permission refusée (p. ex. /dev/input sans groupe input)

---

Fichiers d'état

L'état runtime vit dans /dev/shm (tmpfs, effacé au redémarrage). Sûr multi-utilisateur via suffixe UID.

Fichier	But
/dev/shm/.dictee_state_<UID>	Statut actuel : idle / recording / transcribing / offline
/dev/shm/.dictee_state_<UID>.lock	Coordination flock pour écritures concurrentes
/dev/shm/.dictee_toggles_<UID>	État toggles LLM / Short / Meeting
/dev/shm/.dictee_continuation_<UID>	Tampon dernier-mot pour continuation
$XDG_RUNTIME_DIR/transcribe.sock	Socket Unix daemon
~/.config/dictee.conf	Configuration utilisateur persistante
~/.config/dictee/rules.conf	Règles regex utilisateur (fusionnées au-dessus des défauts système)
~/.config/dictee/dictionary.conf	Dictionnaire utilisateur
~/.config/dictee/short_text_keepcaps.conf	Exceptions keepcaps utilisateur

---

Étapes suivantes

• Troubleshooting — diagnostiquer les erreurs CLI
• Developer-Guide — architecture source des binaires
• Keyboard-Shortcuts — dictee-ptt en profondeur
• Post-Processing-Overview — ce que fait dictee-postprocess