Intégration domotique Wi-Fi QR Code, gratuite et open source

Le QR code de votre Wi-Fi invités sur le tableau de bord : vos invités le scannent et se connectent.
Affichez le QR code de votre Wi-Fi invités sur un tableau de bord de Gladys : un invité pointe l'appareil photo de son téléphone dessus et rejoint le réseau, sans taper de mot de passe. Jusqu'à trois réseaux, un widget, et une action de scène pour changer le mot de passe affiché.
Tout se passe dans votre Gladys : ni compte, ni accès à Internet, aucune donnée envoyée.
Les QR codes sont vérifiés en les relisant avec un décodeur de QR code, dans les tests automatiques. Ils n'ont pas encore été scannés avec tous les téléphones : vos retours sont les bienvenus sur le forum ou dans une issue GitHub.
Prérequis
- Gladys Assistant 5.2.0 ou plus récent (images des widgets).
- Le nom (SSID), la sécurité et le mot de passe du réseau à partager.
Configuration
Sur la page de l'intégration, renseignez jusqu'à trois réseaux. Laissez vide le nom d'un réseau pour ne pas l'utiliser.
Nom du réseau, sécurité, mot de passe
- Nom du réseau (SSID) : exactement comme les téléphones l'affichent. Majuscules, espaces et accents comptent. 32 octets au plus.
- Sécurité : WPA / WPA2 convient à presque tous les routeurs, mode mixte WPA2/WPA3 compris. Ne choisissez WPA3 seul que si le routeur n'accepte rien d'autre : certains téléphones anciens ne le lisent pas. Aucune est pour un réseau ouvert.
- Mot de passe : de 8 à 63 caractères en WPA. Gladys le stocke comme un secret, et il n'est jamais écrit dans les journaux.
- Réseau masqué : cochez si le routeur ne diffuse pas le nom.
Les caractères spéciaux \ ; , : " sont échappés dans le QR code comme le
format l'exige : un mot de passe comme p@ss;word:2026 fonctionne.
État de l'intégration
La page de l'intégration affiche une erreur quand aucun réseau n'est configuré, ou quand un réseau ne peut pas donner un QR code qui fonctionne (mot de passe trop court, nom trop long), et nomme le réseau à corriger.
Widget du tableau de bord
Ajoutez le widget QR code Wi-Fi à un tableau de bord et choisissez son réseau. Il affiche :
- le nom du réseau (réglage Afficher le nom du réseau) ;
- le QR code ;
- le mot de passe en clair, ou « Réseau ouvert » (réglage Afficher le mot de passe).
Désactivez le mot de passe pour n'afficher que le QR code. Le QR code contient toujours le mot de passe : c'est ainsi que le téléphone rejoint le réseau.
Action de scène « Changer le mot de passe Wi-Fi affiché »
Met à jour le mot de passe d'un réseau, enregistré dans la configuration : le QR code et le widget suivent en quelques secondes (quelques minutes au plus). Le mot de passe peut venir d'une variable de scène, par exemple quand une autre intégration change le mot de passe invités.
Cette action ne change pas le mot de passe du routeur : elle ne change que ce que Gladys affiche. Un mot de passe que le réseau refuserait (trop court en WPA, réseau ouvert, réseau non configuré) fait échouer l'action, et l'ancien mot de passe reste.
Exemples de scènes
- Chaque lundi, une scène change le mot de passe invités sur le routeur (avec l'intégration du routeur), puis appelle « Changer le mot de passe Wi-Fi affiché » avec la même valeur.
- Une tablette dans l'entrée affiche un tableau de bord avec le widget seul, mot de passe masqué.
Dépannage
- Le widget dit que le réseau n'est pas configuré : renseignez son nom sur la page de l'intégration, puis enregistrez.
- Le téléphone ne propose pas de se connecter : vérifiez que le nom et le mot de passe sont exactement ceux du routeur (majuscules comprises). En WPA3 seul, essayez WPA / WPA2 : les téléphones négocient alors eux-mêmes le WPA3 quand le routeur le propose.
- Pas de QR code, un message à la place : le message donne la raison (mot de passe trop court, nom trop long).
Limites
- Le tableau de bord montre le mot de passe à quiconque peut le voir, tableaux de bord publics compris : utilisez un réseau invités.
- Trois réseaux au plus.
- L'intégration ne lit ni ne modifie le routeur : le mot de passe est celui saisi ici ou envoyé par une scène.
- Pas encore scanné avec tous les modèles de téléphone (voir la note plus haut).
Crédits
- QR codes générés par node-qrcode (MIT).
- Format de QR code Wi-Fi du projet ZXing (Apache 2.0).
- Sans lien avec la Wi-Fi Alliance.
Paramètres de configuration
Voici les paramètres demandés par Wi-Fi QR Code dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Fonctionnement | section | Non | Renseignez jusqu'à trois réseaux Wi-Fi, par exemple celui des invités. Ajoutez ensuite le widget « QR code Wi-Fi » à un tableau de bord : un invité scanne le code avec l'appareil photo de son téléphone et rejoint le réseau. Tout reste sur votre Gladys : ni compte, ni accès à Internet. |
| Réseau 1 | section | Non | Laissez le nom vide pour ne pas utiliser ce réseau. |
| Nom du réseau (SSID) | string | Non | Exactement comme les téléphones l'affichent : majuscules, espaces et accents comptent. |
| Sécurité | select | Oui | |
| Mot de passe | secret | Non | Affiché sur le widget et dans le QR code, jamais dans les journaux. |
| Réseau masqué | boolean | Non | Cochez si le routeur ne diffuse pas le nom. |
| Réseau 2 | section | Non | Laissez le nom vide pour ne pas utiliser ce réseau. |
| Nom du réseau (SSID) | string | Non | Exactement comme les téléphones l'affichent : majuscules, espaces et accents comptent. |
| Sécurité | select | Oui | |
| Mot de passe | secret | Non | Affiché sur le widget et dans le QR code, jamais dans les journaux. |
| Réseau masqué | boolean | Non | Cochez si le routeur ne diffuse pas le nom. |
| Réseau 3 | section | Non | Laissez le nom vide pour ne pas utiliser ce réseau. |
| Nom du réseau (SSID) | string | Non | Exactement comme les téléphones l'affichent : majuscules, espaces et accents comptent. |
| Sécurité | select | Oui | |
| Mot de passe | secret | Non | Affiché sur le widget et dans le QR code, jamais dans les journaux. |
| Réseau masqué | boolean | Non | Cochez si le routeur ne diffuse pas le nom. |
Comment installer Wi-Fi QR Code dans Gladys
- Dans Gladys, ouvrez Intégrations : Wi-Fi QR Code apparaît dans le catalogue, aux côtés des intégrations natives, avec un badge communautaire.
- Cliquez sur Installer. Gladys télécharge l'image Docker (
ghcr.io/guim31/gladys-wifi-qr:1.0.0), la démarre dans un bac à sable isolé du cœur, et génère l'interface de l'intégration (appareils, découverte et configuration). - Ouvrez l'écran Configuration de l'intégration, remplissez les paramètres, puis enregistrez.
- Vous pouvez aussi l'installer directement depuis l'URL de son dépôt : https://github.com/guim31/gladys-wifi-qr.
Wi-Fi QR Code nécessite Gladys >=5.2.0. Le catalogue dans Gladys se rafraîchit toutes les heures : une nouvelle version est donc disponible au plus tard une heure après sa sortie.
Vous n'utilisez pas encore Gladys ? C'est gratuit et open source : suivez le guide d'installation pour démarrer.
À propos des intégrations externes
Wi-Fi QR Code est une intégration externe : une intégration communautaire empaquetée dans un conteneur Docker et publiée sur GitHub, que Gladys installe en un clic et exécute dans un bac à sable isolé de son cœur. Elle est publiée et maintenue par guim31, et non par l'équipe cœur de Gladys.
- Parcourir toutes les intégrations, natives et communautaires
- Créer et publier votre propre intégration externe
- Code source sur GitHub — source de cette documentation