Prise en main

Guide d’utilisation

Pièces, appareils, tableaux de bord, chauffage, alarme : le tour complet.

Se connecter

Adresse : http://<adresse-du-serveur>/ (ou http://<nom-du-serveur>.local/). En HTTPS : https://<adresse-du-serveur>/, après avoir installé http://<adresse-du-serveur>/ca.crt sur l'appareil (voir docs/exploitation.md).
Première fois : l'assistant demande le code d'installation (sur le serveur : sudo myhabitactl setup-code), puis crée votre compte administrateur, la maison (nom, ville pour le soleil) et les pièces.
Sur téléphone : ajoutez la page à l'écran d'accueil pour l'ouvrir comme une application.

Au quotidien

Accueil : mode de la maison (Présence, Absence, Nuit, Vacances), résumé (lumières allumées, température, alarme, appareils indisponibles) et vos pièces avec leurs commandes.
Lire un état :
- un interrupteur montre toujours l'état confirmé par l'appareil ;
- pendant l'envoi, il est entouré de pointillés animés ;
- un curseur affiche un repère à la valeur demandée tant qu'elle n'est pas confirmée ;
- si l'appareil ne confirme pas, une notification l'explique (« Non confirmée », « Échec », « Refusée »).
Valeurs signalées :
- « Indisponible » : l'appareil ne répond pas ;
- « Valeur périmée » : pas de nouvelle depuis trop longtemps ;
- « Dernière valeur connue » : la connexion au moteur est coupée ;
- « Valeur supposée » : l'appareil ne renvoie pas son état ;
- « En attente de l'équipement » : pas encore de rapport.
Badge « Simulé » : appareil du simulateur, qui n'existe pas physiquement.

Pièces et appareils

