diff --git a/Readme.md b/Readme.md new file mode 100644 index 0000000..9095c1b --- /dev/null +++ b/Readme.md @@ -0,0 +1,81 @@ +# Readme + +# 🎙️ Déclencheur Vocal + +Cette application permet de **déclencher des sons ou des programmes exécutables par commande vocale**. Elle utilise la bibliothèque **Vosk** pour la reconnaissance vocale hors ligne et propose une interface graphique via **Tkinter**. + +--- + +## 🛠 Fonctionnalités + +- 🎤 Reconnaissance vocale en temps réel +- 🔊 Lecture de fichiers `.mp3` ou lancement de `.exe` via une phrase clé +- 📁 Interface graphique pour gérer les phrases déclencheuses ("mappings") +- 📦 Support de plusieurs modèles Vosk (sélectionnable via une liste déroulante) +- 🔊 Contrôle du volume +- 🔧 Ajout et suppression facile de commandes vocales +- 🔍 Sélection de périphériques audio (entrée/sortie) + +--- + +## 📁 Structure des fichiers + +``` +bash +``` + +CopierModifier + +`📦 TonRépertoire ├── config.json # Sauvegarde des mappings (phrase → action) ├── Son/ # Contient les fichiers audio .mp3 copiés ├── Model/ # Contient les modèles Vosk (ex: vosk-model-small-fr) ├── ton_script.py # Ce script principal` + +--- + +## ✅ Dépendances + +- `vosk` +- `pyaudio` +- `sounddevice` +- `soundfile` +- `numpy` +- `tkinter` (standard avec Python) +- `shlex`, `subprocess`, etc. + +> 🔧 Installe-les via pip si besoin : + +``` +bash +``` + +CopierModifier + +`pip install vosk pyaudio sounddevice soundfile numpy` + +--- + +## ▶️ Lancer l'application + +``` +bash +``` + +CopierModifier + +`python ton_script.py` + +--- + +## 📌 Utilisation + +1. Choisis un modèle Vosk dans la liste (au démarrage). +2. Sélectionne ton micro et ta sortie audio. +3. Clique sur **"Ajouter mapping"** pour associer une phrase à un fichier `.mp3` ou `.exe`. +4. Parle dans le micro. Dès que la phrase est reconnue, l'action est exécutée. +5. Utilise les boutons pour supprimer un mapping ou arrêter un son. + +--- + +## ⚠️ Remarques + +- L'application fonctionne **hors ligne** grâce aux modèles Vosk. +- Les fichiers `.mp3` sont copiés localement dans `Son/`. +- Les mappings sont enregistrés dans `config.json`. \ No newline at end of file