TopoMation: beta custom integration for occupancy-driven whole-home automation

I’ve been working on a Home Assistant custom integration called TopoMation.

It started as a way to manage occupancy automation across my home and cabin without maintaining a pile of per-room automations by hand. The basic idea is that Home Assistant’s floors and areas are useful, but real homes often need a deeper model: property, building, grounds, floors, rooms, subareas, open-plan spaces, and devices that belong to something larger than a single room.

TopoMation adds a real location hierarchy on top of Home Assistant floors and areas. Each level gets its own occupancy entity, so things like “is anyone home,” “is anyone upstairs,” or “is anyone outside” become normal HA binary sensors you can use in automations. It can also generate normal Home Assistant automations for common occupancy-driven workflows: lighting, fans/switches, media players, some HVAC fan workflows, and vacuums.

I’m sharing it as a beta, not as a polished product. It runs in my installations every day and has a decent test suite, but it has not had any outside installs yet. It also touches a lot of Home Assistant surface area: areas, floors, entities, services, custom panels, and automation creation. Home Assistant setups vary a lot, so I can’t realistically predict every combination of versions, device integrations, entity models, browsers, and household layouts.

If you like trying custom integrations, are comfortable reading HA logs, and can start with one room before modeling your whole house, I’d love feedback.

A few expectations up front:

  • This is a one-person project.
  • Please back up your HA config before trying it.
  • Start small: one room, one occupancy source, one light, one rule.
  • It is not meant to replace the full Home Assistant automation editor.
  • It is not a support-backed or turnkey product yet.
  • If you want something polished and low-risk, this probably is not that yet.

GitHub repo and README:

Please report bugs, install problems, automation behavior issues, and feature ideas on GitHub Issues:

I don't monitor this forum thread closely, so GitHub Issues are the best place for anything you want me to actually see and track.

1 Like