A highly customizable Lovelace clock card for Home Assistant designed to be 100% configurable from the Visual Editor — 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.

