Ajout Readme
This commit is contained in:
81
Readme.md
Normal file
81
Readme.md
Normal 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`.
|
||||
Reference in New Issue
Block a user