Skip to content

v1.3.0 - Timer helpers + UI polish

Choose a tag to compare

@eyalgal eyalgal released this 19 Jan 19:01
fda8d0c

Breaking changes

  • Timer now uses a Home Assistant timer.* helper
    • timer_entity now expects a timer.* entity (not input_text).
    • Timer presets only show when timer_entity is configured.
  • Timer end actions removed from the card
    • Options like timer_action_turn_off_light, timer_action_sound_mode, etc. are no longer supported.
    • Use a Home Assistant automation for “when the timer is up” behavior.

Migration

If you are upgrading from v1.2.x (or earlier):

  1. Create a timer helper
    • Settings -> Devices & Services -> Helpers -> Create Helper -> Timer
  2. Update your card config
    • Replace timer_entity: input_text.some_helper with timer_entity: timer.some_timer
    • Keep timer_presets as-is
    • Remove all timer_action_* keys (they no longer do anything)
  3. Add an automation for timer completion
    • Trigger on timer.finished for your timer entity
    • Perform your desired actions (turn off light, stop sound, set color, etc.)
    • See README for copy-paste examples
  4. Optional: enable device timer sync
    • Set sync_hatch_timer: true if you want the card to also call the Hatch integration timer services (when supported)

Improvements

  • Icon-only tap target
    • Tap actions apply to the icon only (matches common tile behavior and prevents accidental triggers).
  • Media toggle compatibility
    • Default toggle behavior updated for Hatch media players that do not support media_play_pause / toggle and instead expose play + stop.

UI fixes

  • Spacing and sizing tuned to align better with tile-style grids in both horizontal and vertical layouts.
  • Vertical layout expand chevron placement and alignment improved.
  • Sound selector behavior and alignment improved, including better scrolling behavior on smaller devices.

Notes

  • For a richer timer UI experience, I recommend pairing Hatch Card with my Simple Timer Card.