Summary
The CLI currently only exposes read-only commands (get and debug subgroups). The library itself fully supports equipment control via methods like heater.set_temperature(), pump.set_speed(), light.turn_on(), etc., but there is no way to invoke these operations from the command line.
Motivation
Users who want to script pool control (e.g., cron jobs, home automation integrations, or wrapping the CLI in an HTTP API) currently have to write Python code using the library directly. Adding a set command group to the CLI would make equipment control accessible without any custom code.
Use cases
- Scripting:
omnilogic --host 192.168.1.100 set heater-temp 1 4 82 to set pool heater to 82°F from a shell script
- HTTP wrappers: Lightweight API services that shell out to the CLI for control commands
- Debugging/testing: Quickly toggle equipment during development without writing async Python
Proposed CLI interface
# Heater temperature control
omnilogic set heater-temp <bow_id> <equip_id> <temperature>
omnilogic set solar-temp <bow_id> <equip_id> <temperature>
# Equipment on/off
omnilogic set equipment-on <bow_id> <equip_id>
omnilogic set equipment-off <bow_id> <equip_id>
# Pump/filter speed
omnilogic set speed <bow_id> <equip_id> <percent>
# Light control
omnilogic set light-show <bow_id> <equip_id> <show_id> [--brightness N] [--speed N]
Implementation notes
- The high-level library already has all the primitives:
heater.set_temperature(), pump.set_speed(), light.turn_on(), light.set_show(), etc.
- The CLI already instantiates
OmniLogic and calls refresh() in the entrypoint, so adding a set command group would follow the same pattern as the existing get group.
- Equipment lookup by
bow_id/system_id can use omni.backyard.bow and iterate equipment collections.
Context
I ran into this gap while building a containerized HTTP API wrapper for my OmniLogic system. I ended up importing pyomnilogic_local directly to get temperature control since the CLI had no way to set heater temperatures. Happy to contribute a PR if this aligns with the project direction.
Summary
The CLI currently only exposes read-only commands (
getanddebugsubgroups). The library itself fully supports equipment control via methods likeheater.set_temperature(),pump.set_speed(),light.turn_on(), etc., but there is no way to invoke these operations from the command line.Motivation
Users who want to script pool control (e.g., cron jobs, home automation integrations, or wrapping the CLI in an HTTP API) currently have to write Python code using the library directly. Adding a
setcommand group to the CLI would make equipment control accessible without any custom code.Use cases
omnilogic --host 192.168.1.100 set heater-temp 1 4 82to set pool heater to 82°F from a shell scriptProposed CLI interface
Implementation notes
heater.set_temperature(),pump.set_speed(),light.turn_on(),light.set_show(), etc.OmniLogicand callsrefresh()in the entrypoint, so adding asetcommand group would follow the same pattern as the existinggetgroup.bow_id/system_idcan useomni.backyard.bowand iterate equipment collections.Context
I ran into this gap while building a containerized HTTP API wrapper for my OmniLogic system. I ended up importing
pyomnilogic_localdirectly to get temperature control since the CLI had no way to set heater temperatures. Happy to contribute a PR if this aligns with the project direction.