How gklier/kliercalendar works
Family Dashboard combines a Python server that keeps settings and credentials, fetches calendar/weather/traffic/stock data, and serves APIs with a browser-based TV display and phone-friendly admin. The main workflow is configure sources and appearance in admin, fetch and serve live data, then render it on the TV; the Pi launcher also handles sleep state and optional hosted-screen fallback. README statements establish the broad service/API links; sampled code confirms TV mode selection, admin API usage, layout preview messaging, and schedule behavior. Several server subsystems are documented but not independently sampled.
Main entry points: server.py HTTP API and config · kiosk.sh Kiosk launcher · app.js TV dashboard runtime · pages-layout.js Layout editor
Components 25
Settings and administration
- Admin settings UI
web/admin/admin.js - Look editor
web/admin/pages-look.js - Layout editor
web/admin/pages-layout.js - Schedule controls
web/admin/pages-schedule.js - Backup and help
web/admin/pages-ops.js
Dashboard server
- HTTP API and config
server/server.py - Calendar collection
server/server.py - Weather fetch
server/server.py - Drive-time calculation
server/server.py - Stock quotes
server/server.py - Settings and media
server/server.py
Live data sources
- Google Calendar / CalDAV
- Google Maps Routes
- Tempest station
- Finnhub quotes
TV display
- TV dashboard runtime
web/app.js - Demo data mode
web/demo.js - Weather and place icons
web/icons.js
Pi operation
- Kiosk launcher
pi/kiosk.sh - Kiosk setup
pi/kiosk_setup.py
Other components
- Family / settings user
- System maintainer
- Hosted dashboard fallback
- Living-room TV
- Phone / browser
Connections 27
- Family / settings user → Phone / browser: opens settings
README.md - Phone / browser → Admin settings UI: uses
README.md - Admin settings UI → HTTP API and config: sends settings
web/admin/admin.js - Look editor → HTTP API and config: saves appearance
README.md - Layout editor → TV dashboard runtime: previews layout
web/admin/pages-layout.js - Layout editor → HTTP API and config: saves layout
README.md - Schedule controls → HTTP API and config: updates schedule
web/admin/pages-schedule.js - Backup and help → HTTP API and config: requests backup
README.md - HTTP API and config → Settings and media: reads and writes
README.md - HTTP API and config → Calendar collection: serves calendar data
README.md - HTTP API and config → Weather fetch: serves weather data
README.md - HTTP API and config → Drive-time calculation: serves drive times
README.md - HTTP API and config → Stock quotes: serves stock data
README.md - Calendar collection → Google Calendar / CalDAV: fetches calendars
README.md - Weather fetch → Tempest station: fetches conditions
README.md - Drive-time calculation → Google Maps Routes: requests routes
README.md - Stock quotes → Finnhub quotes: fetches quotes
README.md - TV dashboard runtime → HTTP API and config: loads live data
README.md - TV dashboard runtime → Demo data mode: uses demo mode
web/app.js - TV dashboard runtime → Weather and place icons: renders glyphs
- Kiosk launcher → HTTP API and config: polls status
README.md - Kiosk launcher → TV dashboard runtime: opens dashboard
README.md - HTTP API and config → Kiosk launcher: provides sleep state
- Kiosk setup → Kiosk launcher: configures kiosk
- Kiosk launcher → Living-room TV: drives display
README.md - Kiosk launcher → Hosted dashboard fallback: falls back to
README.md - System maintainer → Backup and help: uses recovery tools
README.md