How coluxhu/zectrix-daily-focus works
Zectrix Daily Focus assembles dashboard manifests from reusable templates, renders the resulting blueprint as an e-ink image, and pushes it to a Zectrix device. Its service runtime exposes manifest, render, push, run, schedule, and history APIs, with SQLite-backed run state. Provider modules add calendar, weather, solar, and Zectrix todo data to layouts. The graph reflects README-documented capabilities and shown source relationships; some service internals and unsampled provider wiring are not fully visible, so those links are omitted or marked unverified.
Main entry points: renderer.py Renderer · service.py Service API · composer.py Composer · pusher.py Image pusher
Components 20
Dashboard assembly
- Manifests
manifests - Templates
templates - Blueprints
blueprints - Composer
composer.py
Rendering and data
- Renderer
renderer.py - Calendar data
templates_requirements/calendar.py - Weather data
templates_requirements/qweather.py - Solar data
templates_requirements/hamqsl.py - Todo data
templates_requirements/zectrix.py - Rendered images
display_pictures
Device delivery
- Image pusher
pusher.py - Zectrix client
zectrix_client.py
Service runtime
- Service API
service.py - Cron scheduler
service.py - Run-state database
service.py
Other components
- Operator
- API client
- Zectrix device
- QWeather API
- HAMQSL feed
Connections 24
- Operator → Composer: runs assembly
README.md - Composer → Manifests: reads layout
composer.py - Composer → Templates: loads templates
composer.py - Composer → Blueprints: writes blueprint
composer.py - Operator → Renderer: runs rendering
README.md - Blueprints → Renderer: provides layout
README.md - Renderer → Calendar data: loads provider
renderer.py - Renderer → Weather data: loads provider
renderer.py - Renderer → Solar data: loads provider
renderer.py - Renderer → Todo data: loads provider
renderer.py - Weather data → QWeather API: requests forecasts
templates_requirements/qweather.py - Solar data → HAMQSL feed: fetches solar data
templates_requirements/hamqsl.py - Todo data → Zectrix client: queries todos
templates_requirements/zectrix.py - Renderer → Rendered images: writes image
README.md - Operator → Image pusher: runs push
README.md - Image pusher → Rendered images: selects image
pusher.py - Image pusher → Zectrix client: calls client
pusher.py - Zectrix client → Zectrix device: uploads image
- API client → Service API: calls endpoints
README.md - Service API → Composer: reuses assembly
service.py - Service API → Renderer: reuses rendering
service.py - Service API → Image pusher: reuses pushing
service.py - Service API → Cron scheduler: manages schedules
service.py - Service API → Run-state database: reads and writes
service.py