noiwid/HAFamilyLink v0.8.0

v0.8.0 - Time Bonuses & Advanced Time Tracking

on GitHub

This release introduces full time bonus management, smarter per-device time tracking, and binary sensors that understand when restrictions are actually active. :contentReference[oaicite:0]{index=0}

✨ Major Features

⏱ Time Bonus Management

Per-device time bonuses are now first-class citizens:

• Active bonus sensors per device – Track how much bonus time is currently applied.
• Reset Bonus button – Instantly cancel any active bonus.
• One-tap bonus buttons:
  • +15 min
  • +30 min
  • +60 min
• Auto-refresh behavior – Entities update automatically after a bonus action so the UI stays in sync. :contentReference[oaicite:1]{index=1}

This makes it easy to grant “just a bit more time” without touching your base rules.

📊 Enhanced Time Tracking (Per Device)

Screen time is now tracked more precisely at the device level:

• Daily Limit sensor per device – Shows the configured daily time quota.
• Screen Time Remaining sensor – Takes into account:
  • time already used
  • active bonuses
• Next Restriction sensor – Tells you the next upcoming restriction (bedtime or school time).
• Active Bonus sensor – Exposes the currently applied bonus for each device. :contentReference[oaicite:2]{index=2}

This gives you a clear view of how much time is left and what will block the device next.

🚦 Functional Binary Sensors (Restriction Detection)

New binary sensors help you understand the live restriction state:

• binary_sensor.<device>_bedtime_active
  • True when the device is inside its bedtime window
  • Supports bedtimes that cross midnight (e.g. 21:30 → 07:00)
• binary_sensor.<device>_school_time_active
  • True when the device is in a school time window
• binary_sensor.<device>_daily_limit_reached
  • True when the daily limit is reached, ignoring bonuses (so you can still see if the limit itself is exhausted) :contentReference[oaicite:3]{index=3}

These sensors are designed to be automation-friendly, so you can easily build conditional logic in Home Assistant.

🎯 What This Means for Parents

With v0.8.0, you get much finer control over screen time:

• Grant temporary extra time (15/30/60 min) in one tap, without changing your core rules.
• See exactly how much time remains on each device.
• Know when the next restriction hits (bedtime or school).
• Use binary sensors to build clear, reliable automations (e.g. lights/red icon when daily limit is reached, notifications when bedtime becomes active).

📌 Example Use Cases

Scenario 1: “Five More Minutes” (but actually 15)

• It’s bedtime, but you allow a bit more time to finish a movie or game.
• You press +15 min on the device’s bonus button.
• The Active Bonus and Screen Time Remaining sensors update automatically.
• Your bedtime rules remain intact for the next day.

Scenario 2: Monitoring Limits Across Devices

• You check screen_time_remaining and next_restriction for each of your child’s devices.
• If daily_limit_reached is true but Active Bonus is still 0:
  • you know they’re fully out of time for today.
• If a bonus is active, you can see clearly how much extra time is left and whether bedtime is about to kick in.

Full changes from v0.6.5 to v0.8.0:
v0.6.5...v0.8.0