v0.2.0
⚠️ Breaking change
mainTimeSource defaults to home — the wall-clock readout now shows the time at your HA-configured location, not the viewing browser's local time. To restore pre-0.2.0 behavior, add mainTimeSource: device to your card config.
What's new
Location markers. Pin any list of HA entities on the map. Each marker shows a colored dot, its label, and the current local time at that location (DST-aware via IANA polygon hit-test). Per-marker color, card-wide default via markerColor, or --geo-marker-color CSS variable for theme-only restyling. Visibility is always (label + time under the dot) or hover (popup-only). The weekday is appended by default so a marker on the far side of the planet whose date has rolled over is obvious — toggle off with markerShowDay: false for time-only.
Configurable main clock. New mainTimeSource: home | device | entity config (default home). Reads from your HA zone (default), the viewing browser, or any HA entity with lat/lon attributes.
Home marker label + time. Opt-in via showHomeMarkerLabel, shows the home name and current local time under the existing dot.
Visual editor fixes. Entity selection now uses HA's <ha-selector> and reliably renders. Color and number inputs commit on change instead of input — no more map redraw on every drag step or keystroke.
Markers config example
type: custom:geo-clock-card
markers:
- entity: zone.work
label: Office
- entity: person.alice
color: '#ff7a3d'
markerLabelMode: always
markerShowDay: true
mainTimeSource: home
showHomeMarker: true
showHomeMarkerLabel: trueInternal changes
- Markers render as HTML overlays (not SVG) so dot, halo, and label stay at fixed CSS pixel size regardless of card width — previous SVG version was illegible on anything below full screen.
- Editor awaits
loadCardHelpers()before rendering, which is what registers<ha-selector>and friends; without it the picker tags mount as inert elements. HassLiketype unified across card and editor.- Greenwich (lon=0°) is now the explicit fallback for misconfigured non-sun centering modes — visually distinct from
sunso a broken config doesn't silently look right. Watch the console for a warn line that names the broken field.
Notable since v0.1.2
- v0.1.2 — visual editor fixes (center selection, entity picker UX)
- v0.1.1 — first HACS-ready release with NASA Blue/Black Marble imagery, day/night terminator, hour band, IANA TZ overlay, and DST-aware hover popups
Full Changelog: v0.1.2...v0.2.0