v0.1.1 — first HACS-installable release
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), orentity(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
- HACS → ⋮ → Custom repositories → add
https://github.com/jpettitt/geo-clock-card, category Lovelace. - Install Geo Clock Card.
- Refresh. Resource is auto-added at
/hacsfiles/geo-clock-card/geo-clock-card.js. - 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 fileblue-marble-{01..12}-{start,mid}-2048.jpg— 24 daylight compositesblack-marble-2048.jpg— night maptimezones.json— 8 KB offset bandstimezones-iana.json— 958 KB IANA polygons (419 zones)
NASA imagery is public domain. timezone-boundary-builder data is ODbL.