Intégration Apple Device Tracker pour Gladys Assistant
Suivez vos appareils Apple via Localiser et utilisez-les comme capteurs de présence.
Publiée par prohand
- Appareils
- Version 1.0.4
- Nécessite Gladys >=4.86.0
- ★ 0
Cette intégration se connecte à votre compte iCloud, lit la position des appareils visibles dans Localiser (Find My) et les expose dans Gladys comme des capteurs de présence. Vous pouvez ensuite déclencher vos scènes sur « mon iPhone arrive à la maison » ou « plus personne n'est là ».
Ce que vous obtenez
Un appareil Gladys par appareil visible dans Localiser sur iCloud.com (iPhone, iPad, Mac, Apple Watch, et les AirPods qu'Apple y liste), avec ces mesures :
| Mesure | Type | À quoi ça sert |
|---|---|---|
| Présence | Binaire | Le déclencheur de vos scènes (1 = à la maison) |
| Distance du domicile | Décimal (km) | Suivre l'éloignement, déclencher un pré-chauffage |
| Précision | Entier (m) | Savoir si la position vient du GPS ou du Wi-Fi |
| Position | Texte | « latitude,longitude », pratique en debug |
| Âge de la position | Entier (min) | Détecter un appareil éteint qui ne remonte plus |
| Batterie | Entier (%) | Alerter sur une batterie faible |
| En charge | Binaire | Savoir si l'appareil est branché |
| Faire sonner | Bouton | Joue le son de Localiser sur cet appareil |
Batterie et charge n'apparaissent que sur les appareils qui les remontent : un accessoire n'en a pas.
Faire sonner un appareil depuis le tableau de bord
Toutes les mesures ci-dessus sont en lecture seule, mais Faire sonner est un bouton : ajoutez l'appareil à un tableau de bord et le bouton « Appuyer » joue le son de Localiser sur cet iPhone, iPad, Mac ou Apple Watch — exactement ce que fait l'app Localiser. C'est un bouton poussoir, pas un interrupteur : rien à remettre sur « éteint », une pression = une sonnerie. Une scène peut l'actionner aussi (« si la sonnette retentit la nuit, fais sonner mon iPhone »).
L'action Faire sonner un appareil de l'onglet Configuration fait la même chose et reste disponible : c'est ce qui permet de faire sonner un appareil que vous n'avez pas encore ajouté à Gladys.
Vos appareils existent déjà dans Gladys ? Gladys ne modifie jamais tout seul les fonctionnalités d'un appareil déjà créé : ouvrez l'onglet Découverte de l'intégration et cliquez sur Mettre à jour sur chaque appareil pour que le bouton apparaisse.
Les AirTag ne sont pas remontés. Apple ne les expose pas dans l'API web de Localiser : leur position est chiffrée de bout en bout et n'est déchiffrée que par l'app Localiser sur un appareil Apple. iCloud.com lui-même n'affiche que l'onglet « Appareils », jamais les « Objets » — aucune intégration passant par le compte iCloud ne peut donc les voir. L'intégration lit malgré tout les listes d'accessoires si Apple se met un jour à les servir : elles seront découvertes sans nouvelle version.
Configuration
- Ouvrez l'onglet Configuration de l'intégration.
- Renseignez votre identifiant Apple (l'e-mail du compte iCloud) et votre mot de passe. Ils sont stockés chiffrés par Gladys et ne sont envoyés qu'à Apple.
- La latitude et la longitude de votre domicile sont pré-remplies avec
la position de votre maison Gladys : n'y touchez que si vous voulez un autre
point de référence. Si elles restent vides — maison créée sans adresse —
cliquez sur Récupérer les coordonnées de ma maison Gladys (l'action vous
dit ce qui bloque), ou saisissez-les en degrés décimaux (
48.8566,2.3522, à copier depuis n'importe quelle carte). Réglez le rayon dans lequel un appareil est considéré comme présent (150 m par défaut, à augmenter si votre terrain est grand ou si vos appareils sont souvent localisés par le Wi-Fi). - Enregistrez.
Double authentification (2FA)
Si votre compte utilise la double authentification — c'est le cas par défaut chez Apple — un code à 6 chiffres s'affiche sur vos appareils Apple juste après l'enregistrement. L'intégration demande explicitement ce code à Apple : un compte sans appareil de confiance (uniquement un numéro de téléphone) le reçoit par SMS.
- Notez le code. Le message affiché dans la Configuration précise où il a été envoyé (appareils de confiance, ou numéro de téléphone).
- Dans l'onglet Configuration, cliquez sur Envoyer le code de double authentification, saisissez-le, validez.
- L'intégration demande alors à Apple de faire confiance à cette session : le code n'est plus redemandé aux redémarrages suivants (Apple garde cette confiance environ 30 jours, parfois moins).
Si rien n'arrive, cliquez sur M'envoyer un nouveau code de double authentification : Apple renvoie un code (push sur les appareils, puis SMS en secours) sans repartir de zéro. Et si la notification n'arrive toujours pas sur vos appareils, M'envoyer le code par SMS force l'envoi sur un numéro de confiance.
Réglages avancés
- Intervalle de rafraîchissement (
poll_frequency, 300 s par défaut) : la fréquence à laquelle l'intégration demande une nouvelle position à Apple. C'est le réglage à ajuster en premier — plus court = présence plus réactive, mais plus d'appels chez Apple et plus de batterie consommée sur vos appareils. Le minimum accepté est 60 s. Gladys, de son côté, ne sait pas interroger plus lentement qu'une fois par minute : entre deux rafraîchissements réels, l'intégration répond simplement avec la dernière position connue. Quel que soit le réglage, elle n'interroge jamais Apple plus d'une fois toutes les 30 secondes, et un seul appel suffit pour tous vos appareils. - Précision maximale (500 m par défaut) : une position annoncée avec un rayon d'incertitude supérieur est ignorée. Sans ce garde-fou, une position déduite du Wi-Fi de l'opérateur ferait « voyager » votre présence de plusieurs kilomètres.
- Inclure les appareils de la famille : expose aussi les appareils partagés via le partage familial.
Anti-rebond de la présence
Un appareil devient présent dès qu'il entre dans le rayon, mais il ne devient absent qu'à 125 % du rayon. Avec un rayon de 150 m, il faut donc dépasser 187 m pour être déclaré parti. C'est ce qui évite qu'un téléphone posé en bord de zone déclenche vos scènes en boucle à cause du bruit GPS.
Actions disponibles
- Envoyer le code de double authentification — valide le code à 6 chiffres et fait approuver la session par Apple.
- M'envoyer un nouveau code de double authentification — redemande un code à Apple : push sur les appareils de confiance, ou SMS si le compte n'en a aucun.
- M'envoyer le code par SMS — force l'envoi sur un numéro de téléphone de confiance, même quand le compte a des appareils de confiance.
- Récupérer les coordonnées de ma maison Gladys — remplit la latitude et la longitude depuis votre maison Gladys, et affiche l'erreur exacte si Gladys ne les donne pas. Rechargez la page pour voir les champs remplis.
- Tester la connexion iCloud — relance une connexion et affiche le nombre d'appareils trouvés avec leurs noms.
- Oublier la session enregistrée — efface les jetons stockés. À utiliser si la connexion est bloquée dans un état bizarre : la connexion suivante repart de zéro (et redemandera un code 2FA).
- Faire sonner un appareil — choisissez un de vos appareils, il joue le son de Localiser. Pratique pour retrouver un téléphone dans le canapé, et c'est la façon de faire sonner un appareil que vous n'avez pas encore ajouté à Gladys. Les appareils ajoutés portent le même bouton sur leur carte de tableau de bord (voir plus haut).
Dépannage
« Connexion à iCloud impossible : ... » : le message reprend la réponse d'Apple. Les causes les plus fréquentes sont un mot de passe changé, un compte temporairement verrouillé après trop d'essais, ou une session à réapprouver.
Mon AirTag n'apparaît pas : c'est attendu, et ce n'est pas réparable côté intégration (voir l'encadré plus haut). Apple ne donne la position des objets Localiser qu'à l'app Localiser d'un appareil Apple. Pour déclencher une scène sur un objet, la solution est de suivre un appareil qui, lui, remonte sa position (iPhone, Apple Watch), ou un traqueur d'une autre marque avec sa propre intégration.
Aucun appareil n'apparaît : vérifiez que Localiser mon iPhone est activé sur les appareils concernés (Réglages → votre nom → Localiser). Un appareil éteint ou hors ligne depuis longtemps peut aussi ne remonter aucune position ; il apparaîtra dans Gladys mais sans présence tant qu'Apple n'a rien de récent.
L'appareil que je viens d'ajouter reste vide : ses mesures sont publiées dès sa création, puis à chaque rafraîchissement. S'il reste vide, regardez l'onglet Configuration (l'intégration doit être connectée à iCloud) et le champ Précision : un appareil dont Apple ne donne aucune position n'a ni présence, ni distance.
« Pas de valeur récente » sur le tableau de bord : Gladys considère une valeur comme périmée quand plus rien n'a été publié dessus depuis un moment (48 heures par défaut). L'intégration republie chaque valeur au moins toutes les 30 minutes : ce message ne devrait donc apparaître que si l'intégration est arrêtée, si elle n'arrive plus à se connecter à iCloud (regardez l'onglet Configuration) ou si l'appareil ne remonte aucune position.
Le bouton « Faire sonner » n'apparaît pas : l'appareil a été créé avant que la fonctionnalité existe. Onglet Découverte de l'intégration → bouton Mettre à jour sur l'appareil concerné.
L'appareil ne sonne pas : le son est joué par Apple, pas par Gladys. Un
appareil éteint, hors ligne ou en mode silencieux prolongé ne sonnera qu'à sa
prochaine connexion. Le message d'erreur affiché reprend la réponse d'Apple ;
avec LOG_LEVEL=debug, les logs donnent le détail.
La présence ne bouge pas : regardez la mesure Précision. Si elle est proche ou au-dessus de votre réglage « Précision maximale », les positions sont ignorées — augmentez le seuil, ou le rayon du domicile.
Je ne reçois aucun code 2FA : utilisez M'envoyer un nouveau code de double authentification, puis M'envoyer le code par SMS. Le message affiché dans la Configuration reprend la raison donnée par Apple quand celui-ci refuse d'envoyer quoi que ce soit. Vérifiez ensuite sur appleid.apple.com qu'un appareil de confiance ou un numéro de téléphone de confiance est bien enregistré : sans l'un des deux, Apple n'a nulle part où envoyer le code.
Les coordonnées restent vides : l'intégration lit la position de votre
maison via l'API de Gladys, ce qui demande l'autorisation location (déclarée
dans son manifeste) et une maison avec une adresse (Réglages → Maison).
L'action Récupérer les coordonnées de ma maison Gladys affiche la raison
exacte du refus.
Le code 2FA est redemandé souvent : c'est Apple qui décide de la durée de confiance d'une session. Évitez de changer le mot de passe ou de révoquer les sessions depuis appleid.apple.com.
L'intégration journalise tout ce qu'elle fait : consultez ses logs depuis
l'interface Gladys (ou docker logs sur l'hôte), avec LOG_LEVEL=debug pour
le détail complet.
À savoir
Apple ne publie aucune API officielle pour Localiser. Cette intégration utilise la même interface que le site web icloud.com, avec le même mécanisme de connexion sécurisée (SRP : votre mot de passe ne quitte jamais votre machine, seule une preuve cryptographique est envoyée). Apple peut modifier cette interface sans prévenir : si l'intégration cesse de fonctionner du jour au lendemain, c'est la cause la plus probable.
Vos identifiants restent chez vous, dans votre instance Gladys, et ne transitent par aucun service tiers.
Paramètres de configuration
Voici les paramètres demandés par Apple Device Tracker dans son écran de configuration dans Gladys.
| Paramètre | Type | Obligatoire | Description |
|---|---|---|---|
| Votre compte iCloud | section | Non | Cette integration se connecte a iCloud avec votre identifiant Apple et lit la position des appareils visibles dans Localiser. Vos identifiants restent dans Gladys, chez vous. La double authentification est geree : apres avoir enregistre, utilisez l'action ci-dessous pour saisir le code a 6 chiffres envoye par Apple, et l'action "M'envoyer un nouveau code" si rien n'arrive. |
| Identifiant Apple | string | Oui | L'adresse e-mail du compte iCloud proprietaire des appareils. |
| Mot de passe Apple | secret | Oui | Stocke chiffre par Gladys et envoye uniquement a Apple. Le modifier force une nouvelle connexion. |
| Votre domicile | section | Non | Un appareil est considere present quand il se trouve dans le rayon ci-dessous. Les coordonnees sont pre-remplies avec la position de votre maison Gladys : corrigez-les seulement si vous voulez un autre point de reference. |
| Latitude du domicile | string | Non | Degres decimaux entre -90 et 90 (exemple : 48.8566). Pre-remplie depuis votre maison Gladys si le champ est vide. Un champ texte, pour que les decimales ne soient jamais arrondies. |
| Longitude du domicile | string | Non | Degres decimaux entre -180 et 180 (exemple : 2.3522). Pre-remplie depuis votre maison Gladys si le champ est vide. Un champ texte, pour que les decimales ne soient jamais arrondies. |
| Rayon du domicile (m) | number | Non | Rayon autour du domicile marquant un appareil comme present. Un appareil n'est absent qu'au dela de 25% de ce rayon, pour eviter les allers-retours. |
| Avance | section | Non | Apple limite les appels a Localiser : gardez un intervalle de rafraichissement raisonnable. Les positions moins precises que le seuil ci-dessous sont ignorees plutot que de faire bouger votre presence. |
| Intervalle de rafraichissement (s) | number | Non | Frequence a laquelle l'integration demande une nouvelle position a Apple, en secondes. Gladys interroge l'integration chaque minute (sa propre limite) et l'integration repond depuis son cache tant que cet intervalle n'est pas ecoule. |
| Precision maximale (m) | number | Non | Les positions dont le rayon de precision depasse cette valeur sont ignorees. |
| Inclure les appareils de la famille | boolean | Non | Exposer aussi les appareils partages via le partage familial. |
Comment installer Apple Device Tracker dans Gladys
- Dans Gladys, ouvrez Intégrations : Apple Device Tracker 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/prohand/gladys-appledevicetracker:1.0.4), 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/prohand/gladys-appledevicetracker.
Apple Device Tracker nécessite Gladys >=4.86.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
Apple Device Tracker 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 prohand, et non par l'équipe cœur de Gladys.
- Parcourir toutes les intégrations externes
- Découvrir les intégrations natives intégrées à Gladys
- Créer et publier votre propre intégration externe
- Code source sur GitHub — source de cette documentation