Captures d’écran Extraites du README de notDIRK/shelly-cloud-diy-ha.
À propos
Shelly Cloud DIY connecte Home Assistant aux appareils Shelly via l’API Shelly Cloud Control. Il atteint des appareils qu’une configuration uniquement locale ne voit pas, comme les appareils partagés, les appareils situés sur des sites distants et les appareils Bluetooth derrière une passerelle. Les appareils apparaissent sous forme de capteurs binaires, de boutons, de climatisation, de volets, de lumières, de nombres, de sélecteurs, de capteurs, d’interrupteurs et de textes, et seuls les appareils cochés dans la sélection obtiennent des entités. La commande reste prioritairement locale pour les appareils du réseau local, le cloud servant de couche complémentaire pour la visibilité. Les options couvrent l’intervalle d’interrogation, le délai au bout duquel un appareil est considéré comme hors ligne, et les avertissements en cas de mauvais état d’un appareil ou de relais qui ne s’ouvre plus. Des actions supplémentaires importent les données d’énergie historiques, remplacent un appareil défaillant par un nouveau et trouvent les appareils qui ne sont plus dans le compte. La configuration se fait dans l’interface avec une clé cloud de l’app Shelly, et l’intégration a besoin du cloud du fabricant.
Résumé automatique du README et du code de notDIRK/shelly-cloud-diy-ha, traduit automatiquement. Une erreur, ou tu maintiens ce projet et tu veux ton propre texte ici ? Prendre contact
Prise en charge
Utilise le cloud du fournisseur Nécessite une connexion internet et un compte chez le fournisseur.
Depuis la Marketplace S’installe depuis la Marketplace, anciennement HACS.
Maintenance active Son auteur a publié une version ou poussé une modification au cours des six derniers mois.
Fournit
- Lumières
- Climatisation
- Volets
- Interrupteurs
- Capteurs
Mise en place
Installe-la depuis la Marketplace et redémarre Home Assistant, puis ajoute-la dans Paramètres > Appareils et services.
Shelly Cloud DIY
- Clé cloud d’autorisationLa longue chaîne que l’app Shelly Smart Control affiche sous Accès et autorisations.
- URI du serveurLe nom d’hôte affiché sous la clé, par exemple shelly-42-eu.shelly.cloud.
- Intervalle d’interrogation (secondes)Fréquence à laquelle Home Assistant interroge Shelly Cloud pour connaître l’état. Par défaut 5 s ; plage de 3 à 60 s. Shelly impose une limite de 1 requête par seconde.
- URL de la passerelle locale (facultatif, pour les données historiques EM)Nécessaire uniquement si tu utilises une passerelle Shelly locale pour reconstituer les données d’énergie historiques.
Choisis les appareils à exposer
- Action groupée« Tout cocher » ou « Tout décocher » remplace la liste manuelle ci-dessous à l’enregistrement. Choisis « Sélection manuelle » pour garder la liste telle quelle.
- Appareils (cocher/décocher individuellement)Seuls les appareils cochés produisent des entités Home Assistant.
Également demandé à « Sélection mise à jour, pas encore enregistrée ».
Réauthentifier Shelly Cloud DIY
- Clé cloud d’autorisationLa longue chaîne que l’app Shelly Smart Control affiche sous Accès et autorisations.
- URI du serveurNe modifie cette valeur que si Shelly a déplacé ton compte ; la valeur enregistrée est préremplie.
Se connecter de nouveau à Shelly pour le contrôle par le cloud
- E-mail du compte ShellyL’adresse e-mail que tu utilises dans l’app Shelly.
- Mot de passe du compte ShellyUtilisé une seule fois pour te connecter, puis supprimé. Seul le jeton obtenu est conservé.
Après la mise en place
- Intervalle d’interrogation (secondes)3 à 60 s. Une valeur basse rend l'intégration plus réactive mais consomme plus du quota de 1 req/s de Shelly.
- Signaler un appareil comme hors ligne après (minutes)2 à 1440 min, 30 par défaut. Le capteur « Reporting » de chaque appareil passe à off dès que l’appareil est resté silencieux aussi longtemps. Ce n’est qu’une valeur de base : un appareil naturellement plus silencieux obtient de lui-même une fenêtre plus large, et les appareils à batterie ou BLE sont traités séparément. La réduire accélère donc surtout la détection sur les appareils qui communiquent en continu, comme les prises avec mesure de consommation.
- Avertir d’un relais qui ne s’ouvre plusActivé par défaut. Surveille chaque canal de commutation qui mesure sa propre sortie et avertit quand le relais se déclare ouvert alors qu’une vraie charge le traverse encore, c’est-à-dire un contact soudé. Désactive cette option si un de tes Shelly se trouve dans un circuit va-et-vient, où l’autre interrupteur peut faire passer du courant dans le compteur alors que le relais est réellement ouvert.
- URL de la passerelle locale (facultatif, pour les données historiques EM)Nécessaire uniquement si tu utilises une passerelle Shelly locale pour reconstituer les données d’énergie historiques.
- Avertir en cas d’appareils en mauvais étatActivé par défaut. Interprète les données que chaque interrogation renvoie déjà : signal Wi-Fi (avertissement à -70 dBm, erreur à -85 dBm), température du composant (70 °C / 85 °C), mémoire libre et stockage libre (moins de 20 % / 10 %), un redémarrage que l’appareil attend encore, et tout composant signalant sa propre erreur. Cela ne coûte aucune requête supplémentaire. Les appareils Bluetooth (BLU) ne sont jugés que sur le signal que leur passerelle rapporte pour eux, et les appareils Gen1 ne sont pas jugés du tout. Seule la température propre d’un composant compte, jamais celle d’une sonde externe d’application.
- Compter une mise à jour du firmware en attente comme un constatDésactivé par défaut. Ajoute « une mise à jour du firmware est disponible » comme constat. Sur un compte typique, la plupart des appareils en ont une en attente, donc l’activer tend à garder la carte allumée en permanence, ce qui t’empêche justement de remarquer les constats importants.
- Contrôler les composants virtuels par le cloud (non pris en charge)Désactivé par défaut, et à lire avant de l’activer. Les composants virtuels (les zones d’un contrôleur d’irrigation, l’interrupteur d’un script) peuvent être lus via l’API Shelly Cloud documentée mais pas modifiés : chaque route documentée répond « no such route ». Les commander n’est possible que par un canal non documenté, que l’assistance Shelly a déclaré non pris en charge le 2026-07-27 et qui peut changer ou disparaître sans préavis. Ce que cela coûte : la connexion à ton compte Shelly (demandée à l’étape suivante ; le mot de passe est utilisé une seule fois et jamais conservé) et une seconde connexion à Shelly Cloud. Ce que cela t’apporte : un interrupteur pour chaque booléen virtuel, mais seulement sur les appareils que ton compte possède. Un appareil partagé est refusé par Shelly lui-même, et aucun interrupteur n’apparaît pour lui. L’interrupteur est créé en plus du capteur en lecture seule existant du même composant, jamais à sa place, donc rien de ce que tu as déjà construit sur ce capteur ne casse. Désactiver de nouveau cette option supprime la connexion enregistrée.
- Action groupée« Tout cocher » ou « Tout décocher » remplace la liste manuelle ci-dessous à l'enregistrement.
- Appareils (cocher/décocher un par un)Seuls les appareils cochés produisent des entités Home Assistant.
- Action groupée« Tout cocher » ou « Tout décocher » remplace la liste manuelle ci-dessous à l'enregistrement.
- Appareils (cocher/décocher un par un)Seuls les appareils cochés produisent des entités Home Assistant.
- E-mail du compte ShellyL'adresse e-mail que tu utilises dans l'app Shelly.
- Mot de passe du compte ShellyUtilisé une seule fois pour te connecter, puis supprimé. Seul le jeton obtenu est conservé.
Textes issus du code de notDIRK/shelly-cloud-diy-ha. Les textes que le dépôt ne fournit pas en français ont été traduits automatiquement.
Actions
- Télécharger et convertir les données d'énergie historiquesRécupère les exports CSV de la passerelle Shelly locale et les importe dans les statistiques à long terme de Home Assistant.Champs : URL de la passerelle, ID de l'appareil
- Remplacer l'appareilTransfère l'identité Home Assistant d'un Shelly défaillant (ID d'entités, appareil HA, nom, zone, historique et chaque référence dans les automatisations et tableaux de bord) vers un nouveau Shelly du même modèle, pour que tu n'aies pas à reconfigurer Home Assistant après un remplacement de matériel. Active d'abord le nouvel appareil.Champs : Ancien appareil (remplacé), Nouvel appareil, Simulation, Forcer (ignorer l'écart de modèle)
- Carte du parcSuperposition en lecture seule : associe chaque appareil cloud à son jumeau local (Shelly natif) par adresse MAC, suggère des noms et signale tout appareil dont le contrôle passe par le cloud. Écrit un rapport dans tes notifications. Peut être lancée à tout moment : elle ne modifie rien sauf si tu l'actives explicitement.Champs : Simulation, Appliquer les suggestions de noms natifs
- Trouver les appareils Shelly qui ne sont plus dans ton compteCompare les appareils Shelly créés par cette intégration à l'inventaire en direct de ton compte Shelly et signale ceux dont le matériel n'est plus dans le compte (vendu, réinitialisé ou supprimé dans l'app Shelly). Par défaut, elle informe seulement : elle écrit un rapport dans tes notifications et ne modifie rien. La suppression est strictement facultative : désactive la simulation et active la suppression pour détacher les appareils listés ; un aperçu est affiché d'abord et l'opération n'est pas réversible automatiquement.Champs : Simulation, Supprimer les appareils listés, Limiter à ces appareils
Dépannage
- DiagnosticsTélécharge un fichier de diagnostics à joindre à un rapport de bug.
- Avis de correctionLes avis qu’elle peut afficher dans Paramètres > Corrections :Shelly Cloud limite le débit de cette intégration, Des appareils sélectionnés sont absents de ton compte Shelly, Les données d'énergie historiques n'ont pas pu être importées, Un relais Shelly ne s'éteint plus, Certains appareils Shelly signalent des problèmes
Extrait du README
🇩🇪 Deutsch · 🇬🇧 English (you are here) — README.de.md is the German mirror of this page.
Shelly Cloud DIY connects Home Assistant to your Shelly fleet through the self-service Cloud Control API — reaching the devices a local-only integration can never see (shared devices, remote sites, the Shelly BLU family behind a gateway), while keeping your switching local-first: the cloud is an overlay, never in the control path.
- cloud.connected still read connected thirteen minutes after a device was physically unplugged, and read connected for every device on the account — including ones silent for hours. It is a transport…
- Devices do eventually vanish from the cloud's fleet listing, but that took up to ten minutes, and the listing also omits healthy devices at random.
S’affiche dans Vulpo :
carte Lumière, carte Bascule rapide, carte Volet, carte Climat, Apple Watch, centre de contrôle, Activité en direct de climatisation.Informations
- Installations
- 242 partagent leurs statistiques
- Étoiles GitHub
- 17
- Connexion
- Utilise le cloud du fournisseur
- Maintenance
- Mise à jour au cours des 6 derniers mois
- Version
- v0.16.4,
- Catégorie
- Prises et interrupteurs
- Type
- Intégration de la Marketplace
- Marque
- Shelly
- Prérequis
- Nécessite la Marketplace (HACS sur Home Assistant 2026.10 et les versions antérieures)
- Domaine
shelly_cloud_diy- Problèmes
- Signaler un problème












