Skip to content

v0.1.1 — first HACS-installable release

Choose a tag to compare

@jpettitt jpettitt released this 08 May 01:30

First HACS-installable release of geo-clock-card.

Highlights

  • Live world map with NASA Blue Marble (24 frames, start + mid of each month) + Black Marble imagery.
  • Day/night terminator computed from real solar geometry, with a tunable warm twilight glow at the boundary.
  • DST-aware hover popup for every IANA time zone on the planet — taps work on mobile (pointer events + 2.5 s touch dismissal). Open ocean falls back to a generic offset popup.
  • Centering modes: sun (default — subsolar, daylight stays in the middle), home (HA-configured location), longitude (numeric), or entity (any zone / person / device_tracker).
  • Optional home marker at your HA location that tracks the map's drift.
  • Visual editor (HA Lovelace) — every option that matters is exposed; advanced visual knobs tucked under an expansion panel.
  • Locale-aware time format in the popup (24h or AM/PM follows browser config) with a date line so remote-zone day rollovers are visible.
  • Power-aware: the timer drops to 30 min cadence when the card is off-screen or the browser tab is backgrounded.

Install via HACS

  1. HACS → ⋮ → Custom repositories → add https://github.com/jpettitt/geo-clock-card, category Lovelace.
  2. Install Geo Clock Card.
  3. Refresh. Resource is auto-added at /hacsfiles/geo-clock-card/geo-clock-card.js.
  4. Add the card from the UI picker — visual editor opens.

Full config reference and CSS-variable theming hooks: see README.md.

Bundle

  • geo-clock-card.js — 46 KB, single file
  • blue-marble-{01..12}-{start,mid}-2048.jpg — 24 daylight composites
  • black-marble-2048.jpg — night map
  • timezones.json — 8 KB offset bands
  • timezones-iana.json — 958 KB IANA polygons (419 zones)

NASA imagery is public domain. timezone-boundary-builder data is ODbL.