github noiwid/HAFamilyLink v0.5.0
v0.5.0 - Device Lock Control & Screen Time Monitoring

latest releases: v1.2.10, v1.2.9, v1.2.8...
8 months ago

🎉 What's New in v0.5.0

🔒 Device Lock Control

  • Lock and unlock supervised devices directly from Home Assistant
  • Real-time synchronization with Google Family Link
  • Bi-directional control - changes in Family Link app automatically sync to HA
  • Support for multiple supervised devices

📊 Screen Time Monitoring

  • Track daily screen time with two sensor formats:
    • Numeric (minutes) for graphs and automations
    • Formatted (HH:MM:SS) for display
  • Top 10 most-used apps with detailed usage statistics
  • Per-app usage breakdown with hours, minutes, and seconds
  • Automatic updates every 5 minutes (customizable)

📱 App Management

  • Monitor installed apps count
  • Track blocked/hidden apps
  • List apps with time limits
  • Detailed app information (package names, titles, restrictions)

👶 Child & Family Information

  • Child profile details (name, email, birthday, age band)
  • Device information (model, name, capabilities, last activity)
  • Family members list with roles

📦 Installation

See the Installation Guide for detailed instructions.

Requirements:

  • Home Assistant
  • Family Link Auth Add-on (handles authentication via Playwright)
  • HACS (recommended) or manual installation

📊 Available Entities

  • Sensors: Screen time, installed apps, blocked apps, top 10 apps, device count, child info
  • Switches: Device lock/unlock controls (ON = unlocked, OFF = locked)

⚠️ Important Disclaimer

This integration uses unofficial, reverse-engineered Google Family Link API endpoints. Use at your own risk. This may violate Google's Terms of Service.

🐛 Known Issues

  • Authentication cookies may expire periodically (re-authenticate via add-on Web UI)
  • Top app sensors show "unavailable" until child uses apps on current day
  • Update interval minimum is 5 minutes to avoid rate limiting

📝 Full Changelog

See all commits: https://github.com/noiwid/HAFamilyLink/commits/v0.5.0

Don't miss a new HAFamilyLink release

NewReleases is sending notifications on new releases.