For Developers
Extend Omnelys with your own logic
A documented local REST API, WebSocket event stream, and Lua scripting engine — all running on hardware inside your home. No cloud dependency. No API rate limits. No terms that change.
API Reference
List all rooms and their current state
Example Response
{
"rooms": [
{
"id": "living-room",
"name": "Living Room",
"devices": 14,
"scene": "evening",
"occupied": true,
"temperature": 21.4,
"lux": 180
}
]
}What You Can Build
A complete local API surface
REST API
Full CRUD over rooms, devices, scenes, automations, and schedules. OpenAPI 3.1 spec included. Local network only — no cloud routing.
WebSocket events
Real-time event stream for all device state changes, scene activations, occupancy events, and system alerts. Subscribe to specific rooms or event types.
Webhooks
Push notifications to external endpoints when events occur. Useful for integrating with other systems, dashboards, or notification services.
Scene automation
Programmatic scene creation and scheduling via the API. Conditions based on time, occupancy, sensor values, or external webhook triggers.
Custom dashboards
The Omnelys controller can serve custom web applications on the local network. Build your own touch panel UI using the REST API.
Lua scripting
Low-level automation scripting in Lua, evaluated locally on the controller. Access to all device states and events. 1ms resolution timers.
Full API documentation is provided to all Omnelys installations
The OpenAPI 3.1 specification, Postman collection, and developer guide are delivered as part of the commissioning package. For pre-sales technical discussions, contact us.
Contact for Technical Enquiries