Homex

Le framework Home Assistant génial et opinionated. (The awesome, opinionated Home Assistant framework.)

Homex gère la maison pièce par pièce. Lumières, interrupteurs muraux, volets roulants, chauffage et qualité de l'air sont des modules qu'on active par pièce, qu'on configure depuis un seul panneau dans la barre latérale, et qu'on affiche sur ses dashboards avec une seule carte. Pas de YAML, pas d'automatisations de colle.

Module	Rôle
💡 Lumières	Un interrupteur de pièce, un groupe de lumières et des scènes natives. Des groupes pour une partie de la pièce, des déclencheurs pour allumer / éteindre, faire défiler les scènes ou varier l'intensité.
🎛 Interrupteurs	On dessine un interrupteur mural ou une télécommande une fois par modèle, puis on associe chaque bouton et chaque type d'appui à une action de la pièce.
🪟 Volets	Volets roulants en groupes : ouvrir, fermer, stop, et un basculement intelligent qui sait quand un volet est en mouvement.
🌡 Climat	Capteurs de qualité de l'air par pièce, vannes de radiateurs pilotées par consignes et zones, et une chaudière qui ne tourne qu'à la demande.

Interface en français et en anglais (suit la langue de Home Assistant, ou se règle dans Paramètres → Appareils et services → Homex → Configurer).

Modèle

Homex s'installe en un clic : une seule entrée de configuration, le hub « Homex ». Chaque pièce est ensuite un sous-élément (subentry) du hub, créé et géré entièrement depuis le panneau. Les pièces apparaissent imbriquées sous Homex dans Paramètres → Appareils et services, et leurs entités sont rattachées à la pièce.

Ce que crée une pièce / un groupe

Pour une pièce Chambre (id chambre) — slug = chambre ; pour un groupe Table de chevet (id table_de_chevet) — slug = chambre_table_de_chevet :

Entité	Nom affiché	Rôle
switch.homex_{slug}_lights_toggle	HX - {pièce}[ - {groupe}] - toggle lights	État allumé / éteint (géré par Homex).
light.homex_{slug}_lights	HX - {pièce}[ - {groupe}] - lights	Groupe de tous les appareils.
scene.homex_{slug}_turn_on	HX - {pièce} - on	Scène native « tout allumé ».
scene.homex_{slug}_turn_off	HX - {pièce} - off	Scène native « tout éteint ».

Les scènes sont natives : Homex les écrit dans config/scenes.yaml et les déclenche via scene.turn_on. Elles appartiennent ensuite à l'utilisateur (éditables dans l'éditeur de scènes HA) — Homex n'écrase jamais une scène existante. On peut ajouter d'autres scènes (HX - {pièce} - on - {nom}).

Un groupe pilote un sous-ensemble des appareils de la pièce, avec son propre switch, son groupe de lumières, ses scènes et ses déclencheurs.

Déclencheurs

Deux types, configurables par pièce et par groupe :

• toggle — bascule l'état (allumé ⇄ éteint) ;
• changement de scène — fait défiler les scènes (stratégie recall first / recall last).

Chaque déclencheur est soit une entité (changement d'état), soit un device (action native, ex. bouton). Les déclenchements provoqués par les propres actions de Homex sont ignorés (pas de boucle scène → device → trigger).

Installation

Nécessite Home Assistant ≥ 2025.1 (config subentries) et scene: !include scenes.yaml dans configuration.yaml — présent par défaut sur une installation HAOS standard (via default_config).

Via HACS (dépôt personnalisé)

1. HACS → menu ⋮ → Dépôts personnalisés.
2. Ajouter l'URL du dépôt, catégorie Integration.
3. Installer Homex, puis redémarrer Home Assistant.
4. Paramètres → Appareils et services → Ajouter une intégration → Homex (installation en un clic, sans champ).

Manuelle (HAOS / Container / Core)

1. Copier le dossier custom_components/homex/ dans /config/custom_components/ (via Samba, File editor, Studio Code Server ou SSH).
2. Redémarrer Home Assistant.
3. Ajouter une intégration → Homex.

Une fois installé, ouvrir Homex dans la barre latérale et cliquer ＋ Nouvelle pièce.

Développement

Environnement de dev jetable (HA dans Docker, intégration montée en direct) :

docker compose up -d          # HA sur http://localhost:8124

L'intégration (./custom_components/homex) est montée dans /config/custom_components. Le panneau est un composant Lit + Vite (frontend/), compilé en un bundle ES unique servi par l'intégration :

cd frontend
npm install
npm run build                 # -> custom_components/homex/panel/homex-panel.js

PANEL_VERSION (panel.py) et BUILD (homex-panel.ts) sont incrémentés ensemble pour casser le cache ; le badge Homex vN en haut du panneau confirme la version chargée (rechargement dur : Cmd/Ctrl+Shift+R).

Le dossier config/ est l'instance HA de dev. config/scenes.yaml et config/.storage/ sont ignorés par git (état runtime).

Notes mainteneur

Avant publication, renseigner dans custom_components/homex/manifest.json les champs documentation, issue_tracker et codeowners avec la vraie URL du dépôt et le compte GitHub.