Ajout Readme

This commit is contained in:
2026-03-24 07:58:27 +01:00
parent da4bdbd3d3
commit 206f925886

81
Readme.md Normal file
View File

@@ -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`.