Skip to content

v0.2.0

Choose a tag to compare

@github-actions github-actions released this 08 May 22:12

⚠️ 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: true

Internal 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.
  • HassLike type unified across card and editor.
  • Greenwich (lon=0°) is now the explicit fallback for misconfigured non-sun centering modes — visually distinct from sun so 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