Skip to content

About

A versatile and highly customizable timer card for Home Assistant Lovelace, offering multiple display styles and support for various timer sources.

Topics

Resources

Security policy

Stars

80 stars

Watchers

1 watching

Forks

Repository files navigation

⏱️ Simple Timer Card for Home Assistant

GitHub Release Downloads Community Forum Buy Me A Coffee

hero image

A clean, powerful timer card for Home Assistant that shows every timer you have in one place, whether it comes from a native timer.*, Alexa, Google Home, Voice PE, a helper, MQTT, or the card itself.

No dashboard clutter. No duplicated cards. Just timers.


🚀 Highlights

  • Every timer in one card: Native timer.*, Alexa, Google Home, Voice PE, helpers, MQTT, timestamps, and local timers
  • Auto-discovery: Optionally pick up Alexa and Google Home timers without listing every speaker entity
  • Quick actions: Presets, pinned one‑tap timers, and custom timers with a keypad or +/- buttons, plus an optional on-card input switch
  • Visual progress styles: Bars, fills, and circles (vertical or horizontal) with drain, fill, or milestone modes
  • Simple editor: Sources, storage, appearance, and timer input in one place, with a remembered Advanced mode for specialist settings
  • Persistent storage: Local timers survive reloads in the same browser; MQTT shares timers across devices
  • Audio & notifications: Optional sounds, snooze, cleanup, and push notifications while the card is running; a backend monitor is needed when all dashboards are closed
  • Theme aware & multilingual: Matches your Home Assistant theme; English, German, Spanish, Danish, Italian, French, Hebrew (RTL), Polish, Dutch, and Swedish
  • Spook fallback: Automatically falls back to Spook's timer.set_duration for non-admin users

📦 Installation

HACS (recommended)

Simple Timer Card is available in HACS.

Open your Home Assistant instance and open a repository inside the Home Assistant Community Store.

Manual

  1. Download simple-timer-card.js from the latest release
  2. Copy it to config/www
  3. Add it to Lovelace resources:
resources:
  - url: /local/simple-timer-card.js
    type: module

Updating to v2.9.0

Existing cards keep their +/- input and discovery remains opt-in. The old style: circle value still works as the vertical circle layout. If you tested a v2.9.0 pre-release, redownload v2.9.0 in HACS and fully reload the dashboard: the version number is unchanged, so an update notice may not appear.


🚦 Quick start

Add the card with no options and it keeps local timers in the browser:

type: custom:simple-timer-card

To follow timers that already exist in Home Assistant, list them:

type: custom:simple-timer-card
entities:
  - timer.kitchen
  - timer.laundry

📝 Configuration

Everything else, including styles, presets, pinned timers, storage, audio, notifications and tap actions, is in CONFIGURATION.md.

Guides: Voice PE and Voice PE with ESPHome · MQTT hybrid storage


🔒 Security

Input validation and sanitization, safe audio URL handling, rate limiting for actions, and graceful handling of corrupted storage. See SECURITY.md for details.


❤️ Support

If you enjoy this card and want to support its development:

Buy Me A Coffee

About

A versatile and highly customizable timer card for Home Assistant Lovelace, offering multiple display styles and support for various timer sources.

Topics

Resources

Security policy

Stars

80 stars

Watchers

1 watching

Forks

Releases

Packages

Contributors

Languages