mirror of
https://github.com/CCOSTAN/Home-AssistantConfig.git
synced 2025-11-30 18:11:45 +00:00
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 |
| phynplus.yaml | Tie the Phyn Plus smart shutoff into HA notifications, automations, and valve overrides. | valve.phyn_shutoff_valve, binary_sensor.phyn_leak_test_running, script.notify_engine_two_button |
| powerwall.yaml | Track Tesla Powerwall grid status and shed loads automatically when off-grid. | binary_sensor.powerwall_grid_status, sensor.powerwall_*, script.notify_engine |
| vacuum.yaml | Dreame (ex-Neato) vacuum orchestration with maintenance reminders and reset helpers. | sensor.l10s_vacuum_task_status, sensor.l10s_vacuum_sensor_dirty_left, button.l10s_vacuum_reset_sensor |
| 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 |
| 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.

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 |
| 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.

