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.
Carlo Costanzo
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 |
|---|---|---|
| alarm.yaml | NodeMCU-powered perimeter monitoring with arm/disarm helpers and rich notifications. | binary_sensor.mcu*_gpio*, group.family, notify + siren scripts |
| garadget.yaml | MQTT-based control + status for both garage doors, feeding entry/exit lighting routines. | cover.large_garage_door, cover.small_garage_door, sensor.garadget_reflection |
| august.yaml | Front-door August smart lock with Alexa Show camera pop-up when unlocked. | lock.front_door, media_player actions for front doorbell camera |
| holiday.yaml | REST-driven US holiday + flag sensors that color scenes and exterior lighting. | sensor.holiday, sensor.flag, JSON feed at config/json_data/holidays.json |
| lightning.yaml | Blitzortung lightning counter monitoring with snoozeable push actions. | sensor.blitzortung_lightning_counter, input_boolean.snooze_lightning, notify engine actions |
| logbook_activity_feed.yaml | Dummy sensor.activity_feed + helper to write clean Activity entries (Issue #1550). |
sensor.activity_feed, script.send_to_logbook |
| mariadb_monitoring.yaml | MariaDB health sensors and Lovelace dashboard snippet for recorder stats. | sensor.mariadb_status, sensor.database_size |
| docker_infrastructure.yaml | Docker host patching telemetry + container/stack Repairs automation, 20-minute Joanna escalation for persistent container outages, and weekly scheduled prune actions across docker_10/14/17/69. | sensor.docker_*_apt_status, binary_sensor.*_stack_status, sensor.docker_stacks_down_count, repairs.create, script.joanna_dispatch |
| proxmox.yaml | Proxmox runtime and disk pressure monitoring with Repairs for node degradations plus nightly Frigate reboot. | binary_sensor.proxmox*_runtime_healthy, sensor.proxmox*_disk_used_percentage, repairs.create, button.qemu_docker2_101_reboot |
| infrastructure_observability.yaml | Normalized WAN/DNS/backup/domain/cert health + website uptime/latency SLO signals for Infrastructure dashboards. | binary_sensor.infra_website_uptime_slo_breach, binary_sensor.infra_website_latency_degraded, binary_sensor.infra_* |
| onenote_indexer.yaml | OneNote indexer health/status monitoring for Joanna, failure-repair automation, and a daily duplicate-delete maintenance request. | sensor.onenote_indexer_last_job_status, binary_sensor.onenote_indexer_last_job_successful |
| mqtt_status.yaml | 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.yaml | MariaDB recorder health and capacity SQL sensors. | sensor.mariadb_status, sensor.database_size |
| tugtainer_updates.yaml | Tugtainer container update notifications via webhook + persistent alerts, plus event-based Joanna dispatch when reports include ### Available: (24h cooldown via mode: single + delay, no new helpers). |
persistent_notification.create, event: tugtainer_available_detected, script.joanna_dispatch, input_datetime.tugtainer_last_update |
| bearclaw.yaml | Joanna/BearClaw bridge automations that forward Telegram commands to codex_appliance, relay replies back, ingest /api/bearclaw/status telemetry, and expose dispatch KPI sensors for Infrastructure dashboards. |
rest_command.bearclaw_*, sensor.bearclaw_status_telemetry, sensor.joanna_*, automation.bearclaw_*, script.send_to_logbook |
| telegram_bot.yaml | Telegram script wrappers used by BearClaw and other ops flows (UI integration remains the source for bot config). | script.joanna_send_telegram, telegram_bot.send_message |
| phynplus.yaml | Phyn shutoff automations with push + Activity feed + Repairs issues for leak events. | valve.phyn_shutoff_valve, binary_sensor.phyn_leak_test_running, repairs.create |
| water_delivery.yaml | ReadyRefresh delivery date helper with night-before + garage door Alexa reminders, plus helper-change audit logging and Telegram confirmations. | input_datetime.water_delivery_date, script.send_to_logbook, script.joanna_send_telegram, notify.alexa_media_garage |
| vacation_mode.yaml | Auto-enable vacation mode after 24 hours away or no bed use, track sitter analytics/secure-house checks, and deliver Chromecast-first vacation briefings with a garage Alexa welcome. | input_boolean.vacation_mode, input_boolean.house_sitter_present, sensor.vacation_house_sitter_*, group.garage_doors, lock.front_door, script.notify_engine, script.joanna_send_telegram |
| maintenance_log.yaml | Joanna maintenance webhook ingest for water softener salt with idempotent event handling, Activity feed logging, and recorder-backed helper history for long-term graphing. | automation.maintenance_log_joanna_webhook_ingest, input_number.water_softener_salt_total_added_lb, counter.water_softener_salt_event_count, sensor.water_softener_salt_days_since_last_add |
| powerwall.yaml | Track Tesla Powerwall grid status and shed loads automatically when off-grid (alerts include Activity feed + Repairs). | binary_sensor.powerwall_grid_status, sensor.powerwall_*, repairs.create |
| tesla_model_y.yaml | Remind the garage and parents to plug in the Model Y after low-battery arrivals and after 8 PM when it is home but not charging. | sensor.spaceship_battery_level, switch.spaceship_charge, notify.alexa_media_garage, script.notify_engine |
| vacuum.yaml | 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 |
| hass_agent_homepc.yaml | Mirrors PC lock/unlock state from HASS.Agent to the office lamp for instant desk presence cues. | sensor.carlo_homepc_carlo_homepc_sessionstate, switch.office_lamp_switch |
| sleepiq.yaml | Sleep Number presence/snore automations; Overview Health consumes direct SleepIQ integration entities for scores, vitals, pressure, and bed controls. | sensor.sleepnumber_carlo_carlo_sleep_score, sensor.sleepnumber_carlo_stacey_sleep_score, number.sleepnumber_carlo_carlo_firmness, select.sleepnumber_carlo_foundation_preset_right |
| finance.yaml | Yahoo Finance sensor bundle for portfolio glances and Lovelace cards. | sensor.tsla, sensor.aapl, sensor.amzn, sensor.msft |
Garadget automations
- Logic lives in garadget.yaml: auto-open on arrival, entry helper prompt (unlock front door or open garage), auto-unlock for Paige/Justin, 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.
Nest climate control
- Logic lives in climate.yaml and centralizes downstairs/upstairs Nest schedules, grid-aware guardrails, humidity pulses, and presence/weather-based targets.
- Shared script keeps targets consistent: away → eco, home + >92°F → 78°F, home default → 80°F. Grid-down conditions pause non-essential cool-downs.
Dreame vacuum automations
- Logic lives in vacuum.yaml: 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.
- 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.
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 |
|---|---|---|
| finance.yaml | Custom Yahoo Finance integration overview and setup notes. | Blog |
| garadget.yaml | MQTT garage door setup plus the follow-up on the access token change. | Blog: Integration guide · Blog: Token fix |
| holiday.yaml | How the holiday/flag sensor works and drives lighting playlists. | Blog + video breakdown |
| lightning.yaml | Blitzortung detector wiring, strike alerts, and snooze workflow. | Blog |
| phynplus.yaml | Installing Phyn Plus and wiring its leak events into HA automations. | Blog |
| powerwall.yaml | Monitoring Tesla Powerwall health + what to automate when the grid drops. | Blog |
| vacuum.yaml | Keeping Neato/Dreame bots smart with HA scenes and maintenance timers. | Blog |
| pihole_ha.yaml | Sync Pi-hole blocking state across HA DNS nodes. | |
| grafana.yaml.disabled | Rendering Grafana dashboards to images for Lovelace and social posts. | Blog · Blog · Video |
| august.yaml | Smart lock control and status from HA. | YouTube short |
Hardware referenced in packages (affiliate links)
These are the devices that power the packages above. Affiliate links never change the price but they do help fund more tinkering—thanks!
| Device | Package(s) | Automation tie-in | Buy |
|---|---|---|---|
| Garadget garage door controller | garadget.yaml | MQTT covers feed entry lighting, notifications, and security checks. |  |
| August smart lock | august.yaml | Front-door lock/unlock + status for routines and alerts. |  |
| Amazon Echo Show | Pops up the front doorbell camera when the August lock unlocks. | august.yaml |  |
| Phyn Plus water shutoff | phynplus.yaml | Leak events trigger valve closes + critical push notifications. |  |
| Rachio sprinkler controller | rachio.yaml | Rain skips and seasonal watering adjustments happen automatically. |  |
| Tesla Powerwall 2 | powerwall.yaml | Grid outages kick off load-shed scripts and status pings. |  |
| Google Nest thermostat | climate.yaml | Presence/weather/grid-aware cooling targets, humidity pulses, and eco recovery. |  |
| Dreame/Neato vacuum | vacuum.yaml | Scheduled cleaning, maintenance reminders, and voice callouts. |  |
| NodeMCU motion/contact sensor | alarm.yaml, office_motion.yaml | ESP8266 nodes feed the alarm matrix and room-aware lighting. |  |
| Roku streaming device | roku.yaml | 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 :
