Home-AssistantConfig/config/packages/README.md

Bear Stone Smart Home Documentation

Be sure to ⭐ my configuration repo so you can keep up to date on any daily progress!

Kitchen Show's native Kiosk Satellite camera overlays use imported Home Assistant camera entities with HLS preferred over WebRTC on the Fire/WebView-class display.

Live collection of plug-and-play Home Assistant packages. Each YAML file in this folder bundles sensors, helpers, automations, scripts, and Lovelace assets needed for a specific subsystem so you can drop it into configuration.yaml with a single packages: include.

Quick navigation

• You are here: config/packages/ (self-contained packages)
• Repo overview | Config index | Automations | Scripts | Scenes | Templates | Package triggers | YouTube | Blog
• Disabled/staging packages follow the .disabled or .NOTWORKING suffix; remove it after you update credentials or hardware.

Why packages exist

• Keep everything for a subsystem (alarm, garage, water shutoff, etc.) in one file, which makes versioning, troubleshooting, and sharing dramatically easier.
• Encapsulate helpers (input_booleans, sensors, scripts) so enabling/disabling a capability is as simple as moving one file in or out of the packages/ include.
• Document hardware dependencies right next to the logic so you remember which gear keeps each automation alive.

How to adapt a package quickly

• Enable packages: under homeassistant: in your configuration.yaml, then drop any of these YAML files into the folder with your own entity IDs/secrets.
• Scan the comments at the top of each package for credential requirements, MQTT topics, or REST endpoints that need to be swapped.
• Need reusable triggers or button automations? Check the companion triggers subfolder for examples before rolling your own.

Featured packages (live today)

