Danny's Home Assistant 🏡

This repository contains my personal Home Assistant configuration for automating and monitoring my smart home environment. It covers lights, sensors, automations, integrations, and more.

Table of Contents

• Introduction
• Documentation Index
• Hardware
• Addons
• Integrations
• GitHub
• Miscellaneous

---

Documentation Index 📚

Quick reference to all documentation in this repository, sorted by category.

Core Documentation

Document	Description	Last Updated
README.md	This file — project overview and navigation	2026-06-14
INSTALL.md	Installation and setup instructions	2026-06-14
hardware.md	Complete hardware inventory by manufacturer	2026-06-14
statistics.md	Live entity counts and system statistics	2026-06-14
setup_statistics.md	YAML package inventory and automation analysis	2026-10-24

Package Documentation

Category	Document	Description	Last Updated
Packages	packages/README.md	Package architecture, current counts, and organization	2026-10-24
Rooms	packages/rooms/README.md	Room-based configuration overview and counts	2026-10-24
Integrations	packages/integrations/README.md	Integration packages overview and counts	2026-10-24

Room Documentation

Room	README	Setup Guide	Last Updated
Attic	README	—	2026-06-14
Back Garden	README	—	2026-06-14
Bathroom	README	—	2026-06-14
Bedroom	README	SETUP	2026-06-14
Bedroom 2	README	—	2026-06-14
Bedroom 3	README	—	2026-06-14
Conservatory	README	—	2026-06-14
Front Garden	README	—	2026-06-14
Kitchen	README	SETUP	2026-06-14
Living Room	README	SETUP	2026-06-14
Office	README	SETUP	2026-06-14
Porch	README	SETUP	2026-06-14
Stairs	README	SETUP	2026-06-14
Utility	README	—	2026-06-14

Integration Documentation

Integration	Document	Description	Last Updated
Energy (Core)	README	Solar, battery, grid monitoring	2026-06-14
Octopus Energy	README	Agile tariff integration	2026-06-14
Predbat	README	Battery optimization	2026-06-14
Solcast	README	Solar forecasting	2026-06-14
Solar Assistant	README	Inverter monitoring	2026-06-14
Zappi	README	EV charger integration	2026-06-14
Alarm	README	House alarm system	2026-06-14
HVAC	README	Heating and climate control	2026-06-14
Messaging	README	Notifications (Discord, Telegram, WhatsApp, mobile, and desktop)	2026-10-24
Transport	README	Tesla/TeslaMate integration	2026-06-14
Google Travel	README	Travel time estimates	2026-06-14

---

Introduction 📢

My ⚽goal with home automation is to never have to think about doing something mentally or physically. This can be turning on a 💡light through to household chores such as 👕washing clothes. Currently, my journey continues.

I have always been interested in technology starting from the x10 days. At the time, I did not have the money or 🧬life experience to use the 💻technology at the time. Fast forward a few 📅decades, I'm fortunate enough to have the means and place to splurge on home automation and Home Assistant is the key to all of this.

This project contains configuration files for Home Assistant used in the House of Tsang 曾)

More details on my 📜website.

⚠️ Note: This configuration is highly specific to my environment. Some parts may not work without adaptation.

Statistics 📊

I have 6,896 states (📈785) in Home Assistant. More details are in statistics.md, and YAML package counts are tracked in setup_statistics.md.

Hardware 🔩

More details here.

Addons ➕

This is not an exhaustive list and it changes quite a lot. Too keep up to date, please subscribe to my blog.

• ESPHome
• Git pull
• Home Assistant Google Drive Backup
• Log Viewer
• Ring Device Integration via MQTT
• Visual Studio Code

Add-ons that I run outside of Home Assistant:

• EMQX
• Grafana
• Zigbee2MQTT

Integrations 🖧

More details here.

GitHub 🐱🐙

This repository contains the configuration files used. It will not contain everything e.g. password (A.K.A secrets.yaml) file as well as other configuration done in the User Interface (UI).

Whilst Home Assistant offer backup solution depending on your install, it is a bit of all or nothing restore process whereas Git (or any versioning system) would allow incremental changes to be stored and reverted where necessary.

The goal is to use the web front end as much as possible and there has been a growing trend to move away from text (YAML) files however the versioning advantage is the reason i still use and store things here.

Setup ⚙️

All changes are performed in the UI where possible and if they are held in configuration files then it will end up in Git where possible.

I use the Visual Studio Code add-on to edit files in Home Assistant or if I really have to the File Editor add-on on my mobile devices.

Visual Studio Code addon includes a Git client so all changes are managed through the text editor.

Workflows 🖇️

The advantage of using a source code management system like Git is the ability to use hooks to trigger actions (as well as other advantages).

I use GitHub actions to verify the changes committed by running it against Home Assistant builds. If successful, Home Assistant will pull down the changes and if the changes are configuration related (as opposed to readme / markdown files) then it will perform another local configuration check and restart to pick up the changes. More details on this can be found here

For this reason, the custom_components is stored in the repository to allow a successful build and configuration check.

Folder Structure 📂

This repository's top level is the /config folder where typically the configuration.yaml file resides. More details can be found here.

I use some of the "advance" configuration options such as split configuration and packages.

packages/               # See README.md in folder
  └── integrations/     # Integration based YAML files
  └── rooms/            # Room based YAML files
blueprints/             # Blueprints for automations
camera/                 # Private directory to hold camera images
esphome/                # Files related to managing the ESP micro controller
lovelace/               # Dashboard configs
scripts/                # Automation scripts
www/                    # A public folder for holding any files such as images that does not need authentication
automations.yaml        # UI automation file
configurations.yaml     # Home Assistant's main configuration file
scene.yaml              # UI scene file
script.yaml             # UI script file

Tags / Releases 🏷️

I will apply a tag around the time of upgrading to a monthly release of Home Assistant. These will represent a snapshot of a (hopefully) stable configuration used prior to upgrading and a point to restore back to if needed. The main branch will contain the latest changes so there is no latest tag.

I encountered issues with branching using VSCode Server add-on in Home Assistant. I was always switching away from a branch so I generally stay away from using this method.