⏱️ Simple Timer Card for Home Assistant

A clean, powerful timer card for Home Assistant that works seamlessly with native timers, Alexa, Voice PE, helpers, MQTT, and local UI timers.

---

✨ Why Simple Timer Card

Simple Timer Card focuses on doing one thing extremely well: making timers easy to see, start, and manage, no matter where they come from.

What you get:

• One card for all your timers
• Works with native HA timers, Alexa, Voice PE, helpers, MQTT, and local UI timers
• Clean UI that scales from one timer to many
• Persistent timers that survive reloads and sync across devices

No dashboards clutter. No duplicated cards. Just timers.

---

🚀 Highlights

• Multiple timer sources: Native timer.*, Alexa, Voice PE, helpers, MQTT, timestamps, and more
• Quick actions: Presets, pinned one‑tap timers, and custom timers
• Visual progress styles: Bars, fills, and circles with drain, fill, or milestone modes
• Sorting & layout control: Sort by time or name, pin timers inline, top, or bottom
• Custom interactions: Standard tap_action, hold_action, and double_tap_action at card and row level
• Persistent storage: Local or MQTT based, survives reloads and syncs across devices
• Audio & expiry actions: Optional sounds, snooze, auto dismiss, and expiry behavior
• Push notification fallback: Optional notify service call on timer end, so iOS / Android devices ring even when the in-page audio cannot
• Theme aware: Automatically matches your Home Assistant theme
• 🌍 Multi-language support: English, German, Spanish, Danish, Italian, French, Hebrew (RTL), Polish, and Dutch
• Spook fallback: Automatically falls back to Spook's timer.set_duration for non-admin users

---

🔌 Integrations & Guides

Simple Timer Card works with a wide range of timer sources, from native Home Assistant timers to advanced setups.

• Voice PE

  • Mirror Voice PE timers or fully control them from the UI
  • Supports ESPHome-based local timers
  • 📖 Docs: Voice PE overview
    📖 Advanced: Voice PE + ESPHome

• MQTT (Persistent Timers)

  • Timers survive reloads and sync across devices
  • Hybrid MQTT model with local fallback
  • 📖 Docs: MQTT Hybrid Storage Model

---

📦 Installation

HACS (recommended)

Simple Timer Card is available in HACS.

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

---

📝 Configuration

Configuration has grown over time, so it now lives in its own dedicated document.

➡️ See full configuration reference:

👉 CONFIGURATION.md

---

🔒 Security

The card includes built‑in safeguards:

• Input validation and sanitization
• Safe audio URL handling
• Rate limiting for actions
• Graceful handling of corrupted storage

See SECURITY.md for details.

---

❤️ Support

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