Google Family Link pour Home Assistant - Contrôlez et surveillez les appareils de vos enfants
Bonjour à tous ! 
Je suis ravi de vous présenter mon intégration Google Family Link pour Home Assistant.
Remerciements
Avant tout, je tiens à remercier :
- @tducret pour son package Python original qui a documenté les premiers endpoints de l’API Google Family Link
- @Vortitron pour son travail initial sur HAFamilyLink qui a servi de base à ce projet
- La communauté Home Assistant pour l’inspiration et les nombreux exemples d’intégrations
Sans ces briques, ce projet n’aurait jamais vu le
Qu’est-ce que c’est ?
Cette intégration vous permet de surveiller et contrôler les appareils Google Family Link de vos enfants directement depuis Home Assistant. Temps d’écran, verrouillage à distance, statistiques d’utilisation… tout est désormais accessible et automatisable !
Fonctionnalités principales
Contrôle des appareils
- Verrouillage/déverrouillage à distance via des interrupteurs (switches)
- Synchronisation bidirectionnelle : les changements faits dans l’app Family Link se reflètent dans Home Assistant
- Support multi-appareils : gérez tous les appareils supervisés de vos enfants
Suivi du temps d’écran
- Temps d’écran quotidien en temps réel
- Top 10 des applications les plus utilisées avec statistiques détaillées
- Répartition par application (heures, minutes, secondes)
- Mises à jour automatiques toutes les 5 minutes (personnalisable)
Gestion des applications
- Nombre d’applications installées
- Applications bloquées avec liste complète
- Applications avec limites de temps
- Détails complets : noms de package, titres, limites configurées
Informations sur l’enfant
- Profil complet : nom, email, date de naissance, tranche d’âge
- Informations des appareils : modèle, nom, capacités, dernière activité
- Membres de la famille avec leurs rôles
Architecture : Add-on + Intégration
Le projet se compose de deux éléments complémentaires :
1. Add-on d’authentification (obligatoire)
Fournit l’authentification sécurisée via navigateur :
- Automation Playwright avec Chromium headless
- Support 2FA (SMS, authenticateur, notifications push)
- Stockage chiffré des cookies
- Rafraîchissement automatique des sessions
2. Intégration Home Assistant
Assure la surveillance et le contrôle :
- Interface de configuration conviviale (config flow)
- Client API pour communiquer avec Google Family Link
- Coordinateur de données avec cache
- Entités (capteurs et interrupteurs)
Pourquoi deux composants ? L’environnement Docker de Home Assistant restreint l’automation de navigateur. L’add-on tourne dans un conteneur séparé avec Chromium et Playwright, tandis que l’intégration gère la récupération de données et le contrôle des appareils.
Exemples d’automatisations
Verrouillage au coucher
automation:
- alias: "Verrouiller le téléphone à l'heure du coucher"
trigger:
- platform: time
at: "21:00:00"
condition:
- condition: time
weekday: [mon, tue, wed, thu, fri]
action:
- service: switch.turn_off
target:
entity_id: switch.telephone_enfant
Alerte temps d’écran excessif
automation:
- alias: "Alerte si temps d'écran excessif"
trigger:
- platform: numeric_state
entity_id: sensor.family_link_daily_screen_time
above: 180 # 3 heures en minutes
action:
- service: notify.mobile_app
data:
message: "⚠️ Plus de 3h d'écran aujourd'hui !"
Déverrouillage automatique le week-end
automation:
- alias: "Déverrouiller le week-end matin"
trigger:
- platform: time
at: "09:00:00"
condition:
- condition: time
weekday: [sat, sun]
action:
- service: switch.turn_on
target:
entity_id: switch.telephone_enfant
Installation
Via HACS (recommandé)
- Ajoutez ce dépôt comme source personnalisée dans HACS
- Installez l’add-on Family Link Auth depuis le Store de Supervisor
- Démarrez l’add-on et authentifiez-vous via l’interface web (port 8099)
- Installez l’intégration Google Family Link via HACS
- Configurez l’intégration dans Paramètres → Appareils et services
Guide d’installation détaillé disponible dans le README
Avertissement important
Cette intégration utilise des endpoints non officiels de l’API Google Family Link obtenus par reverse engineering.
Utilisez-la à vos propres risques. Cela peut violer les conditions d’utilisation de Google et pourrait entraîner une suspension de compte. Ce projet n’est pas affilié, approuvé ou connecté à Google LLC.
Liens utiles
- GitHub : GitHub - noiwid/HAFamilyLink
- Signaler un bug : GitHub · Where software is built
- Demande de fonctionnalité : Sign in to GitHub · GitHub
- Discussions : noiwid/HAFamilyLink · Discussions · GitHub
Version actuelle
v0.5.0 - Synchronisation en temps réel de l’état de verrouillage des appareils
Contributions
Les contributions sont les bienvenues ! N’hésitez pas à :
- Signaler des bugs
- Proposer de nouvelles fonctionnalités
- Soumettre des pull requests
- Partager vos automatisations
J’espère que cette intégration vous sera utile ! N’hésitez pas à me faire part de vos retours, suggestions ou questions.
Bon contrôle parental à tous ! 
).
