Architecture overview
reMaestro is a self-hosted .NET control hub: a web app (the hub) that talks to your AV and smart-home gear through a fleet of small, isolated driver processes, with a separate supervisor that can update the hub itself.
The pieces
Section titled “The pieces”- Hub — the control surface and the brain. Owns devices, activities, zones, rules, input routing, the IR database, ESP32 proxy tunnelling, discovery, the optional AI assistant, and the update UI. Hosts every driver.
- Supervisor — a small separate service whose only job is to replace the hub (which the hub can’t do to itself while running). Handles A/B slots, Docker vs systemd vs native deployment, boot confirmation and the rescue page.
- Drivers — 43 small programs, each controlling one kind of device.
- SDK + gRPC — the contract a driver implements, and the wire between hub and driver.
Dig in
Section titled “Dig in”The driver modelWhy drivers run out-of-process, and how one declares its commands and capabilities.
Activities & remotesHow one tap sequences a whole rack, and how custom remotes are built.
Proxies & inputESP32 satellites, and turning any button into an action.
AI assistantOptional, bring-your-own-key help that stays off until you turn it on.