24 KiB
Bear Stone Smart Home Documentation
Be sure to ⭐ my configuration repo so you can keep up to date on any daily progress!
Live view of the config/ directory my production Home Assistant instance loads every night. Use this README as a map when you want to jump directly into the most interesting packages, automations, and supporting assets.
Quick navigation
- You are here:
config/(configuration root) - Repo overview | Blog | Issues | Diagram | YouTube
- Directory highlights: packages, automation, script, scene, custom templates, dashboards, www, custom_components
What this folder is (and isn't)
- Every YAML file here is live and version-controlled; anything missing is intentionally ignored via
.gitignore(databases, logs, caches, etc.). - This is a split-configuration layout:
configuration.yamlsimply includes the files and directories documented here so changes are easy to isolate. - Nothing in this folder is a drop-in template—borrow ideas, but adjust entity IDs, helpers, and secrets to match your home before reloading HA.
How the config is organized
- HomeKit - Main bridge configuration maintains the existing imported bridge's entity filter. Apply filter changes with
homekit.reload; keep retired entities out of HomeKit and Alexa include lists. - Packages (
packages/) – complete subsystems that bundle sensors, switches, automations, scripts, and lovelace assets for a single feature (alarm, garage, water shutoff, etc.). - Container updates –
tugtainer_updates.yamlprocesses Available reports without persistent alerts, keeps Updated/Failed outcomes visible, and dispatches controlled review work. - WAN monitoring –
infrastructure.yaml,speedtest.yaml, and the WAN dashboard separate multi-probe reachability, continuous latency/loss, Ookla capacity, and result freshness. - BGW gateway monitoring –
bgw_gateway.yaml, the BGW Probe project, and the Network dashboard expose read-only gateway reachability, broadband link, uptime, speed, and traffic counters. - Entity cleanup –
docker_infrastructure.yaml,infrastructure.yaml, recorder, and logbook show how the Portainer and Glances audit kept proven history while removing stale registry noise. - Automations (
automation/) – event-driven YAML broken out by area or device; the legacyautomations.yamlremains for UI-created flows. The Frigate driveway example turns a car-specific zone and 30-second loiter into a two-phone camera alert plus LLM-backed speech.driveway_parked_car.yaml - iOS notification icons –
notify_engine.yamladds colored household presets and caller overrides. - Local holiday calendars -
holiday.yamlandholiday_countdowns.pypreserve countdown IDs, refresh at startup and local midnight, and drive speech flavor and seasonal scenes.Dashboard theming follow-up:
ambient.js - Scripts & scenes (
script/,scene/) – curated lighting, notification, and AGENT engineer handoff helpers used by presence, holiday, seasonal, and infrastructure routines. - Templates (
custom_templates/) – Shared Jinja macros and speech briefings used by scripts, automations, and dashboards. - Dashboards (
dashboards/) – YAML-managed Lovelace dashboards, UI resources, and themes, including a phone-first Overview view with large two-column controls. - Static assets (
www/) – branding, floorplans, sounds, and holiday and flag-day data. - Custom Sidebar –
www/custom-sidebar-config.yamlplaces Marketplace below Overview and Systems for admins, hides Calendar and Media, and puts Developer Tools at the bottom. Marketplace manages the plugin files underwww/community/custom-sidebar.
Featured automations by section
Nighttime brightness walkthrough: late_night_brightness_guard.yaml
. The public household rule is scoped; the article separately provides a whole-house tutorial example.
| Section | Why start here | Featured automation(s) |
|---|---|---|
| Packages | Self-contained subsystems that highlight patterns like combined alerts + actions. Local package classification: Watch local package detection Local package detection blog. Cloudflare alerts: Watch Cloudflare walkthrough Cloudflare blog guide | alarm.yaml, garadget.yaml, infrastructure.yaml, speedtest.yaml, bgw_gateway.yaml, frigate_classification.yaml, phynplus.yaml, maintenance_log.yaml, tugtainer_updates.yaml, rachio.yaml, kiosk_tablet.yaml, vacation_mode.yaml, vacuum.yaml, powerwall.yaml, tesla_model_y.yaml Local holidays: holiday.yaml Watch local holiday countdowns Local holiday countdowns blog |
| Automations | Real-world triggers that tie Zwave, MQTT, REST, and Frigate occupancy events into the rest of the house. | driveway_parked_car.yaml, garage_entry_light.yaml, dark_rainy_day.yaml |
| Scripts | Reusable building blocks for lighting, notifications, safety responses, and Joanna/BearClaw remediation dispatch. Colored iOS sender icons: YouTube Blog post | joanna_dispatch.yaml, notify_engine.yaml, speech_engine.yaml |
| Scenes | Seasonal and ambiance presets that the scripts and automations call into. | monthly_colors.yaml, living_room.yaml |
| Templates & Speech | Human-friendly voice briefings and templated responses, including quiet-by-default air-quality warnings with separate Airly CAQI and Pirate Weather US AQI thresholds. | briefing.jinja YouTube Blog post |
| Dashboards & Media | Desktop control-center, mobile quick-access, and purpose-built kiosk views, UI chrome, floorplans, and automation assets. | dashboards, WAN dashboard, Bedroom dashboard, Watch WAN walkthrough, topology diagram Watch holiday dashboard theming Holiday dashboard guide ambient.js |
| Seasonal Audio | Cuckoo clock with Halloween and Christmas sound packs. | CucKoo_Clock.yaml |
The Cloudflare walkthrough connects Cloudflare website alerts to Home Assistant with authenticated webhooks, persistent Repairs, and verified recovery. cloudflare_alerts
.
The gateway walkthrough turns an AT&T BGW210/BGW320 gateway's read-only status pages into a small Docker API, Home Assistant entities, and a Network dashboard card.
. The reusable collector is BGW Probe, and the Home Assistant implementation is
bgw_gateway.yaml. The earlier Tesla tire-pressure, driveway, WAN, mobile-dashboard, air-quality, entity-cleanup, Tugtainer, water-softener, HVAC, Powerwall, leak-detection, kiosk, and LLM Vision walkthroughs remain available in their featured rows.
Gear tied to these automations (affiliate links)
The downstairs Nest schedule and fresh-air reminders are covered in and
.
Hardware linked to the automations below. Older hardware and projects under evaluation are labeled; check the gear catalog for buying notes and walkthroughs.
Affiliate disclosure: Amazon purchase links in this table are paid links. As an Amazon Associate I earn from qualifying purchases.
| Device | What it drives (friendly name -> file) | Buy |
|---|---|---|
| Amazon Fire tablet wall kiosk (older Fire 7) | Bedroom Fully recovery and clock-free night-watch dashboard plus a distinct Kitchen Show clock/forecast, household-alert surface, motion-aware idle dimming, household-aware screen power, and state-driven full-screen Garage/Front Door views - kiosk_tablet.yaml, Bedroom dashboard, Kiosk Satellite preview, YouTube Seasonal dashboard accents: Watch holiday dashboard theming Holiday dashboard guide |
Tablet Mount |
| Garadget garage door controller | Garage doors: open/close, arrival helpers, and nighttime reminders - garadget.yaml, garage_entry_light.yaml, YouTube, Blog post |
Buy |
| August smart lock | Front-door lock status + remote control – august.yaml YouTube |
Buy |
| Amazon Echo Show | Pops up the front doorbell camera when the August lock unlocks – august.yaml YouTube |
Buy |
| Phyn Plus water shutoff | Leak detection + auto shutoff - phynplus.yaml, YouTube, Blog post, Blog post |
Buy |
| Rachio sprinkler controller | Rain-skips, active-zone status, trigger-derived last-run history, and dashboard controls - rachio.yaml, 10_sprinklers.yaml, home_water_sections.yaml, YouTube, Blog post |
Buy |
| Tesla Powerwall 2 | Grid-outage alerts, charging watchdog, and load-shed automations - powerwall.yaml, YouTube, Blog post |
Powerwall at Tesla (manufacturer; examples use Powerwall 2) |
| Google Nest thermostat | Downstairs cooling schedule, presence/Eco and fresh-air suggestions; runtime-based filter reminders for both units and condenser-line cleanout tracking - climate.yaml, hvac_sections.yaml, YouTube Watch Nest schedule Nest schedule guide |
Buy |
| Retired Gen 2 Nest display | Round family-photo gallery, two-minute household alerts, bedtime/away screen policy and guest Wi-Fi QR rotation - kiosk_tablet.yaml Watch Nest upcycling Nest display blog |
Reuses an existing thermostat and USB power adapter. |
| Raspberry Pi 3 + Aeon Z-Wave stick (historical) | Older hardware reference; current garage-entry examples use wired NodeMCU contacts. Check current host and radio support before buying. | Pi Z-Wave |
| Samsung 65-inch TV | Living-room TV used in the Home Assistant dashboard video. The linked 65-inch Samsung model is newer than the Q70 shown; check compatibility. Watch TV dashboard TV dashboard blog | Buy |
| Roku streaming device | TV presence -> scenes/lighting – roku.yaml YouTube Raven idle dashboard: samsung_tv.yaml Watch Roku Dashboard Roku Dashboard blog. |
Buy |
| NFC tags | Phone taps record per-unit HVAC filter changes. YouTube Watch Nest schedule Nest schedule guide - climate.yaml |
Buy |
| Amazon Echo Glow (under evaluation) | Unvalidated bridge experiment for Home Assistant status cues; follow the issue before buying - GitHub issue: 1827 | Buy |
| Dreame L10s Ultra vacuum | Cleaning schedules, room queues, Alexa room cleans, and rescue notifications - vacuum.yaml, YouTube, Blog post Rescue icon styling: Notification icon tip Notification icon guide |
Buy |
| Flux/LED strip controller | Monthly color scenes for exterior – monthly_color_scene.yaml |
Buy |
| Etekcity/433MHz outlet | Accent lighting relays – kitchen_lights_and_accents.yaml |
Buy |
Camera-verified garbage reminders
Separate garbage and recycling classifiers feed the existing garage-opening reminders. See Frigate state adapters, garage reminder automation, and training and behavior notes.
Tips for re-use
- Copy a package folder and adjust entity IDs in one place instead of hunting through automations.
- Use the scripts and scenes as examples of how to break complicated flows into composable blocks.
- The
www/assets are ideal references when building your own Lovelace floorplans or dashboards.
All of my configuration files are tested against the most stable version of home-assistant.