Package	What it unlocks	Notable entities / services
	NodeMCU-powered perimeter monitoring with arm/disarm helpers and rich notifications.	binary_sensor.mcu*_gpio*, group.family, notify + siren scripts
	Alexa Media helper sensors including stable bedroom wake-alarm wrappers for Carlo and Stacey plus a combined next-wake view.	sensor.last_alexa, sensor.bedroom_next_wake_alarm, sensor.bedroom_next_wake_alarm_source, binary_sensor.bedroom_next_wake_alarm_active
	SmartThinQ fridge monitoring with 6-minute raw door-open alerts plus fridge/freezer status announcements.	binary_sensor.refrigerator_door_open, script.notify_engine, script.speech_engine
	Nest climate schedules plus 350-hour downstairs/450-hour upstairs/9-month AC filter reminders and 360-day condenser-line cleanout reminders with snooze and changed/cleaned actions.	input_datetime.*_filter_snooze_until, sensor.*_ac_runtime_since_last_filter_change, sensor.hvac_condenser_lines_days_since_cleaned, script.notify_engine_two_button, mobile app action events
	MQTT-based garage door control plus arrival helpers, entry prompts, nighttime reminders, and camera context.	cover.large_garage_door, cover.small_garage_door, group.garage_doors, script.open_large_garage_door_if_ready
	Front-door August smart lock with Alexa Show camera pop-up when unlocked.	lock.front_door, media_player actions for front doorbell camera
	REST-driven US holiday + flag sensors plus the inspectable exterior lighting mode.	sensor.holiday, sensor.flag, sensor.holiday_lighting_mode, sensor.holiday_lighting_scene, JSON feed at config/www/json_data/holidays.json
	Blitzortung lightning monitoring with guarded distance wording, snoozeable push actions, single-owner safety speech, and a 60-minute duplicate-trigger cooldown.	sensor.blitzortung_lightning_counter, sensor.blitzortung_lightning_distance, input_boolean.snooze_lightning, script.speech_engine
	Dummy sensor.activity_feed + helper to write clean Activity entries (Issue #1550).	sensor.activity_feed, script.send_to_logbook
	MariaDB health sensors and Lovelace dashboard snippet for recorder stats.	sensor.mariadb_status, sensor.database_size
	Vision-backed garage-can and front-door package checks with rate-limited, downscaled OpenAI calls for package detection.	input_button.llmvision_*, binary_sensor.front_door_packages_present, llmvision.stream_analyzer
	Docker host patching telemetry with persisted daily maintenance deadlines, container/stack Repairs automation, retained Portainer health telemetry, retired Portainer image-update controls, 20-minute Joanna escalation for persistent container outages including stuck restarting/created states, and weekly scheduled prune actions across docker_10/13/14/17/69.	sensor.docker_*_apt_status, input_datetime.apt_docker_*_action_due, binary_sensor.portainer_status_2, sensor.portainer_cpu_usage_total_2, sensor.portainer_memory_usage_percentage_2, binary_sensor.*_stack_status, sensor.docker_stacks_down_count, repairs.create, repairs.remove, script.joanna_dispatch
	Proxmox update detection with amber dashboard maintenance state, 02:15 Joanna patch orchestration, kernel-refresh handoff hints, sequential migration and capacity gates, plus runtime and disk pressure monitoring. Docker14 recovery startup is pre-authorized only after expected VM placement and memory headroom are verified. Update availability does not create Repairs.	binary_sensor.node_proxmox*_updates_packages, sensor.node_proxmox*_total_updates, script.joanna_dispatch, binary_sensor.proxmox*_runtime_healthy, sensor.proxmox*_disk_used_percentage
	Synology DSM integration health normalization for Carlo-NAS01 and Carlo-NVR, with outage-aware Joanna-first handling for lone post-outage volume warnings and Repairs escalation for persistent or non-outage problems.	binary_sensor.carlo_*_synology_problem, sensor.carlo_*_synology_problem_summary, binary_sensor.powerwall_grid_status, repairs.create, script.joanna_dispatch
	Corroborated multi-probe WAN reachability, continuous latency/loss quality tiers, separate Ookla CLI capacity snapshots, normalized DNS/backup/domain/cert health, Nebula Sync and promoted IoT primary/backup Pi-hole consistency monitoring with Joanna dispatch, Glances-backed Docker host disk pressure with Joanna-only warning cleanup and critical Repairs, immediate website-down Repairs/Joanna dispatch plus uptime/latency SLO signals, nightly backup verification, and monthly Joanna HA log hygiene review with public-safe GitHub issue follow-up.	sensor.infra_wan_reachability, binary_sensor.infra_wan_capacity_degraded, binary_sensor.infra_wan_capacity_stale, binary_sensor.infra_wan_sustained_degradation, binary_sensor.infra_wan_severe_degradation, binary_sensor.infra_wan_critical, sensor.ookla_speedtest_download, sensor.ookla_speedtest_upload, sensor.infra_nebula_sync_dns_consistency, sensor.infra_pihole_iot_dns_consistency, binary_sensor.infra_nebula_sync_degraded, binary_sensor.infra_pihole_iot_dns_degraded, sensor.docker_*_disk_used_percentage, automation.infra_nebula_sync_health_dispatch, automation.infra_pihole_iot_dns_drift_dispatch, automation.docker_host_disk_pressure_monitor, automation.infra_website_down_repair_and_dispatch, binary_sensor.infra_website_uptime_slo_breach, binary_sensor.infra_website_latency_degraded, automation.infra_backup_nightly_verification, script.joanna_dispatch
	Logs corroborated WAN outages, sustained latency/loss degradation, slow Ookla capacity advisories, and recovery without letting one throughput snapshot declare the WAN down.	binary_sensor.infra_wan_quality_degraded, binary_sensor.infra_wan_outage, binary_sensor.infra_wan_capacity_degraded, sensor.ookla_speedtest_download, sensor.ookla_speedtest_upload, script.send_to_logbook
	UptimeRobot-backed Bear Stone and vCloudInfo down alerts with repeating failure notices and one recovery push only after a confirmed down to up transition. API availability recovery stays silent.	sensor.bear_stone, sensor.vcloudinfo_com, alert.*_down_alert, script.notify_engine
	Dedicated-appliance OneNote indexer health/status monitoring for Joanna, explicit index-health confirmation, and failure-repair automation. Native indexer reconciliation remains the maintenance owner.	sensor.onenote_indexer_last_job_status, binary_sensor.onenote_indexer_last_job_successful, binary_sensor.onenote_indexer_index_healthy
	Command-line MQTT broker reachability probe with Spook Repairs escalation and Joanna troubleshooting dispatch on outage.	binary_sensor.mqtt_status_raw, binary_sensor.mqtt_broker_problem, repairs.create, rest_command.bearclaw_command
	MariaDB recorder health and capacity snapshots with hourly live metrics, weekly admin/recorder polling, and stats-ready numeric sensors.	sensor.mariadb_status, sensor.database_size
	Root filesystem disk-pressure monitoring with immediate digest/logbook notes at 80%, Joanna review after 10 minutes above 80%, and delayed phone alerts only if the issue stays unresolved after dispatch.	sensor.disk_use_percent, repairs.create, script.joanna_dispatch, tts.clear_cache
	Tugtainer container update notifications via webhook + persistent alerts, with immediate Joanna recovery dispatch for ### Failed: / ### Rolled-back: reports and every ### Available: report. Home Assistant core participates in the 07:00 automatic rollout after a mandatory Tugtainer pre-update config check, with HTTP health and image rollback safeguards. Protected Tugtainer control-plane containers are updated one host at a time through their owning Compose stacks; duplicate Portainer image-update entities are auto-disabled because Tugtainer and Compose own rollout decisions.	automation.tugtainer_disable_duplicate_portainer_image_updates, persistent_notification.create, event: tugtainer_available_detected, script.joanna_dispatch, input_datetime.tugtainer_last_update
	Epson ink watchdog with one-day and one-week mobile snooze actions for low-ink reminders.	input_datetime.printer_ink_snooze_until, sensor.epson_*, mobile app action events
	Joanna/BearClaw bridge automations that forward Telegram commands to codex_appliance, include LLM-first routing context for freeform text, relay replies back, deliver compact hourly TeslaMate road-trip milestone and final summaries to Carlo and Stacey, ingest /api/bearclaw/status telemetry, and expose dispatch, BearClaw memory-index, user-keyed 7/28/90 step trends and personal records for Overview Health. Retired QMD telemetry is not imported. Road-trip companion: .	rest_command.bearclaw_*, sensor.bearclaw_status_telemetry, sensor.joanna_*, binary_sensor.joanna_*, automation.bearclaw_*, script.notify_engine, script.send_to_logbook
	Legacy Telegram transport marker for BearClaw; the shared joanna_send_telegram helper now forwards through the codex_appliance direct Telegram API.	rest_command.bearclaw_telegram_send, script.joanna_send_telegram
	Rheem EcoNet water-heater monitoring with normalized alert and telemetry-stale states, event snapshots, persistent Repairs, parent notifications, Joanna diagnostic dispatch, and safe electric-mode enforcement during the current warranty repair.	binary_sensor.rheem_wh_active_alert, binary_sensor.rheem_wh_telemetry_stale, binary_sensor.rheem_wh_problem, sensor.rheem_wh_diagnostic_status, sensor.rheem_wh_last_alert_snapshot, repairs.create, script.joanna_dispatch
	Phyn shutoff automations with leak-test guard, Activity Feed context, Repairs tracking, and critical push recovery when the valve closes.	valve.phyn_shutoff_valve, binary_sensor.phyn_leak_test_running, script.phyn_send_actionable_leak_notification, repairs.create
	ReadyRefresh delivery date helper with Joanna email-triage updates, night-before plus day-before garage door Alexa reminders, helper-change audit logging, and Telegram confirmations.	input_datetime.water_delivery_date, script.send_to_logbook, script.joanna_send_telegram, notify.alexa_media_garage
+	Rachio sprinkler status with active-zone summaries, trigger-derived last-run duration sensors, dashboard controls, and Activity Feed audit logging without input_* helpers.	sensor.rachio_controller_status, sensor.rachio_last_run_summary, sensor.rachio_*_last_run, script.rachio_*, automation.rachio_activity_feed
	Auto-enable vacation mode after 24 hours away or no bed use, track sitter analytics/secure-house checks, stale-visit timeout protection, deliver sitter-facing briefings, and send 10 AM/10 PM house digests with Powerwall/security/backup status plus Joanna review.	input_boolean.vacation_mode, input_boolean.house_sitter_present, input_datetime.vacation_house_sitter_*, input_datetime.vacation_house_status_digest_last_sent, sensor.vacation_house_sitter_*, binary_sensor.powerwall_grid_status, sensor.powerwall_charge, group.garage_doors, lock.front_door, script.vacation_house_sitter_clear_presence, script.vacation_house_status_digest, script.notify_engine, rest_command.bearclaw_command, script.joanna_send_telegram
	Receives Cruise Tracker price-drop webhooks and polls a separate sanitized endpoint hourly for the next confirmed cruise countdown shown on the Kitchen Show. Confirmation, cabin, pricing, and watch-list details never enter Home Assistant.	automation.royal_caribbean_price_drop_alert, sensor.next_booked_cruise_countdown, script.notify_engine
	Webhook-based water softener salt maintenance logging with idempotent event handling, Activity Feed logging, parser-safe refill cadence history, and dashboard-ready template sensors.	automation.maintenance_log_joanna_webhook_ingest, sensor.water_softener_salt_average_days_between_refills, sensor.water_softener_salt_refill_count, sensor.water_softener_salt_total_added
	Shares Garage-then-Front-Door priority plus reusable Bedroom header/alert state while keeping each display purpose-built. The Garage view now remains active for three minutes after both doors close before either kiosk returns to its default dashboard. Bedroom retains Fully wake/drift recovery and SleepIQ screen behavior around a clock-free night-watch display; Kitchen retains its clock/forecast, rotating household context, native camera overlays, Kiosk Satellite idle dimming, and an event-driven household policy that mutes and enforces off only while asleep or away. Nearby rain or lightning starts one five-minute NOAA radar takeover while the sun is above the horizon; afterward, the rotating Storms Approaching banner can replay the latest 20-minute loop while the event remains active. Actionable banner slides reuse one transient detail timer for NWS instructions, the front-door package view, a person-centered family map, open-entry details, Phyn water status with a confirmed valve-restore action, and hot-water recovery status. Sunset restores the ambient wall immediately. True idle panel-off remains disabled on the Crown LineageOS device until it has a reliable motion-wake input. Fully availability/page/app/power checks plus Kitchen connectivity, current-page, and screenshot freshness keep the Systems Kiosks tab truthful; a reachable Kitchen display remains online while stale session timestamps remain visible only in the telemetry panel. Available Kitchen updates remain advisory telemetry, while stable attention attributes preserve useful outage transitions without recording every heartbeat. At 07:00, Home Assistant requests the pending signed installer and waits two minutes for staging before dispatching Joanna to finish the Android confirmation and verify the Kitchen Show returns to its dashboard; an unsuccessful installation is retried at 07:00 the following day until the update entity confirms success.	binary_sensor.kiosk_garage_camera_active, sensor.kiosk_active_camera_view, sensor.bedroom_kiosk_header, sensor.kiosk_household_alert, binary_sensor.kiosk_rain_radar_weather_event, binary_sensor.kiosk_rain_radar_active, timer.kitchen_kiosk_radar_display, input_text.kitchen_kiosk_detail_view, timer.kitchen_kiosk_detail_display, script.kitchen_kiosk_show_event, script.kitchen_kiosk_show_detail, script.kitchen_kiosk_restore_phyn_water, binary_sensor.bedroom_kiosk_needs_attention, binary_sensor.kiosk_devices_need_attention, sensor.alarm_panel_1_current_page, button.alarm_panel_1_load_start_url, binary_sensor.kitchen_kiosk_should_be_on, number.kitchen_show_volume, light.kitchen_show_screen, button.kitchen_show_postpone_screensaver, button.kitchen_show_take_screenshot, sensor.kitchen_show_active_camera_view, automation.kitchen_kiosk_satellite_update_joanna_dispatch
	Track Tesla Powerwall grid status, push live outage tracking to mobile targets, shed loads automatically when off-grid, and alert if the Powerwall stays low after grid power returns.	binary_sensor.powerwall_grid_status, sensor.powerwall_*, script.notify_live_activity, repairs.create
	Remind the garage and parents to plug in the Model Y after the large garage door closes with a low battery, charging still off, both parents home, and a 24-hour mobile snooze available from the push reminder.	sensor.spaceship_battery_level, switch.spaceship_charge, person.carlo, person.stacey, cover.large_garage_door, input_datetime.tesla_model_y_last_garage_close, input_datetime.tesla_model_y_plug_in_snooze_until, notify.alexa_media_garage, script.notify_engine_two_button
	Dreame vacuum orchestration with room tracking, push alerts, Activity feed, Repairs issues on errors, and Alexa one-off room-clean switches.	input_select.l10s_vacuum_phase, sensor.l10s_vacuum_error, repairs.create
	Mirrors PC lock/unlock state to the office lamp and wakes CARLO-HOMEPC on workday morning bed exits.	sensor.carlo_homepc_carlo_homepc_sessionstate, button.carlo_home, switch.office_lamp_switch
	Sleep Number presence/snore automations plus a zero-filtered 14-day score summary; Overview Health keeps the detailed scores, vitals, pressure, and bed controls.	group.bed, binary_sensor.sleepnumber_carlo_carlo_is_in_bed, binary_sensor.sleepnumber_carlo_stacey_is_in_bed, sensor.sleepnumber_carlo_carlo_sleep_score, sensor.sleepnumber_carlo_stacey_sleep_score, sensor.sleep_score_14_day_averages, number.sleepnumber_carlo_carlo_firmness, select.sleepnumber_carlo_foundation_preset_right
	Yahoo Finance sensor bundle for portfolio glances and Lovelace cards.	sensor.tsla, sensor.aapl, sensor.amzn, sensor.msft

Garadget automations

• Logic lives in : auto-open on arrival, entry helper prompt (unlock front door or open garage), trusted-family shortcuts, nightly open-door reminders, and camera pop-ups. High-wind garage safety checks live in .
• MQTT-based covers for large/small doors; notifications and speech wired to the house notify/speech engines.
• Video companion: and .

Nest climate control

• Logic lives in and centralizes downstairs/upstairs Nest schedules, grid-aware guardrails, humidity pulses, and presence/weather-based targets.
• The HVAC maintenance walkthrough covers the runtime counters, filter reset scripts, dashboard cards, and 360-day condenser-line reminder: .
• Shared script keeps daytime targets consistent: away -> eco, home + outside >90F -> 78F, home + outside <=90F -> 80F. Daytime weather crossings must remain above or below 90F for one hour before changing the target. Downstairs bedtime cooling stays dynamic: outside >80F -> 77F, 76-79F -> 79F, below 76F -> leave the current target alone. Grid-down conditions pause non-essential cool-downs.

Dreame vacuum automations

• Logic lives in : continuous four-phase loop (sweep main, sweep baths, mop main, mop baths) driven by input_select.l10s_vacuum_phase and input_text.l10s_vacuum_room_queue, with per-room notifications and automatic reseeding between phases.
• Uses the Dreame HACS integration with segment IDs to enforce bathrooms last in each sweep/mop pass, dock on arrival, and auto-run if idle for 3+ days.
• Family-return docking now ignores away windows shorter than 20 minutes so brief walks do not interrupt an active run, but still docks if the family stays home for 10 minutes.
• Room queue advances on a 2-minute dwell in sensor.l10s_vacuum_current_room (queue = remaining rooms); phase changes happen when an empty queue is reseeded and the vacuum is not actively cleaning.
• One-off room cleaning for Alexa uses input_boolean.l10s_vacuum_clean_* (example: "Kitchen Clean") and runs a segment job without touching or checking the phased queue.
• Formal Dining (room 17/dock) is excluded from phased queues; clean it via the one-off toggle.
• Video companion: and .

Blog & video deep dives

When a package has a dedicated blog post or video, I link it right inside the YAML comments. Here are the same references for quick browsing:

Package	Why read/watch	Deep dive links
	Custom Yahoo Finance integration overview and setup notes.
	Garage arrival hub with auto-open guardrails, entry prompts, nighttime reminders, camera context, and the older MQTT/token setup notes.	· · ·
	Simple door-open and door-closed hallway lighting pattern from the garage walkthrough.	·
+ Bedroom dashboard + Kiosk Satellite preview	Shared event priority with purpose-built display surfaces: clock-free Bedroom night-watch context and cameras through Fully, plus Kitchen clock/forecast, reminders, native camera overlays, motion-aware dimming, and household-aware screen power through Kiosk Satellite.	·
	Garage-close timestamp used as a physical arrival signal for low-battery plug-in reminders.	·
	LLM Vision package reminder flow that turns a front-door camera event into a stored package-present state and phone alert.
+ +	Water softener salt maintenance flow with a reusable webhook, duplicate protection, helper-backed history, template sensors, and Salt Trends dashboard views.	· · Issue #1816
+	HVAC blower-failure evidence, runtime-based AC filter reminders, reset actions, and 360-day condenser-line cleanout reminders.	· Issue #273
+ +	Snoozeable Home Assistant mobile notifications for AC filters, printer ink, and Vacation Mode missed-visit reminders.	· ·
	How the holiday/flag sensor works and drives lighting playlists.
	Blitzortung detector wiring, guarded strike alerts, one lightning speech path, and snooze workflow.
	Leak-detection response loop with valve state, maintenance guard, Activity Feed context, Repairs tracking, and critical push recovery.	· ·
	Monitoring Tesla Powerwall health + what to automate when the grid drops.	· ·
	Sustained-away Vacation Mode, house-sitter visit tracking, reminders, missed-visit alerts, secure-house checks, and vacation house digests that keep Powerwall status visible.	·
	Dreame away-only cleaning, room queues, sweep/mop phases, Alexa one-off room commands, and rescue notifications.	· ·
	Sync Pi-hole blocking state across HA DNS nodes.
	Rendering Grafana dashboards to images for Lovelace and social posts.	· ·
	Smart lock control and status from HA.

Hardware referenced in packages (affiliate links)

These are the devices that power the packages above, plus tracked hardware implementation candidates. Affiliate links never change the price but they do help fund more tinkering—thanks!

Device	Package(s)	Automation tie-in	Buy
Amazon Fire tablet wall kiosk	, Bedroom dashboard, Kiosk Satellite preview	Bedroom Fully and Kitchen Kiosk Satellite share camera-event state while retaining purpose-built layouts and device-specific screen, recovery, motion, and camera rendering controls. .
Garadget garage door controller		MQTT covers feed arrival helpers, entry lighting, nighttime reminders, and security checks. and .
August smart lock		Front-door lock/unlock + status for routines and alerts.
Amazon Echo Show	Pops up the front doorbell camera when the August lock unlocks.
Amazon Echo Glow		Visual notification light candidate for Home Assistant status cues.
Phyn Plus water shutoff		Leak events trigger valve closes + critical push notifications. and .
Rachio sprinkler controller	+ +	Rain skips, active-zone status, trigger-derived last-run history, and dashboard controls.
Tesla Powerwall 2		Grid outages kick off status pings, load-shed scripts, and low-charge charging watchdog alerts.
Google Nest thermostat		Presence/weather/grid-aware cooling targets, humidity pulses, runtime filter reminders, and condenser-line cleanout tracking.
Dreame/Neato vacuum		Away-only room queues, sweep/mop phases, Alexa room cleans, rescue notifications, and voice callouts. and .
NodeMCU contact sensor		ESP8266 contact nodes feed the alarm matrix.
Roku streaming device		Media presence drives lighting, announcements, and scenes.

Tips for extending these packages

• Most packages expose booleans or helpers that you can hook into with your own automations; keep using those entities instead of editing the package so upgrades stay clean.
• If you clone a package, rename the id: fields inside the automations to avoid duplicate UUIDs.
• Document your own blog or video resources at the top of each file—the README table above will make it easy to find them later.

All of my configuration files are tested against the most stable version of home-assistant.

Still have questions on my Config?
Message me on X :

You can buy me a coffee

Affiliate Disclosure