Skip to content

v0.8.0 - Time Bonuses & Advanced Time Tracking

Choose a tag to compare

@noiwid noiwid released this 16 Nov 23:53
935454c

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