What is Toposync
Toposync is an open source, local-first platform for Spatial Home Automation with local intelligence. It brings cameras, areas, devices, Home Assistant entities, 2D and 3D compositions, and pipelines into one spatial model for private home environments.
The project is built around a simple idea: home automation becomes more useful when events have places, cameras have context, and automations can react to the area where something happened.
What problem it solves
Most home automation and camera systems are organized as lists:
- device lists;
- entity lists;
- camera feeds;
- automation rules;
- event histories;
- notification streams.
Those lists are useful, but they often lose physical context. Toposync adds a mapped layer where a camera, area, event, device, and automation can be understood together.
That helps answer questions like:
- where did it happen?
- which camera saw it?
- which area was affected?
- which nearby device should react?
- should this become a notification, stored image, event history item, or Home Assistant output?
What Toposync is not
Toposync is not a replacement for Home Assistant, RTSP tools, ONVIF utilities, camera dashboards, or certified security systems.
It is also not ready to be the only layer for critical safety, security, access control, or emergency workflows. In the current alpha, treat it as an additional local intelligence and visualization layer that should be tested carefully.
What it includes today
The current alpha focuses on:
- creating a 2D/3D composition of the home;
- adding walls, areas, images, models, cameras, and Home Assistant context;
- mapping camera views into the composition;
- creating camera and vision pipelines;
- producing Spatial Events, notifications, stored images, and Home Assistant outputs;
- delegating heavier camera and vision workloads to processing servers when needed.
The default product path is local-first. The main server, UI, extensions, configuration, files, and pipeline state run in the user's own environment.
When it makes sense
Toposync makes the most sense when:
- you already use Home Assistant and want richer visual context;
- you have IP cameras, RTSP, ONVIF, or PTZ devices;
- you want camera events tied to areas of the home;
- you want local computer vision without depending on one camera vendor;
- you want a central place to experiment with camera, automation, and spatial pipelines;
- you are comfortable testing alpha software in a contained environment.
If you only need a basic camera viewer or a simple device dashboard, Toposync may be more than you need today.