Appareils : renommer, changer de pièce, choisir une icône, ajouter des notes, consulter l'historique, le journal des commandes et les informations (fabricant, modèle, micrologiciel, référence du protocole).
Remplacer un appareil en panne : associez le nouveau, puis « Remplacer » sur l'ancien. Les tableaux de bord et automatisations continuent de fonctionner, sans rien modifier.
Rechercher et filtrer : recherche par nom, modèle ou adresse ; filtres Pièce, Type (lumières, chauffage, prises et relais, détecteurs, capteurs…), État (indisponibles, batterie faible, sans pièce…) et Intégration. Les filtres actifs s'affichent en étiquettes, retirables d'un clic.
Pièces : une carte par pièce, avec sa couleur, son icône, une image facultative (réduite avant l'envoi et conservée sur le serveur) et un résumé (température, humidité, lumières allumées, ouvertures). Crayon ou menu « … » pour modifier ; cliquer sur la carte affiche ses appareils ; glisser une carte change l'ordre ; dernière carte « + » pour ajouter une pièce.
Groupes : plusieurs lumières commandées comme une seule, avec un interrupteur sur leur carte. Le groupe est confirmé quand tous ses membres ont confirmé.
Scènes : réglez vos lumières, puis « Enregistrer l'ambiance actuelle » ; « Activer » sur la carte.

Intégrations (administrateurs)

Voir docs/integrations.md. Les parcours guidés couvrent : Zigbee (détection du coordinateur, appairage suivi en direct), appareils MQTT (comptes, description, écoute des messages), Matter (code d'appairage) et le simulateur.

Ajouter une intégration ouvre le catalogue : recherche par marque ou par appareil (« Hue », « Dreame », « Google », « Shelly »…) et familles (éclairage, prises et énergie, robots aspirateurs, multimédia, climat, météo, présence). Chaque intégration indique si elle fonctionne en local (sur le réseau de la maison, même sans Internet) ou par le cloud du fabricant, et si elle est en bêta ou non officielle (interface obtenue par rétro-ingénierie, qui peut cesser de fonctionner).
Le formulaire demande seulement ce qui est utile (adresse, compte, options). Les mots de passe et jetons ne sont jamais réaffichés : laissés vides lors d'une modification, ils sont conservés.
Détectés sur votre réseau : My Habita repère les équipements qu'il sait intégrer (pont Hue, prises, enceintes…) et propose de les ajouter en un clic, ou de les ignorer.
Pour les intégrations qui gèrent plusieurs appareils (Shelly, WLED, enceintes Google…), la liste Appareils de la carte Réglages se complète par adresse ou par Rechercher sur le réseau.

Lumières de couleur

La couleur se choisit sur une roue chromatique : l'angle donne la teinte, l'éloignement du centre la saturation.

Où : fenêtre d'une lampe, cartes des tableaux de bord, automatisations, application Android.
Couleur affichée : la roue montre la couleur confirmée par la lampe. Une couleur demandée mais pas encore confirmée apparaît en anneau pointillé (« … demandé »).
Envoi : la couleur part quand vous relâchez le curseur.
Lampes blanc et couleur (Philips Hue…) : onglets « Blanc » (température de blanc, du chaud au froid) et « Couleur ». Le point indique le mode actuel estimé de la lampe.
Pastilles rapides : blanc chaud, blanc froid et huit couleurs.
Automatisations : elles peuvent désormais régler une couleur directement.

Automatisations

Partir d'une recette : choisissez les détecteurs, lumières et durées ; les options (« Seulement s'il fait sombre », « Lumière réduite la nuit »…) s'activent par un interrupteur et n'affichent leurs réglages que si elles sont actives. L'explication et la validation s'affichent en direct ; l'enregistrement reprend toujours les valeurs affichées. Les heures se saisissent sur 24 h (« 22:30 », « 2230 » ou « 22h30 »).
Éditeur visuel : Quand → Et si → Alors, en blocs dépliables qui se lisent comme des phrases. « Ajouter… » ouvre un sélecteur par catégories qui explique chaque bloc (ce qu'il fait, avec quoi il marche, exemples). Chaque bloc peut être renommé, dupliqué, désactivé sans être supprimé, glissé ailleurs. Tester (simulation) montre ce qui se passerait maintenant, sans rien envoyer. Traces montre chaque exécution, étape par étape.
Variables (onglet Variables) : des entités virtuelles que vous créez — oui / non, nombre, compteur, liste de choix, texte, heure, minuteur, bouton virtuel, valeur calculée (« une fenêtre est ouverte », température moyenne…). Elles se placent sur les tableaux, se commandent depuis le téléphone, gardent leur valeur après un redémarrage, et servent dans les automatisations (« quand le bouton Je pars est appuyé », « si Mode invités est à non », « à l'heure du réveil », « démarrer le minuteur »…).
Scripts (onglet Scripts) : des suites d'actions réutilisables, lancées par un bouton, le téléphone ou une autre automatisation, avec des valeurs demandées au lancement (lumière visée, nombre de fois…).
Boutons des tableaux : simples ou bascule (marche / arrêt, avec leur état) ; ils peuvent activer, désactiver ou basculer une automatisation, lancer un script, modifier une variable, en plus des scènes, appareils et modes.
Sur le téléphone : un éditeur simplifié crée et modifie les automatisations avec les blocs essentiels ; l'éditeur complet reste accessible.
Multimédia : l'action « Multimédia (enceintes, téléviseurs) » lit un album, une playlist, une radio… sur des enceintes ou une zone, met en pause, reprend, arrête, passe au suivant ou règle le volume (voir docs/multimedia.md).
Détails dans docs/automatisations.md.

Chauffage

Quatre onglets : Zones, Thermostats, Chaudière, Planning. Le bouton en haut de la page correspond à l'onglet affiché (« Nouvelle zone », « Nouveau thermostat », « Nouveau planning »).

Mode général : Planning (chaque zone suit son planning), Manuel (plannings suspendus : chaque zone garde la température réglée à la main, jusqu'à nouvel ordre), Absence, Hors gel ou Arrêt. En passant en Manuel, chaque zone garde la consigne qu'elle avait ; on la règle ensuite avec − / + sur la carte de la zone, la jauge d'un thermostat ou l'appareil lui-même. Passer la maison en Absence ou en Vacances met le chauffage en absence ou en hors gel ; au retour, le mode d'avant (Planning ou Manuel) revient.
Thermostats My Habita : pour un chauffage commandé par un relais (radiateur électrique, plancher chauffant, chaudière, vanne de zone). Choisissez un ou plusieurs capteurs de température (moyenne, la plus basse ou la plus haute) et un ou plusieurs relais commandés ensemble (les deux voies d'un relais double par exemple). Options : relais inversé (contact normalement fermé), demande à la chaudière.
- Affichage : Jauge (comme un thermostat mural : faites glisser le curseur sur l'arc, ou − / +, la température mesurée est repérée par un point) ou Compact (valeurs et boutons). Le choix est mémorisé par navigateur.
- Régulation simple : chauffe sous « consigne − écart », s'arrête à « consigne + écart » (0,3 °C par défaut).
- Régulation précise (TPI) : à chaque cycle (15 min par défaut), temps de marche proportionnel à l'écart, avec un capteur extérieur facultatif. Pour les chauffages à forte inertie.
- Protections : marche et arrêt minimaux (3 min par défaut), arrêt de sécurité si aucune mesure récente (30 min) ou au-delà d'une température maximale (28 °C), relais remis dans l'état voulu s'il est changé à la main, un relais n'a qu'une source de commande.
- Le thermostat est une entité « thermostat » ordinaire : réglable depuis sa carte, un tableau de bord (carte « Thermostat », affichage Valeurs et boutons ou Jauge), une automatisation ou une zone. À la création, une zone peut être créée en même temps.
Chaudière : un ou deux relais (contact « thermostat d'ambiance » de la chaudière), mis en marche dès qu'une pièce demande de la chaleur — thermostat My Habita marqué « chaudière », tête thermostatique dont la vanne est ouverte, ou pièce sous sa consigne — avec marche et arrêt minimaux. L'état (et qui demande de la chaleur) est à gauche, les réglages regroupés à droite.
Planning : un planning fixe les températures (confort, éco, absence, hors gel) et la semaine type (créneaux confort / éco de chaque jour, copiables sur la semaine, le week-end ou tous les jours). Des périodes et saisons peuvent changer ces valeurs : une saison revient chaque année (hiver du 1er novembre au 31 mars plus chaud, été sans chauffage…), une période à dates précises (vacances) l'emporte sur une saison. Pendant une période : planning avec ses propres températures (et, si besoin, ses propres horaires), hors gel, ou arrêt. Le planning par défaut suffit le plus souvent ; on peut en créer d'autres (chambres, bureau) ou en dupliquer un.
Zones : nom, pièce, thermostats, têtes thermostatiques ou thermostats My Habita, modules fil pilote (l'ordre confort, éco, hors gel ou arrêt suit le mode de la zone), capteur de température facultatif, fenêtres, planning suivi (aperçu de la journée et des températures), protections (délai fenêtre ouverte, bornes de consigne, intervalle entre deux envois).
Chaque zone explique sa consigne (« Planning (Hiver) : confort depuis 06:30 », « Fenêtre ouverte depuis 4 min », « Dérogation 21 °C jusqu'à 22:30 », « Mode manuel : 20 °C ») et indique son planning et la période en cours.
Dérogation (mode Planning) : « Confort jusqu'au prochain créneau », « Éco 2 h », ou une température. Un réglage fait directement sur la tête thermostatique est respecté jusqu'au créneau suivant (en mode Manuel, il devient la température de la zone).

Sécurité : alarme et vidéosurveillance

Alarme et vidéosurveillance domotiques, non certifiées (NF&A2P, EN 50131). Elles ne remplacent ni une alarme certifiée ni une télésurveillance. Détails techniques : docs/surveillance.md.

Le menu Sécurité (ancien menu « Alarme ») a six onglets : Vue d'ensemble, Alarme, Caméras, Enregistrements, Événements et Réglages (administrateurs).

Alarme

Armer : Totale (vous partez : toute la maison, délai de sortie), Partielle (vous êtes là : ouvertures surveillées) ou Nuit (ouvertures et pièces de vie). Avec plusieurs secteurs (maison, garage…), choisissez le secteur ou armez tout.
Si une ouverture est ouverte, l'armement est refusé avec la liste des détecteurs ; vous pouvez armer dans le même mode en les contournant. Comme sur les centrales professionnelles, un détecteur contourné est de nouveau surveillé dès qu'il se referme (3 secondes au repos) : l'onglet Alarme l'indique « Contourné jusqu'à sa fermeture ».
Pendant une alarme, rouvrir la même porte ne relance rien et ne compte pas dans la limite de déclenchements du détecteur (une note au journal par minute au plus) ; un autre détecteur confirme l'intrusion.
Un capteur ou une caméra qui décroche brièvement (moins de 3 minutes par défaut) n'est ni signalé en défaut ni bloquant pour armer.
Désarmer : avec un code de l'alarme (Sécurité → Réglages → Personnes et codes) ou votre code personnel (Réglages → Mon compte). Après plusieurs codes erronés, le clavier est bloqué quelques minutes.
Alertes (incendie, fuite d'eau, gaz, panique, sabotage) : elles restent affichées jusqu'à leur acquittement par code, même si le capteur est revenu au repos.
Bouton d'alerte : maintenir 2 s, puis choisir alerte avec sirènes, silencieuse ou demande d'assistance.
Incidents : chaque déclenchement a sa fiche (chronologie, détecteurs, images et vidéos des caméras) à classer avec une note.
Journal filtrable : armements, alarmes, défauts, codes.
Téléphones et tablettes (application Android) : lors d'une intrusion ou d'une alerte, la notification insiste — vibration continue, ou vibration et sonnerie d'alarme selon le réglage — jusqu'à ce que vous ouvriez les notifications ; une seule notification par incident, retirée au désarmement (ou à l'acquittement de l'alerte). Chaque appareil peut choisir autrement (Plus → Ce téléphone → Alarme sur cet appareil), par exemple la sonnerie sur une tablette sans vibreur.
Écran mural et navigateur : bips pendant les délais, carillon à l'ouverture d'une porte et vibration pendant une intrusion (téléphone ou tablette Android, page ouverte) — réglables par navigateur dans Sécurité → Réglages → Ce navigateur ; bips et carillon activés par défaut sur les écrans muraux.

Réglages de l'alarme (administrateurs) :

Secteurs et délais de sortie / d'entrée par mode ; mode test pour vérifier chaque détecteur sans rien faire sonner.
Détecteurs : « Ajouter des capteurs » propose vos détecteurs avec un type deviné (porte → entrée/sortie, fenêtre → instantané, mouvement → intérieur suiveur, fumée → incendie, fuite → inondation…). Pour chacun : modes où il surveille, délai propre, carillon, silencieux, double détection, contournable, caméras qui le filment.
Sirènes : natures d'alarme qui la font sonner, secteurs, retard possible (levée de doute), et selon la sirène son d'intrusion, son d'incendie et de gaz, volume, flash. Bips au choix : délai de sortie, délai d'entrée, armement, désarmement (confirmation de la sirène si elle en a une), avec leur propre volume ; ils fonctionnent aussi pour les armements programmés. Boutons Essayer (5 s de sirène, chaque bip) sans armer. Une sirène qui ne propose ni son ni volume est simplement mise en marche.
Lumières : scénario (clignote en rouge, clignote en blanc, rouge fixe, blanc fixe, couleur au choix fixe ou clignotante), couleur, vitesse du clignotement, luminosité, natures d'alarme concernées, et Remettre la lumière comme avant à la fin de l'alarme (activé par défaut) ; bouton Essayer (6 s).
Réactions : durée de sirène, après la sirène, nombre de déclenchements par détecteur, confirmation d'intrusion, annulation, ouvertures à l'armement, Détecteur contourné (« Surveillé dès sa fermeture », recommandé, ou « Ignoré jusqu'au désarmement »), capteur perdu pendant l'armement et Perdu après (délai avant qu'un capteur indisponible soit considéré comme perdu, 3 min par défaut).
Codes et accès, notifications (personnes prévenues, Téléphones et tablettes : vibration continue par défaut, vibration et sonnerie d'alarme, ou notification simple ; pré-alarme, images des caméras), programmation (armer / désarmer / rappeler à heure fixe), présence (rappel ou armement quand tout le monde est parti, rappel au retour).
Personnes et codes : plusieurs codes par personne — habituel, sous contrainte (désarme en apparence et prévient discrètement), temporaire (dates et horaires, ex. ménage le mardi matin), à usage unique — avec leurs droits (armer, désarmer, modes, secteurs).

Vidéosurveillance

Caméras : mosaïque en direct (ou en images pour économiser le réseau), disposition 1 à 4 colonnes, filtre par pièce. Une caméra : direct en haute ou basse définition, son, plein écran, mouvements (caméras motorisées) et positions mémorisées, Marquer (garde l'enregistrement), mode privé, frise du jour pour revoir un moment.
Enregistrements : jusqu'à 4 caméras synchronisées, frise de toutes les caméras avec les détections en couleur, vitesse jusqu'à ×16, événement précédent / suivant, image à télécharger, export d'une période en MP4.
Événements : détections avec image (mouvement, personne, véhicule, animal, sonnette, capteur associé, alarme…), filtres, non vues, favoris (jamais effacés), séquence vidéo, note.
Ajouter une caméra (administrateurs) : choisir la marque (Tapo, VIGI, Reolink, Hikvision, Dahua…), ou Rechercher sur le réseau (indiquer le réseau des caméras s'il est sur un autre VLAN), saisir l'adresse et les identifiants, Tester la connexion (aperçu, définition, codec), puis choisir l'enregistrement (sur événements ou en continu) et les notifications. Ensuite, dans l'éditeur : zones de détection et masques dessinés sur l'image, sensibilité, détections de la caméra (ONVIF), capteurs associés, mode privé automatique (alarme désarmée, quelqu'un à la maison), visibilité pour les utilisateurs et les écrans muraux.
Stockage : place occupée par caméra, jours restants estimés, taille maximale et espace libre à garder ; autre disque ou NAS après sudo myhabitactl nvr-storage ….
Analyse IA : le serveur reconnaît lui-même les personnes, véhicules et animaux sur les images des caméras, sans cloud (modèle YOLOX-Tiny). Par caméra, onglet Détection : natures cherchées, score minimal, seulement pendant un mouvement (recommandé) ou en continu, objets immobiles ignorés (voiture garée, statue), et Tester sur l'image actuelle pour voir ce qui est reconnu et pourquoi un objet est écarté (zone, masque, score). Les événements « Personne », « Véhicule », « Animal » ont leur image avec le rectangle de l'objet ; ils déclenchent notifications, automatisations et entités (personne détectée…) comme les autres détections.
Sécurité → Analyse IA : aperçu du jour (personnes, animaux, véhicules, qui a été reconnu, objets surveillés, moteur d'analyse), puis :
- Personnes : la reconnaissance des visages est désactivée par défaut (Analyse IA → Réglages, puis caméra par caméra). Activée, les visages vus pendant les passages apparaissent dans « Visages à nommer » ; touchez un visage, « Qui est-ce ? », choisissez un nom ou créez-en un : les passages déjà enregistrés prennent le nom, et la personne est reconnue aux passages suivants (« Personne · Gaël » dans les événements, notification « Personne reconnue : Gaël »). Fiche d'une personne : ses photos (retirer une photo qui n'est pas elle, choisir la photo principale), ses passages, renommer, réunir deux fiches, supprimer.
- Confidentialité : tout est calculé et gardé sur le serveur ; aucune image ni empreinte de visage ne part sur Internet, ni dans les sauvegardes. « Effacer toutes les données des visages » supprime d'un coup personnes, visages et photos. Prévenez les personnes filmées, et n'activez pas la reconnaissance sur une caméra qui filme la rue.
- Animaux et véhicules : même principe à l'apparence (votre chat, votre voiture), approximatif : deux animaux ou deux voitures qui se ressemblent peuvent être confondus.
- Objets : ce que voit chaque caméra (80 sortes d'objets : vélo, chaise, télévision, sac…), relevé toutes les 15 minutes et après chaque mouvement, avec des statistiques sur 24 h ou 7 jours.
- Objets surveillés : choisissez un objet de l'inventaire ou dessinez une zone, donnez-lui un nom : s'il est déplacé ou disparaît, un événement et une notification le signalent (après plusieurs vérifications, jamais pendant qu'une personne le masque). Chaque objet a son entité « en place », utilisable par l'alarme et les automatisations. « C'est normal » lui apprend son nouvel aspect (nuit, objet remis un peu ailleurs).
- Réglages (« tarage ») : exigence de la reconnaissance des visages (strict ou souple), taille minimale d'un visage, exigence pour les animaux et véhicules, fréquence de l'inventaire, vérification des objets surveillés (fréquence, durée et nombre de vérifications avant de signaler), objets laissés (sac, valise… resté en place) par caméra, conservation des photos non nommées.
Automatisations : le déclencheur « Détection d'une caméra » peut viser une personne, un animal, un véhicule ou un objet surveillé précis (par exemple « quand Gaël arrive à l'entrée »).
Prérequis sur le serveur : sudo myhabitactl nvr-install --restart (ffmpeg, go2rtc et l'analyse IA ; --no-ai pour s'en passer).
Direct : un flux en MJPEG n'est jamais utilisé pour le direct (illisible par les navigateurs) — c'est alors le flux principal qui est montré ; l'assistant ONVIF ne choisit plus un profil JPEG quand la caméra propose du H.264 ou du H.265. Les Tapo ajoutées avant le 24/10/2026 avec le flux secondaire « stream8 » (MJPEG) sont corrigées automatiquement en « stream2 » (H.264).
Erreurs de connexion expliquées : caméra qui refuse la connexion (une Tapo n'accepte que 2 ou 3 lecteurs à la fois : fermez le direct dans l'application Tapo, Home Assistant, VLC…), qui ne répond pas, identifiants refusés (pour une Tapo, le compte caméra créé dans l'application, pas le compte TP-Link), format non pris en charge.
Si WebRTC échoue (réseau filtré, VPN), le navigateur s'en souvient 30 minutes et ouvre directement le direct par le serveur, sans attendre.

Cartes de tableau de bord : Alarme (complète, boutons ou état seul, par secteur), Caméra (direct ou image, mouvements), Mosaïque de caméras, Événements de sécurité, Détecteurs de l'alarme, Résumé sécurité.

Multimédia

Menu Multimédia : musique, films et séries, radios et podcasts, Spotify, téléviseurs et enceintes de la maison. Le bouton « Lire sur… » choisit où jouer (ce navigateur, une ou plusieurs enceintes, une zone, un téléviseur) ; le mini-lecteur en bas de chaque page montre ce qui joue et ouvre le panneau « En cours » (avance, volume de chaque enceinte, file d'attente, transfert). Mise en route (enceintes, dossiers de la bibliothèque, Spotify, fiches des films) et limites : multimedia.md.

Tableaux de bord

Créer : « Nouveau tableau de bord », avec ou sans pré-remplissage depuis vos pièces et appareils.
Épingler (icône punaise) : le tableau apparaît dans la barre latérale, sous « Tableaux de bord » ; glissez-le pour changer l'ordre. Menu « … » : afficher à l'accueil (pour vous), et pour les administrateurs, accueil par défaut et épinglé par défaut pour tous les comptes qui n'ont pas fait leur propre choix. La page d'accueil standard reste accessible depuis la liste des tableaux.
Vue de l'éditeur : molette = zoom centré sur le pointeur ; clic droit, clic de la molette ou Espace + glisser = déplacer la vue (jamais les cartes) ; Maj + molette = défilement horizontal ; boutons − / + / « Ajuster » en bas à droite (Maj + 1 : ajuster, Maj + 0 : 100 %). Un format à hauteur fixe (écran mural) est ajusté pour être vu en entier.
Barre d'outils : toujours sur une seule ligne ; quand la place manque, les libellés laissent la place aux icônes (info-bulles), « Enregistrer » et « Fermer » restent visibles.
Modifier :
- formats : chaque format (Téléphone, Tablette, Ordinateur, ou écran mural ajouté avec « + » ou « Nouveau format ») a sa disposition :
  - Libre (px) : glissez les cartes au clic gauche, redimensionnez-les par les poignées, ou saisissez X, Y, largeur et hauteur au pixel près. Guides d'alignement automatiques (Alt pendant le geste : placement libre) ou grille magnétique (bouton en bas à droite) ;
  - Automatique : colonnes, toujours lisibles, ordre et hauteur réglables ;
- sélection : clic gauche sur une carte ; Maj ou Ctrl + clic pour en ajouter ; clic gauche sur le fond + glisser = lasso ; Ctrl+A = tout ; Échap = rien ;
- plusieurs cartes : aligner, répartir, même largeur, hauteur ou taille (menu « Aligner » et panneau de droite), Ranger automatiquement (intelligent, grille, ligne ou colonne ; colonnes, espacement, tailles harmonisées ou conservées, ordre, zone ; aperçu en pointillés au survol), Grouper ;
- édition : dupliquer (Ctrl+D), supprimer (Suppr), déplacer au clavier (flèches, Maj pour un pas de grille), annuler et rétablir (Ctrl+Z, Ctrl+Y ; un réglage au curseur compte pour une seule étape) ;
- réglages d'une carte (panneau de droite) : l'essentiel d'abord (titre, icône, contenu, position), puis Paramètres avancés : options détaillées propres à chaque carte (ex. lumière : affichage standard ou tuile, roue chromatique, couleurs prédéfinies ou température de couleur seules, luminosité en curseur ou boutons, couleur de l'icône, transition ; mesure : hauteur, couleur, épaisseur, type et minimum/maximum de la courbe, taille de la valeur ; graphique : légende, axes, remplissage, bornes ; scènes, boutons, horloge, pièce, thermostat…), apparence du cadre (fond, couleurs, arrondi, marge, bordure libre, ombre ou halo, flou, taille du texte, opacité ; pour tous les formats ou un seul) et conditions d'affichage (état, disponibilité, rôle, mode de la maison, alarme) ;
- éditeur avancé (double-clic sur une carte, Entrée, ou « Éditeur avancé ») : la carte en grand, élément par élément (titre, icône, interrupteur, luminosité, roue chromatique, pastilles, jauge, consigne, courbe…) : déplacer, redimensionner (Maj : proportions), ajouter, dupliquer, supprimer, masquer, verrouiller, ordre des calques ; texte (taille, graisse, police, alignement), fond et bordure, ombre, flou, rotation, animations (pulsation, clignotement, lueur, rotation, rebond) ; conditions par élément (couleur, fond, texte, icône, animation ou masquage selon un état) ; éléments libres liés à n'importe quelle entité (texte avec {v} et {nom}, valeur, icône, interrupteur, bouton, curseur, jauge, forme). Alignement automatique par défaut, grille facultative. Positions en % de la carte : le dessin suit les formats. « Affichage par défaut » retire le dessin à tout moment. La carte composée s'édite de la même façon ;
- Enregistrer (Ctrl+S), Révisions pour restaurer une version précédente.
Une carte mal configurée est signalée sans bloquer le reste du tableau.
Thèmes : Réglages → Thèmes (dupliquer un thème intégré pour le personnaliser), puis choisir par tableau de bord ou par appareil (Mon compte).

Plans de la maison

Menu Plans (application Android : Plus → Plans, affichage natif). Un plan représente l'appartement, la maison ou le jardin, vu de dessus et en 3D, avec vos appareils en direct.

Épingler : « Plus d'actions » (⋯) d'un plan, ou l'épingle de sa barre → le plan apparaît sous « Plans » dans le menu (préférence personnelle, retrouvée aussi dans l'application Android : Plus → Plans épinglés).

Créer : « Nouveau plan », nom, type (appartement, maison, jardin…), point de départ : plan vide, appartement de trois pièces ou maison avec jardin (deux niveaux), à ajuster à vos mesures. Les pièces des modèles sont reliées aux pièces My Habita de même nom.

Afficher :

2D (de dessus) ou 3D ; plusieurs niveaux (étages, sous-sol, jardin) dans des onglets ;
glisser : déplacer la vue ; molette ou pincement : zoom ; l'échelle graphique en bas à droite ramène la vue entière ;
clic sur un appareil : il bascule (lumière, prise, ventilation) ou ouvre ses détails (capteur, volet, thermostat, aspirateur…) selon son réglage ; clic droit ou appui long : toujours les détails ;
clic sur une pièce : ses mesures (température, humidité), ses lumières (tout allumer, tout éteindre), ses appareils, et « Nettoyer avec … » si un aspirateur connaît la pièce ;
Affichage : appareils, valeurs, noms, halo des lumières allumées sur la vue 2D et éclairage des lumières allumées en 3D (réglables séparément, et lumière par lumière dans l'éditeur), températures des pièces (couleurs du froid au chaud), mouvement et alertes (la pièce pulse), mobilier, noms des pièces, cotes, image de fond, carte des aspirateurs ;
les portes et fenêtres reliées à un détecteur s'affichent ouvertes ou fermées en direct (en 2D et en 3D), les volets avec leur position ;
plein écran (bouton à côté de « Affichage », Échap pour sortir).

3D :

Orbite : glisser pour tourner autour de la maison, clic droit pour déplacer, molette pour zoomer ; bouton « Vue de dessus » ;
Visite (icône des pas) : à hauteur d'yeux, ZQSD, WASD ou flèches pour marcher et tourner, glisser pour regarder, molette pour avancer ; les murs ne se traversent pas, les portes si ; flèches à l'écran sur tablette et téléphone ;
Murs coupés : murs à mi-hauteur pour voir l'intérieur ;
lumières allumées qui éclairent la pièce, portes qui s'ouvrent, mobilier en volume, appareils cliquables, robot aspirateur et son trajet, maillage en 3D.

Maillage radio (bouton « Maillage ») : les liaisons Zigbee et Thread réellement mesurées entre les appareils placés, colorées selon leur qualité (vert ≥ 150, orange, rouge < 80) avec leur valeur, l'écoulement vers le routeur parent, les ondes des routeurs et la couverture estimée (carte de chaleur). La couverture est calculée à partir des qualités mesurées, des distances et des murs traversés (affaiblissement selon le type de mur, moindre par une porte) ; le modèle s'ajuste sur vos propres liaisons (légende). Placez le coordinateur Zigbee et le routeur de bordure Thread (onglet Appareils de l'éditeur, rubrique Réseau) pour voir tout le réseau. Administrateurs : « Analyser le réseau » relance l'analyse Zigbee (quelques minutes).

Modifier (bouton « Modifier », plein écran, même présentation que l'éditeur avancé des cartes) :

outils (barre du haut, raccourcis) : Sélection (V), Murs (W), Pièces (R), Ouvertures (D), Mobilier (F), Appareils (A), Texte (T), Cotes (K), Mesurer (M) ; vue : clic droit, clic de la molette ou Espace + glisser, molette pour zoomer, Maj + 1 pour ajuster ;
murs : un clic par angle, double-clic ou Entrée pour finir, clic sur le point de départ pour fermer ; tapez une longueur (« 3,45 », « 345 », « 85 cm ») puis Entrée pour une cote exacte ; aimantation sur les extrémités, les murs (jonction en T), les alignements, les angles droits et à 45° (Maj : 15°), grille facultative ; Alt pendant un geste : sans aimantation. Types : extérieur, porteur, intérieur, cloison, paroi vitrée, muret, garde-corps, clôture, haie (épaisseur, hauteur, couleur) ;
pièces et surfaces : un clic dans un espace fermé par des murs crée la pièce, ou rectangle (avec ses murs) ou polygone ; natures : pièce, dégagement, balcon, terrasse, pelouse, massif, potager, allée, gravier, accès voiture, stationnement, bassin, piscine ; revêtement (parquet, carrelage, pierre, moquette…), surface en m² ; relier à une pièce My Habita (ou la créer) ;
ouvertures : portes (simple, d'entrée, double, coulissante, à galandage, de garage), passage, fenêtres, porte-fenêtre, baie vitrée, fenêtre de toit, portail, portillon ; largeur, hauteur, allège, côté et charnière (F, H) ; détecteur d'ouverture, volet et serrure liés ;
mobilier et jardin : une cinquantaine d'objets (salon, repas, chambre, cuisine, salle de bain, bureau, équipements dont radiateurs, chaudière, escalier, et jardin : arbres, arbustes, salon de jardin, parasol, voiture…), redimensionnables (poignées), tournables (poignée du haut, R), couleur, hauteur de pose, entité liée (une lampe s'éclaire quand elle est allumée) ;
- Retourner (X) : symétrie gauche-droite, pour tous les objets (canapé d'angle dans l'autre sens…) ;
- Figer le dessin : par défaut, le dessin se recompose à la nouvelle taille (coussins, chaises) ; figé, redimensionner étire tout le dessin d'un bloc (utile si un objet réduit se dessine mal) ;
appareils : onglet « Appareils », par pièce ; cliquez un appareil puis son emplacement, ou glissez-le sur le plan ; « Placer N appareils dans leur pièce » d'un coup ; réglages : fonction affichée, icône, icône et/ou valeur, nom, taille, hauteur de pose, action au clic ; pour une lumière : halo sur la vue 2D (et sa taille), éclairage en 3D (et sa portée). Un appareil posé dans une autre pièce que la sienne est signalé (« Ranger d'après le plan », administrateurs) ;
calques : visibilité et verrouillage par nature d'élément, liste des éléments ; ordre des calques (glisser, ou flèches au survol) : un calque plus haut se dessine par-dessus et reçoit le clic en priorité (ex. aspirateurs sous les surfaces : un clic sur une pièce sélectionne la pièce) ; l'ordre vaut pour l'affichage, l'éditeur, les tableaux de bord et l'application ;
niveaux : ajouter un étage ou un sous-sol, altitude, hauteur sous plafond ; le niveau du dessous s'affiche en filigrane ;
image de fond : un plan scanné ou d'architecte à décalquer ; « Mettre à l'échelle » : deux clics sur une distance connue, puis sa longueur réelle ;
aperçu 3D dans l'éditeur ; annuler et rétablir (Ctrl+Z, Ctrl+Y), dupliquer (Ctrl+D), supprimer (Suppr), flèches pour déplacer ; Enregistrer (Ctrl+S) avec détection des modifications concurrentes et révisions conservées.

Aspirateurs sur le plan : dans l'éditeur, sans sélection, « Aspirateurs » → ajouter la carte d'un robot. Calez-la en la faisant glisser, tourner (poignée du haut), grandir (coin) et étirer en largeur ou en hauteur (poignées des côtés, ou champs « Étirement »), ou par repères : un point reconnaissable de la carte du robot (angle de pièce, porte), puis le même point sur le plan, deux fois ou plus, puis « Appliquer » (avec trois repères ou plus, l'étirement est calculé aussi). « Associer automatiquement » relie chaque pièce du robot à la surface du plan.

Les dimensions mesurées par le robot (LiDAR) diffèrent souvent un peu du plan (épaisseur des murs, meubles) : chaque pièce de la carte s'ajuste à part :

« Caler chaque pièce sur sa surface » : chaque pièce du robot reliée à une surface est étirée sur cette surface, en une fois ;
double-clic sur une pièce de la carte (ou « Ajuster » dans la liste des pièces) : la pièce seule se déplace, s'étire (8 poignées) et se cale par repères d'accroche propres à la pièce (un point de la carte, puis sa place sur le plan ; un repère : déplacement, deux : rotation et échelle, trois ou plus : étirement complet) ; Échap revient à la carte, Suppr remet la pièce à zéro ;
les murs relevés par le robot suivent leur pièce, et la position du robot, son trajet et sa base sont recalés pièce par pièce.

Ensuite, sur le plan, le robot se déplace en direct, son trajet s'affiche, et un clic sur une pièce propose de la nettoyer. Le calage reste valable quand le robot agrandit sa carte (repère propre au robot).

Tableaux de bord : carte « Plan » (2D ou 3D, niveau, éléments affichés, déplacement et zoom autorisés ou non) : le plan en direct, commandable d'un clic.

Application Android (Plus → Plans) : affichage natif des plans, sans page web :

liste avec aperçu dessiné de chaque plan, épinglés en tête (épingle de la carte ou de la barre du plan) ;
vue de dessus identique au site (mêmes calques dans le même ordre, mobilier, portes et volets en direct, halos, teintes des pièces, cotes, image de fond, carte de l'aspirateur calée pièce par pièce et robot en direct, maillage radio avec ondes et couverture) : un doigt pour déplacer, pincer pour zoomer, double toucher pour zoomer ;
toucher un appareil : il bascule ou ouvre ses détails selon son réglage ; appui long : ses détails ; toucher une pièce : panneau de la pièce (mesures, tout allumer ou éteindre, nettoyage, appareils) ;
3D (OpenGL) : orbite (un doigt : tourner ; deux doigts : déplacer et zoomer), visite à hauteur d'yeux (glisser pour regarder, croix pour marcher, pincer pour avancer, murs infranchissables), murs coupés, vue de dessus ; lumières allumées qui éclairent, portes qui suivent leur détecteur, appareils touchables ;
niveaux, Affichage (mêmes choix que le site, mémorisés par plan sur le téléphone), Maillage (légende, analyse du réseau pour les administrateurs), plein écran. La création et la modification des plans se font sur le site (bouton crayon de la liste).

Écran mural (tablette)

Administrateur : Réglages → Comptes et écrans → Nouvel écran mural (choisir les tableaux autorisés) → un code d'appairage s'affiche.
Sur la tablette : ouvrir My Habita → « Associer cet écran comme écran mural » → saisir le code.
L'écran affiche les tableaux autorisés en plein écran, avec l'horloge et l'état de la connexion. Il passe en veille la nuit (de 23 h à 6 h) et se réveille au toucher. Le désarmement de l'alarme exige un code personnel.

Données

Graphiques sur plusieurs entités (de 1 h à 1 an), export CSV (séparateur ;, compatible avec les tableurs français), consommation par jour pour les compteurs d'énergie, et réglage de la conservation (valeurs brutes, moyennes 5 minutes, moyennes horaires).

Notifications

La cloche en haut à droite regroupe les notifications. Pour les recevoir sur votre téléphone : Réglages → Notifications → ntfy (application gratuite) ou webhook.

Application Android

Installez l'application depuis Réglages → Téléphones (bouton ou code QR), puis saisissez l'adresse du serveur et votre compte. Elle reprend l'apparence de l'interface avec une disposition pour le téléphone, affiche vos tableaux de bord tels que vous les avez composés, et fait du téléphone un appareil de la maison : capteurs (batterie, Wi-Fi, position et présence à la maison, écran, sonnerie…), notifications, « Faire sonner ». Chaque utilisateur gère ses téléphones dans Réglages → Téléphones ; l'action « Envoyer une notification » des automatisations peut viser des téléphones précis. Détails : application-mobile.md.