mirror of
https://github.com/CCOSTAN/Home-AssistantConfig.git
synced 2026-04-23 08:37:26 +00:00
7464db41f4
- Updated proxmox.yaml to include state_class for disk usage sensors and improved availability checks. - Modified space.yaml to add state_class for the Earth distance sensor. - Enhanced stats.yaml with state_class for various command line sensors and template sensors to support long-term trend rollups. - Updated recorder.yaml to refine notes and exclude additional MariaDB snapshot sensors from recording. - Revised README.md in scripts to correct package paths and add a new monthly log hygiene review automation. - Introduced infrastructure.yaml for comprehensive observability and monitoring of WAN, DNS, and website states, including automated repairs for uptime breaches. - Added mariadb_snapshot.py script to collect telemetry snapshots for MariaDB, supporting Home Assistant command line sensors.
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 |
| alexa_media_player.yaml | 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 |
| 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 using stable configured monitor membership, 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 |
| github_watched_repo_scout.yaml | Nightly Joanna dispatch that reviews unread notifications from watched GitHub repos, recommends HA-config ideas, refreshes strong-candidate issues, and marks processed watched-repo notifications read. | automation.github_watched_repo_scout_nightly, script.joanna_dispatch, script.send_to_logbook |
| proxmox.yaml | Proxmox runtime and disk pressure monitoring with Repairs + Joanna dispatch for sustained node degradations, plus nightly Frigate reboot. | binary_sensor.proxmox*_runtime_healthy, sensor.proxmox*_disk_used_percentage, repairs.create, script.joanna_dispatch, button.qemu_docker2_101_reboot |
| synology_dsm.yaml | Synology DSM integration health normalization for Carlo-NAS01 and Carlo-NVR, with Repairs + Joanna dispatch on sustained integration, security, or storage problems. | binary_sensor.carlo_*_synology_problem, sensor.carlo_*_synology_problem_summary, repairs.create, script.joanna_dispatch |
| infrastructure.yaml | Normalized WAN/DNS/backup/domain/cert health + website uptime/latency SLO signals for Infrastructure dashboards, plus nightly backup verification and monthly Joanna HA log hygiene review with GitHub issue follow-up. | binary_sensor.infra_website_uptime_slo_breach, binary_sensor.infra_website_latency_degraded, automation.infra_backup_nightly_verification, automation.infra_monthly_log_hygiene_review, script.joanna_dispatch |
| 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 snapshots with hourly live metrics, weekly admin/recorder polling, and stats-ready numeric sensors. | sensor.mariadb_status, sensor.database_size |
| processmonitor.yaml | 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_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, include LLM-first routing context for freeform text, relay replies back, ingest /api/bearclaw/status telemetry, and expose dispatch plus QMD/memory-index sensors for Infrastructure dashboards. |
rest_command.bearclaw_*, sensor.bearclaw_status_telemetry, sensor.joanna_*, binary_sensor.joanna_*, automation.bearclaw_*, script.send_to_logbook |
| telegram_bot.yaml | 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 |
| 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, push live outage tracking to mobile targets, and shed loads automatically when off-grid (alerts include Activity feed + Repairs). | binary_sensor.powerwall_grid_status, sensor.powerwall_*, script.notify_live_activity, 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 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 |
| 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 daytime targets consistent: away → eco, home + >92°F → 78°F, home default → 80°F. Downstairs bedtime cooling now 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 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.
- 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.
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 :
