Tahoma est une API simple pour contrôler les appareils Somfy Tahoma en utilisant Python 3, grâce à l'API pyoverkiz. Avec seulement trois mots, vous pouvez contrôler vos appareils. Elle a été initialement créée pour Tahoma mais fonctionne également avec Somfy Connectivity Kit, Connexoon, et Cozytouch.
- Contrôlez les appareils Somfy Tahoma avec une API simple écrite en Python 3
- Créez des scripts ou des raccourcis pour contrôler votre maison depuis un serveur domestique ou votre ordinateur
- Avec cette API, vous pouvez intégrer les produits Somfy avec d'autres appareils compatibles Matter
- Fonctionne avec Somfy Connectivity Kit, Connexoon, Cozytouch et plus encore
- Prend en charge différents appareils Somfy : alarme, volet, prise, chauffage, capteurs, scènes, etc.
- Compatible avec les systèmes d'exploitation Windows et Linux
- 100 % fonctionnel avec ChatGPT
Si vous souhaitez installer Tahoma et Tahoma-GPT à l'aide d'un script simple sous Linux, suivez ces étapes :
-
Ouvrez votre terminal et accédez au répertoire dans lequel vous souhaitez télécharger le script
install_tahoma-gpt.sh
.Par exemple :
mkdir $HOME/tahoma-gpt
cd $HOME/tahoma-gpt
-
Téléchargez le script
install_tahoma-gpt_french.sh
en utilisant la commande suivante :wget -O "install_tahoma-gpt_french.sh" "https://github.com/pzim-devdata/tahoma/raw/main/install_tahoma-gpt_french.sh"
-
Rendez le script d'installation exécutable en exécutant la commande suivante :
chmod +x install_tahoma-gpt_french.sh
-
Exécutez le script d'installation dans le terminal en utilisant la commande suivante :
bash -c './install_tahoma-gpt_french.sh'
-
Vous pouvez maintenant démarrer tahoma-gpt_french.py dans un environnement virtuel :
-
cd $HOME/tahoma-gpt
(ou accédez au dossier d'installation avec le terminal) -
python3 -m venv env
-
source env/bin/activate
-
python3 tahoma-gpt_french.py
Si vous souhaitez exécuter tahoma sans tahoma-gpt dans le même environnement virtuel :
-
python3 tahoma.py
et suivez les instructions iciVous pouvez également exécuter des commandes en tant qu'arguments :
-
python3 "tahoma-gpt_french.py" Pourrais-tu ouvrir les volets dans la cuisine ?
-
En suivant ces étapes, Tahoma et Tahoma-GPT seront installés sur votre système Linux dans un environnement virtuel.
Vous pouvez créer un environnement virtuel en Python si vous souhaitez d'abord le tester. Tout sera installé dans le répertoire tahoma-gpt.
Tout d'abord, vous devez installer venv : pip install virtualenv
ou python3 -m pip install virtualenv
ou pipx install virtualenv
pour installer l'environnement virtuel.
- Créez un répertoire contenant
tahoma-gpt_french.py
etrequirements_tahoma-gpt.txt
à l'intérieur
. Téléchargez-les depuis ici et ici.
-
Ouvrez un terminal.
-
Accédez au répertoire que vous venez de créer.
-
Exécutez :
python3 -m venv env
(Windows :virtualenv --python C:\Chemin\Vers\Python\python.exe venv
) -
Exécutez :
source env/bin/activate
(Windows :.\venv\Scripts\activate
) -
Installez Tahoma et configurez-le (si ce n'est pas déjà fait) :
6.1. Exécutez :
python3 -m pip install -U tahoma
6.2 Configurez Tahoma :
tahoma -c
6.3 Obtenez la liste de vos appareils :
tahoma -g
-
Exécutez :
python3 -m pip install -r requirements_tahoma-gpt.txt
-
Modifiez le script
tahoma-gpt_french.py
avec un éditeur de texte pour ajouter la clé API OpenAI -
Exécutez :
python3 tahoma-gpt_french.py
-
Jouez avec Tahoma et ChatGPT.
-
Exécutez :
exit
(pour quitter tahoma-gpt) -
Exécutez :
exit()
(pour quitter Python) -
Exécutez :
deactivate
(pour désactiver l'environnement virtuel)
(Ceci est un tutoriel rapide)
##############################################################################
Note: Il s'agit d'une version portable à télécharger directement. Il ne s'agit pas d'un paquetage installé. Pour lancer l'application, il suffit d'exécuter python3 tahoma.py
dans votre dossier importé. Si vous voulez installer le paquet en utilisant PyPI (version pip), allez à : Comment installer tahoma avec pip ? ou visitez directement le site Pypi du projet pour un processus d'installation plus facile.
Si vous aimez ce programme, veuillez lui attribuer une étoile sur GitHub pour améliorer la visibilité de Tahoma et permettre à d'autres personnes d'en bénéficier. :star :
Télécharger le fichier zip et l'extraire dans un dossier choisi :
Exécutez les commandes suivantes dans votre dossier importé :
python3 -m pip install -r requirements.txt
afin d'installer les dépendances etpython3 tahoma.py
pour s'assurer que Tahoma démarre.
Il n'y a que deux commandes à exécuter une fois pour configurer Tahoma :
Tous les détails sont expliqués dans python3 tahoma.py --help-french
et python3 tahoma.py --info
.
- Spécifiez vos informations de connexion Somfy-connect et choisissez le serveur Somfy : :
python3 tahoma.py --configure
oupython3 tahoma.py -c
- Récupérez la liste de vos appareils Somfy personnels : :
python3 tahoma.py --getlist
oupython3 tahoma.py -g
USAGE: python3 tahoma.py [ACTION] [CATEGORIES] [NOM]
Par exemple : tahoma open shutter kitchen
ou tahoma ouvrir volet cuisine
Pour retrouver vos commandes personnelles, vous pouvez utiliser les options suivantes :
- Lister toutes les [ACTIONS] possibles pour chaque [CATEGORIES] :
python3 tahoma.py --list-actions
outahoma -la
oupython3 tahoma.py --list-actions-french
outahoma -laf
- Liste des [CATEGORIES] disponibles :
python3 tahoma.py --list-categories
outahoma -lc
oupython3 tahoma.py --list-categories-french
outahoma -lcf
- Récupérez les [NOMS] que vous avez assignés à vos appareils personnels dans l'application Somfy :
python3 tahoma.py --list-names
outahoma -ln
oupython3 tahoma.py --list-names-french
outahoma -lnf
Vous êtes maintenant prêt à utiliser tahoma
Pour plus d'informations, consultez python3 tahoma.py -h
ou python3 tahoma.py -i
Utilisation: python3 tahoma.py [ACTION] [CATEGORIE] [NOM]
Par exemple : tahoma open shutter kitchen
ou tahoma ouvrir volet cuisine
- Vous pouvez spécifier le niveau de fermeture des volets ou des écrans solaires avec une valeur numérique en tant qu'ACTION.
Par exemple, pour fermer un volet ou un pare-soleil à 25 % :
tahoma 25 shutter kitchen
tahoma 25 sunscreen kitchen
.
Veuillez noter que cette fonction ne fonctionne qu'avec les protocoles IO et non avec RTS.
- Vous pouvez utiliser un mot unique :
bath
ou le nom complet d'un dispositif entre crochets[""]
:["bath 1st floor"]
) comme paramètre NAME.
Par exemple :
tahoma ouvrir volet jardin
tahoma arme l'alarme ["porte du jardin"]
- Plusieurs commandes peuvent être exécutées dans le même processus sans redémarrer Tahoma.
Par exemple :
tahoma arm alarm garden open shutter ["room 6"] confort heater dining off plug office 25 sunscreen kitchen launch scene morning
- Il existe également une fonctionnalité d'attente avec
wait for
ousleep for
ouattendre pendant
:
Par exemple :
tahoma ouvrir volet cuisine attendre pendant 20 fermer volet cuisine
- Comme il est impossible d'arrêter un périphérique RTS en cours d'execution, vous pouvez annuler la commande précédente immédiate (sans affecter une commande "attendre pendant "). Pour cela, utilisez la commande "cancel last action" ou "annuler précédente commande" juste après une commande qui ouvre ou ferme un périphérique RTS.
Par exemple :
tahoma ouvrir volet cuisine attendre pendant 2 annuler precedente commande
: Cela va arreter le volet de la cuisine après 2 secondes
tahoma ouvrir volet cuisine ouvrir volet chambre6 annuler precedente commande
: Cela va seulement arreter le volet de la chambre 6
Voici quelques exemples de commandes :
- tahoma ouvrir volet cuisine
- tahoma 25 volet Velux3 (Ferme le volet à 25%)
- tahoma etat capteur ["Luminance sensor garden"] (Vous pouvez utiliser le nom complet du dispositif avec
["<NOM>"]
) - tahoma obtenir capteur door (Fournit des informations sur tous les capteurs nommés "door" dans la maison)
- tahoma recuperer capteur ["Porte d'entrée"]
- tahoma on prise bureau
- tahoma ouvrir volet ["chambre 6"]
- tahoma armer alarme jardin
- tahoma confort chauffage manger
- tahoma get sensor ["chauffage salle à manger"]
- tahoma lancer scenario matin
- tahoma activer alarme jardin attendre pendant 10 ouvrir volet chambre6 attendre for 7 confort chauffage manger eteindre prise bureau 25 rideau cuisine lancer scenario matin obtenir capteur ["salle à manger"]
- tahoma confort chauffage manger attendre pour 3 recup capteur ["Chauffage salle à manger"]
- tahoma ouvrir volet cuisine ouvrir volet chambre6 attendre pendant 10 annuler precedente commande` : Cela va seulement arreter le volet de la chambre 6 après 10 secondes
Pour pouvoir lancer tahoma directement dans le terminal, sans aller au dossier source, vous devez ajouter le dossier de tahoma au PATH :
En faisant cela, au lieu de taper python3 '/place/du/dossier/source/tahoma/tahoma.py ouvrir volet cuisine'
,
vous pourrez directement taper dans le terminal : tahoma ouvrir volet cuisine
.
Ensuite, exécutez tahoma comme ceci : tahoma activer alarme jardin attendre pendant 10 ouvrir volet chambre6 attendre for 7 confort chauffage manger eteindre prise bureau 25 rideau cuisine lancer scenario matin obtenir capteur ["salle à manger"]
et c'est tout !
Sous Linux, on peut le faire en permanence en exécutant : sudo gedit ~/.bashrc
et en ajoutant, à la fin du document, cette ligne :
export PATH=$PATH:/place/du/dossier/source/tahoma
Si vous voulez le tester temporairement avant, vous pouvez simplement exécuter cette commande dans le terminal :
export PATH=$PATH:/place/du/dossier/source/tahoma
Il sera restauré au prochain redémarrage.
Vous devez également renommer tahoma.py
en tahoma
Ensuite, exécutez tahoma comme ceci : tahoma activer alarme jardin attendre pendant 10 ouvrir volet chambre6 attendre for 7 confort chauffage manger eteindre prise bureau 25 rideau cuisine lancer scenario matin obtenir capteur ["salle à manger"]
et c'est tout !
Comment créer un PATH sous Windows
Grâce au programme tahoma.exe
, vous pourrez exécuter tahoma en entrant cette commande : tahoma
au lieu de python3 tahoma.py
sur Windows 10. Ne fonctionne pas avec Windows 11 depuis la derniere mise à jour.
Ensuite, exécutez tahoma comme ceci : tahoma activer alarme jardin attendre pendant 10 ouvrir volet chambre6 attendre for 7 confort chauffage manger eteindre prise bureau 25 rideau cuisine lancer scenario matin obtenir capteur ["salle à manger"]
et c'est tout !
SI VOUS VOULEZ INSTALLER LE PAQUET UTILISEZ PyPi (version pip) :
Installer tahoma :
python sudo python3 -m pip install -U tahoma
! !! Il est très important d'utiliser la commande sudo
car de cette façon tahoma peut stocker vos logins dans un endroit sûr.
C'est très facile à configurer, il y a juste deux commandes à exécuter une fois pour toutes la première fois
Tout est expliqué dans tahoma --help-french et tahoma --info
- Spécifiez votre login Somfy-connect et choisissez le serveur Somfy (la commande
sudo
est nécessaire) :
sudo tahoma --configure
ousudo tahoma -c
- Configurez l'API et obtenez la liste de vos appareils Somfy personnels (la commande
sudo
est également requise) :
sudo tahoma --getlist
ousudo tahoma -g
- Et maintenant, vous êtes prêt à utiliser tahoma :
Par exemple : tahoma open shutter kitchen
ou tahoma ouvrir volet cuisine
Vous pouvez également fermer un volet ou un écran solaire à un niveau spécifique. Par exemple, pour fermer à 25%, vous pouvez utiliser les commandes : tahoma 25 shutter kitchen
ou tahoma 25 sunscreen kitchen
. Veuillez noter que cette fonction ne fonctionne qu'avec les protocoles IO et non avec RTS.
Vous pouvez également exécuter plusieurs commandes au cours du même processus sans redémarrer tahoma ;
Par exemple : tahoma activer alarme jardin attendre pendant 10 ouvrir volet chambre6 attendre for 7 confort chauffage manger eteindre prise bureau 25 rideau cuisine lancer scenario matin obtenir capteur ["salle à manger"]
tahoma --list-actions
outahoma -la
ou
tahoma --list-actions-french
outahoma -laf
tahoma --list-categories
outahoma -lc
ou
tahoma --list-categories-french
outahoma -lcf
tahoma --list-names
outahoma -ln
ou
tahoma --list-names-french
outahoma -lnf
Pour plus d'informations tahoma -hf
ou tahoma -i
Sous Linux, si vous avez installé tahoma sans la commande sudo
, vous devrez créer un PATH pour lancer tahoma avec la commande tahoma
.
En effet, pour pouvoir lancer tahoma directement dans le terminal, sans passer par le paquet source, vous devez ajouter le dossier de tahoma au PATH :
Cela peut être fait de manière permanente en exécutant : sudo gedit ~/.bashrc
et en ajoutant, à la fin du document, cette ligne :
export PATH=$PATH:/place/du/dossier/source/tahoma
Si vous voulez le tester temporairement avant, vous pouvez simplement exécuter cette commande dans le terminal :
export PATH=$PATH:/place/du/dossier/source/tahoma
Il sera restauré au prochain redémarrage.
En faisant cela, au lieu de taper python3 '/place/du/dossier/source/tahoma/tahoma.py ouvrir volet cuisine'
,
vous pourrez taper directement dans le terminal : tahoma ouvrir volet cuisine
.
Ensuite, exécutez tahoma comme ceci : tahoma activer alarme jardin attendre pendant 10 ouvrir volet chambre6 attendre for 7 confort chauffage manger eteindre prise bureau 25 rideau cuisine lancer scenario matin obtenir capteur ["salle à manger"]
et c'est tout !
Pour :
Kit de connectivité Somfy Somfy Connexoon IO Somfy Connexoon RTS Somfy TaHoma Somfy TaHoma Beecon Somfy TaHoma Switch Thermor Cozytouch Et plus encore...
Appareils pris en charge : Alarme Volet Rideaux Chauffage Capteur Scenarios et plus encore si vous me demandez sur github :