You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
README.md
Bear Stone Smart Home Documentation
Be sure to ⭐ my configuration repo so you can keep up to date on any daily progress!
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
.disabledor.NOTWORKINGsuffix; 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:underhomeassistant:in yourconfiguration.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, wind checks, 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 counter monitoring with snoozeable push actions and a 60-minute duplicate-trigger cooldown. | sensor.blitzortung_lightning_counter, input_boolean.snooze_lightning, notify engine actions |
|
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 Mon/Thu maintenance deadlines, container/stack Repairs automation, retired Portainer repair cleanup, 20-minute Joanna escalation for persistent container outages including stuck restarting/created states, and weekly scheduled prune actions across docker_10/14/17/69; the dedicated codex_appliance VM is monitored through BearClaw status telemetry. |
sensor.docker_*_apt_status, input_datetime.apt_docker_*_action_due, binary_sensor.*_stack_status, sensor.docker_stacks_down_count, repairs.create, repairs.remove, script.joanna_dispatch |
|
| Proxmox update detection with Repairs, 02:15 Joanna patch orchestration, final per-host HA success notifications, kernel-refresh handoff hints, runtime and disk pressure monitoring, plus nightly Frigate reboot. | binary_sensor.node_proxmox*_updates_packages, sensor.node_proxmox*_total_updates, persistent_notification.create, script.joanna_dispatch, binary_sensor.proxmox*_runtime_healthy, sensor.proxmox*_disk_used_percentage, button.qemu_docker2_101_reboot |
|
| 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 |
|
| Normalized WAN/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_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 |
|
| Dedicated-appliance OneNote indexer health/status monitoring for Joanna, explicit index-health confirmation, failure-repair automation, and a daily duplicate-delete maintenance request. | 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 event-based review dispatch for ### Available: reports. Home Assistant core updates remain held for explicit approval, config check, and a maintenance window; the Available-report path keeps its 24h cooldown without blocking failures. |
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, ingest /api/bearclaw/status telemetry, and expose dispatch, QMD/memory-index, plus Codex reset-credit expiry sensors and Repairs for Infrastructure dashboards. |
rest_command.bearclaw_*, sensor.bearclaw_status_telemetry, sensor.joanna_*, sensor.codex_reset_*, binary_sensor.joanna_*, binary_sensor.codex_reset_credit_expiring_soon, automation.bearclaw_*, automation.codex_reset_credit_expiry_repair, repairs.create, repairs.remove, 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 |
|
| 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 |
|
| 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 |
|
| Keeps the bedroom Fully Kiosk Fire tablet pinned to the dedicated camera kiosk dashboard when the page or foreground app drifts; normal wake events only restore brightness/focus. |
sensor.alarm_panel_1_current_page, sensor.alarm_panel_1_foreground_app, button.alarm_panel_1_bring_to_foreground, button.alarm_panel_1_load_start_url |
|
| 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, wind checks, nightly open-door reminders, and camera pop-ups.
- 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 <78°F or >92°F -> 78°F, home default -> 80°F. Downstairs bedtime cooling stays dynamic: outside >80°F -> 77°F, 76-79°F -> 79°F, below 76°F -> 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_phaseandinput_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 |
|---|---|---|
| Codex reset-credit expiry tracking with REST telemetry, template sensors, dashboard cards, and Repairs that stay open until the reset clears. | ||
| Custom Yahoo Finance integration overview and setup notes. | ||
| Garage arrival hub with auto-open guardrails, entry prompts, wind alerts, nighttime reminders, camera context, and the older MQTT/token setup notes. | ||
| Simple door-open and door-closed hallway lighting pattern from the garage walkthrough. | ||
| Fire tablet camera kiosk with a purpose-built dashboard, Fully Kiosk recovery, bedtime dimming, and screensaver watchdog behavior. | ||
| 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. | ||
| HVAC blower-failure evidence, runtime-based AC filter reminders, reset actions, and 360-day condenser-line cleanout reminders. | ||
| 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, strike alerts, 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 camera screen with Fully Kiosk recovery, bedtime dimming, and a dedicated camera dashboard. |
||
| Garadget garage door controller | MQTT covers feed arrival helpers, entry lighting, wind alerts, nighttime reminders, and security checks. |
||
| 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. |
||
| 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. |
||
| NodeMCU motion/contact sensor | ESP8266 nodes feed the alarm matrix and room-aware lighting. | ||
| 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.

