Skip to content

AppDaemon Apps

Installed apps

App Description
door_notify Door open/close push notifications with optional AI image attachment
detection_summary_app Motion-triggered detection pipeline: capture, AI scoring, publish
detection_summary_viewer Dashboard viewer for detection summary bundles
photo_frame_viewer Photo slideshow on Lovelace dashboards (wall displays)
dashboard_notify AI-generated notification carousel for wall displays
calendar_from_schedule_app Sync YAML maintenance schedules to HA local calendar
immich_fetcher Periodic photo fetching from Immich photo library
school_lunch_app Fetch daily school lunch menus and publish to HA sensor
school_schedule_app Six-day class rotation and per-day class icons from the school calendar and PowerSchool
vestaboard_controller_app Vestaboard controller with frame queue, TTL/expiration, and board automations
vestaboard_configuration_app Configuration bridge between Lovelace card and Vestaboard controller
health_checks System health monitoring with decoupled checkers, auto-repair, and custom dashboard cards
media_dashboard_app Media dashboard: Plex movies, Plex shows, in-theaters, coming-soon with poster art, showtimes, and like/dismiss preferences
countdown_app Multiple countdowns with AI-generated backgrounds, auto-rotation, and text styling
zigbee_ota Sequential OTA firmware rollout across every Zigbee2MQTT device, one at a time, with offline-device retry
assist_exposure_guard Keeps locks, garage doors, cameras and unvetted scripts out of the voice assistants' exposure list, un-exposing anything dangerous and notifying

Shared providers

Provider Description
ai_providers LLM and image generation adapters (OpenAI, Gemini, Ollama, ComfyUI)
alertmanager Minimal Prometheus Alertmanager client the health-check controller pages through
metrics Prometheus exporter for the health-check controller: checker status, repairs and checker-supplied values
ha_provisioner Idempotent HA entity provisioning (scripts, helpers), reading and writing the voice-assistant exposure list, plus a check that Home Assistant is really serving a staged /local/... file
health_probes HTTP status and reachability probes for the health-check apps
photo_providers Photo source abstraction (Immich implementation)
school_menu Async client for the School Nutrition and Fitness API
school_schedule Finalsite school calendar (ICS) and PowerSchool guardian portal scrapers
media_providers Media data fetchers (Tautulli, TMDb, SerpApi) and shared types
vestaboard Vestaboard local API client and character encoding

App dependency graph

immich_fetcher
  └─ writes photos to disk
       └─ photo_frame_viewer (reads from same directory)

detection_summary_app
  └─ fires detection_summary/run_published event
  └─ writes bundles to shared filesystem
       └─ detection_summary_viewer (listens for events, reads filesystem)
       └─ door_notify (optional: attaches AI summary to notifications)
       └─ dashboard_notify (listens for events, copies generated images)

calendar_from_schedule_app (standalone — reads YAML, writes to HA calendar)

school_lunch_app (standalone — fetches school menus, publishes to HA sensor)

school_schedule_app (standalone — scrapes the school calendar + PowerSchool portal,
                     publishes sensor.school_schedule for school-schedule-card)

vestaboard_controller_app
  └─ controls physical Vestaboard via provider
       └─ vestaboard_configuration_app (forwards user commands)

health_checks (controller + checker_apps)
  └─ checker apps fire health_check_command events
       └─ health_check_controller (aggregates → sensor.health_check_status)
            └─ health-check-card / health-check-detail-card (reads sensor)
            └─ pages through Alertmanager (alertmanager provider), exports metrics (metrics provider)
            └─ reads AppDaemon's app list → restarts a checker app that never registered,
               then reports it as a critical checker if it stays missing

media_dashboard_app (standalone — fetches from Tautulli, TMDb, SerpApi)
  └─ publishes sensor.media_dashboard_status + sensor.media_dashboard_detail
       └─ media-dashboard-card / media-dashboard-detail-card (reads sensors)

countdown_app (standalone — generates images via ai_providers)
  └─ publishes sensor.countdown_status
       └─ countdown-card / countdown-config-card (reads sensor)

zigbee_ota (standalone — drives Zigbee2MQTT OTA via the MQTT plugin;
            asks Home Assistant which update entities are Zigbee2MQTT devices)
  └─ publishes sensor.zigbee_ota_orchestrator

assist_exposure_guard (standalone — guards the Assist exposure list via ha_provisioner)
  └─ publishes sensor.assist_exposure_guard + a persistent notification

Per-app documentation

Detailed documentation for each app lives in the app's README: appdaemon/apps/<app_name>/README.md