Utilisation

Si vous avez installé via DMG, ouvrez simplement murmurai depuis /Applications ou Spotlight. En mode développeur, activez votre environnement virtuel et lancez murmurai :

source .venv/bin/activate
murmurai

Le Mode Transcript est le mode principal de dictée push-to-talk : 1. Placez votre curseur là où vous voulez insérer du texte (éditeur de code, navigateur, chat, email…) 2. Maintenez la touche Option droite (⌥) enfoncée 3. Parlez naturellement 4. Relâchez la touche Option droite 5. Le texte transcrit est automatiquement collé à la position du curseur La transcription se fait en streaming — le texte est prêt quasi instantanément quand vous relâchez la touche.

Le Mode Agent permet d'envoyer une instruction vocale et du texte sélectionné à un modèle Ollama local : 1. Sélectionnez du texte dans n'importe quelle application 2. Maintenez la touche Agent (configurable dans ~/.config/murmurai/config.json) 3. Dictez votre instruction vocale (ex. "refactorise cette fonction", "traduis en anglais") 4. Relâchez la touche — murmurai envoie l'instruction + le texte sélectionné au modèle Ollama 5. La réponse AI remplace directement la sélection Le Mode Agent nécessite Ollama installé localement. Le modèle Ollama est sélectionnable dynamiquement depuis la barre de menu. Vous pouvez annuler une requête en cours à tout moment.

murmurai affiche un HUD overlay visuel indiquant l'état du traitement en cours : • Enregistrement — Le HUD s'affiche quand vous maintenez la touche push-to-talk, confirmant que l'audio est capturé. • Transcription — Pendant le traitement de l'audio par Whisper, le HUD indique que la transcription est en cours. • Traitement Agent — En Mode Agent, le HUD affiche l'état de la requête Ollama (envoi, streaming de la réponse). Le HUD disparaît automatiquement une fois le traitement terminé.

murmurai est particulièrement utile pour : • Rédiger des emails ou messages longs • Écrire des commentaires de code ou de la documentation • Prendre des notes rapidement • Dicter du texte dans n'importe quelle application • Répondre dans un chat ou un terminal • Refactoriser du code via le Mode Agent • Traduire du texte sélectionné via instruction vocale Le texte est collé dans n'importe quelle application qui accepte Cmd+V.

Les logs de l'application sont accessibles depuis le menu "Open Logs" ou directement dans le fichier dédié :

# Emplacement des logs
~/Library/Logs/murmurai/murmurai.log

# Consulter les logs en temps réel
tail -f ~/Library/Logs/murmurai/murmurai.log