This repository contains my personal Home Assistant configuration for automating and monitoring my smart home environment. It covers lights, sensors, automations, integrations, and more.
Quick reference to all documentation in this repository, sorted by category.
| Document | Description | Last Updated |
|---|---|---|
| README.md | This file β project overview and navigation | 2026-04-01 |
| INSTALL.md | Installation and setup instructions | 2026-04-01 |
| hardware.md | Complete hardware inventory by manufacturer | 2026-04-01 |
| statistics.md | Entity counts and system statistics | 2026-04-01 |
| Category | Document | Description | Last Updated |
|---|---|---|---|
| Packages | packages/README.md | Package architecture and organization | 2026-04-01 |
| Rooms | packages/rooms/README.md | Room-based configuration overview | 2026-04-01 |
| Integrations | packages/integrations/README.md | Integration packages overview | 2026-04-01 |
| Room | README | Setup Guide | Last Updated |
|---|---|---|---|
| Attic | README | β | 2026-03-29 |
| Back Garden | README | β | 2026-03-29 |
| Bathroom | README | β | 2026-03-29 |
| Bedroom | README | SETUP | 2026-04-01 |
| Bedroom 2 | README | β | 2026-03-29 |
| Bedroom 3 | README | β | 2026-03-29 |
| Conservatory | README | β | 2026-04-01 |
| Front Garden | README | β | 2026-03-29 |
| Kitchen | README | SETUP | 2026-04-01 |
| Living Room | README | SETUP | 2026-04-01 |
| Office | README | SETUP | 2026-04-01 |
| Porch | README | SETUP | 2026-04-01 |
| Stairs | README | SETUP | 2026-04-01 |
| Utility | README | β | 2026-03-31 |
| Integration | Document | Description | Last Updated |
|---|---|---|---|
| Energy (Core) | README | Solar, battery, grid monitoring | 2026-04-01 |
| Octopus Energy | README | Agile tariff integration | 2026-04-01 |
| Predbat | README | Battery optimization | 2026-04-01 |
| Solcast | README | Solar forecasting | 2026-04-01 |
| Solar Assistant | README | Inverter monitoring | 2026-04-01 |
| Zappi | README | EV charger integration | 2026-04-01 |
| Alarm | README | House alarm system | 2026-04-01 |
| HVAC | README | Heating and climate control | 2026-04-01 |
| Messaging | README | Notifications (Slack, Discord, Telegram) | 2026-04-01 |
| Transport | README | Tesla/TeslaMate integration | 2026-04-01 |
| Google Travel | README | Travel time estimates | 2026-04-01 |
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.
I have 7,191 states in Home Assistant. More details here.
More details here.
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:
More details here.
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.
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.
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.
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
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.