A customizable Home Assistant Lovelace clock card with a real-time digital clock, date and status entities. It is fully configurable from the Home Assistant Visual Editor, with no YAML required.
Seamlessly blend the clock directly into your dashboard background or wallpaper with 0% opacity, optional glassmorphism blur, and hidden borders:
- 100% Visual Configuration: Built with native Home Assistant
ha-selectorcontrols organized into expandable sections (Clock,Date & Language,Status Entities (3),Size & Typography,Colors & Transparency). - Flexible Time Display:
- Hours only (
HH), Hours & Minutes (HH:MM), or Hours, Minutes & Seconds (HH:MM:SS). - Seconds style: same size inline, small superscript, or small subscript.
- 24-hour or 12-hour (
AM/PMinline, superscript, subscript, or below). - Leading zero toggle, blinking
:separator toggle, and optional custom IANA timezone.
- Hours only (
- Multi-Language Support (9 Languages + Auto):
- Automatic detection from Home Assistant language (
auto), or force any language:en— Englishes— Españolit— Italianopt— Portuguêspt-BR— Português do Brasilru— Русскийde— Deutschfr— Françaiszh-Hans— 简体中文
- Translates both long dates (weekday & month names with authentic grammar) and the Visual Editor interface.
- Automatic detection from Home Assistant language (
- Short & Long Date Formats:
- Short date order:
DD/MM/YYYY,MM/DD/YYYY, orYYYY/MM/DDwith configurable separator (/,-,.) and 2/4-digit year. - Long date options: full/short/hidden weekday, full/abbreviated month, show/hide year, capitalization toggle.
- Combined mode: Weekday + Short date.
- Place date above or below the clock.
- Short date order:
- 3 Status Entity Slots:
- Up to 3 optional status chips placed above or below the clock.
- Pick any entity and optionally select any entity attribute (for example
temperatureorhumidityfrom aweather.*entity). - Customize icon, name, unit, and visibility toggles per slot.
- Clicking an entity opens Home Assistant's
more-infodialog.
- Size, Typography, Colors & Transparency:
- Independent sliders for card padding, minimum height, clock size, seconds/AM-PM size, date size, entity size, spacing, corner radius, alignment, font weight, and font style.
- Supports Home Assistant Sections grid resizing (
getGridOptions). - Custom text colors, icon color, background color, background opacity (
0%–100%), glassmorphism backdrop blur, and toggles to hide card border and shadow.
- In Home Assistant, open Marketplace (via Settings → Marketplace) or HACS.
- Search for Simple Clock Card.
- Click Download.
- Reload your browser or dashboard resources when prompted.
- Download
simple-clock-card.js(from the repository root ordist/simple-clock-card.js). - Copy it into
<config>/www/simple-clock-card.js. - In Home Assistant, go to Settings → Dashboards → Resources → Add Resource:
- URL:
/local/simple-clock-card.js - Resource type: JavaScript Module
- URL:
- Reload your browser and add Simple Clock Card from the visual card picker.
npm install
npm run typecheck
npm run build
npm testnpm run buildoutputs the compiled bundle todist/simple-clock-card.jsand copies it tosimple-clock-card.js.npm testrunstests/verify.mjsto verify multi-language localization, date/time formatting, transparency utilities, entity attribute extraction, and the generated bundles.

