Configuration

Configurer murmurai via le fichier de configuration, les modèles et les raccourcis.

Fichier de configuration

murmurai se configure via le fichier ~/.config/murmurai/config.json. Ce fichier est créé automatiquement au premier lancement avec les valeurs par défaut. Vous pouvez le modifier pour personnaliser le comportement de murmurai.
{
  "model_size": "small",
  "language": "fr",
  "hotkey_transcript": "right_option",
  "hotkey_agent": "right_command",
  "ollama_model": "llama3",
  "jargon": {
    "commettre": "commit",
    "pousser": "push",
    "tirer": "pull",
    "fusionner": "merge"
  }
}

Modèles Whisper disponibles

murmurai supporte cinq tailles de modèle Whisper. Le choix du modèle affecte la vitesse de transcription et la qualité : | Modèle | Taille | Vitesse | Qualité | |----------|-----------|-------------|-------------| | tiny | ~75 Mo | Très rapide | Basique | | base | ~150 Mo | Rapide | Correcte | | small | ~500 Mo | Modérée | Bonne | | medium | ~1.5 Go | Lente | Très bonne | | large-v3 | ~3 Go | Très lente | Meilleure | Le modèle par défaut est "small", qui offre le meilleur compromis entre vitesse et qualité pour un usage quotidien. Le modèle est également sélectionnable directement depuis la barre de menu de murmurai.

Changer le modèle

Le modèle Whisper peut être changé de deux façons : 1. Depuis la barre de menu — Cliquez sur l'icône murmurai dans la barre de menu et sélectionnez la taille de modèle souhaitée. Le changement est immédiat. 2. Via le fichier de configuration — Modifiez la clé "model_size" dans ~/.config/murmurai/config.json. Le modèle sera téléchargé automatiquement si nécessaire (la première fois uniquement).
# Dans ~/.config/murmurai/config.json
# Changer "small" par "tiny", "base", "medium" ou "large-v3"
"model_size": "small"

Touche de raccourci

Les raccourcis clavier sont configurables via le fichier ~/.config/murmurai/config.json : • hotkey_transcript — Touche pour le Mode Transcript (défaut : Option droite). Maintenez pour dicter, relâchez pour transcrire et coller. • hotkey_agent — Touche pour le Mode Agent (défaut : Command droite). Maintenez pour dicter une instruction, relâchez pour envoyer à Ollama. Il n'est plus nécessaire de modifier le code source pour changer les raccourcis.
# Dans ~/.config/murmurai/config.json
"hotkey_transcript": "right_option",
"hotkey_agent": "right_command"

Dictionnaire de jargon

murmurai intègre un dictionnaire de ~100 termes de jargon technique pour corriger les erreurs courantes de transcription bilingue FR/EN. Par exemple : • "commettre" → "commit" • "pousser" → "push" • "tirer" → "pull" • "fusionner" → "merge" • "déployer" → "deploy" Les termes sont appliqués en post-traitement via une fusion locale (sans Ollama). Vous pouvez ajouter vos propres termes dans la section "jargon" du fichier de configuration :
# Dans ~/.config/murmurai/config.json
"jargon": {
  "commettre": "commit",
  "pousser": "push",
  "mon terme": "my_term"
}

Langue de transcription

La langue de transcription est configurable dans ~/.config/murmurai/config.json via la clé "language". murmurai supporte la transcription bilingue FR/EN nativement, avec fusion locale de jargon. faster-whisper supporte plus de 90 langues. La détection automatique est également disponible si aucune langue n'est spécifiée.

Modèles Ollama

Le Mode Agent nécessite Ollama installé localement (https://ollama.ai). Ollama n'est pas requis pour le Mode Transcript. Le modèle Ollama utilisé par le Mode Agent est sélectionnable dynamiquement depuis la barre de menu de murmurai. murmurai détecte automatiquement les modèles disponibles dans votre installation Ollama. Vous pouvez également définir un modèle par défaut dans le fichier de configuration :
# Dans ~/.config/murmurai/config.json
"ollama_model": "llama3"