2025-04-27 19:45:45 +02:00

83 lines
2.5 KiB
Markdown

# Tuya Control pour StreamDeck
Ce projet permet de contrôler vos appareils Tuya (prises, lumières, volets, etc.) via des scripts Python, conçus pour être utilisés avec un StreamDeck.
## Structure du projet
```
tuya-control/
├── common/ # Fonctions utilitaires communes
│ ├── utils.py # Fonctions partagées
│ └── config.py # Configuration générale
├── devices/ # Scripts spécifiques par type d'appareil
│ ├── lights/ # Contrôle des lumières
│ ├── shutters/ # Contrôle des volets
│ ├── plugs/ # Contrôle des prises
│ ├── cameras/ # Contrôle des caméras
│ └── others/ # Autres types d'appareils
├── scripts/ # Scripts utilitaires
│ ├── scan_devices.py # Scanner les appareils sur le réseau
│ └── status_devices.py # Afficher le statut des appareils
├── devices.json # Base de données des appareils
└── README.md # Ce fichier
```
## Configuration du StreamDeck
Pour utiliser ces scripts avec votre StreamDeck:
1. Configurez une touche sur votre StreamDeck pour exécuter un script Python
2. Pointez vers le script correspondant à l'appareil que vous souhaitez contrôler
(ex: `tuya-control/devices/lights/light_1_toggle.py`)
3. Définissez une icône appropriée pour l'état ON/OFF
Chaque script gère automatiquement la détection de l'état actuel et bascule entre allumé/éteint ou ouvert/fermé/arrêté selon le type d'appareil.
## Exemples d'utilisation
### Contrôler une prise
```bash
python tuya-control/devices/plugs/prise_cafe_toggle.py
```
### Contrôler un volet
```bash
python tuya-control/devices/shutters/volet_salon_toggle.py
```
### Contrôler une lumière
```bash
python tuya-control/devices/lights/light_1_toggle.py
```
### Scanner les appareils sur le réseau
```bash
python tuya-control/scripts/scan_devices.py
```
### Afficher le statut des appareils
```bash
python tuya-control/scripts/status_devices.py
```
## Personnalisation
Pour ajouter ou modifier des appareils, il suffit de copier un script existant et d'adapter:
- L'ID de l'appareil
- Le nom de l'appareil
- Le type de commande (DPS) spécifique à l'appareil
## Dépendances
Ce projet nécessite:
- Python 3.6+
- La bibliothèque tinytuya
Pour installer les dépendances:
```bash
pip install tinytuya
```
## Remarques
Pour que les scripts fonctionnent, le fichier `devices.json` doit contenir les informations de connexion pour tous vos appareils, incluant les clés locales.