Inspection Commands
Table of contents
- List controls
- Get control state
- Control info
- Watch state changes
- Stream real-time changes
- Conditional checks
- Rooms & Categories
- Sensors
- Energy
- Weather
- Statistics & History
- Autopilot rules
List controls
lox ls # all controls
lox ls -t Jalousie # filter by type
lox ls -r "Wohnzimmer" # filter by room
lox ls -c "Beleuchtung" # filter by category
lox ls -f # only favorites
lox ls --values # include live values (slower)
lox ls -o json # JSON output
| Flag | Description |
|---|---|
-t, --type | Filter by control type |
-r, --room | Filter by room name |
-c, --cat | Filter by category |
-f, --favorites | Only show favorites |
--values | Include live state values (requires one HTTP request per control) |
Get control state
lox get "Licht Wohnzimmer"
lox get "Temperatur" --room "Schlafzimmer"
lox get "Temperatur [OG Kinderzimmer]"
Returns all state outputs for the control.
Control info
lox info "Licht Wohnzimmer"
Shows detailed information: sub-controls, all state keys, moods (for light controllers), flags, and type metadata.
Watch state changes
Poll a control’s state and print changes:
lox watch "Temperatur"
lox watch "Temperatur" -i 5 # poll every 5 seconds
| Flag | Description |
|---|---|
-i, --interval | Poll interval in seconds (default: 2) |
Press Ctrl+C to stop.
Stream real-time changes
Stream state changes via WebSocket (more efficient than polling):
lox stream # stream all changes
lox stream --room "Kitchen" # filter by room
lox stream --type LightControllerV2 # filter by type
lox stream --control "Kitchen Light" # filter by control name
lox stream --initial # include initial state snapshot
lox stream -o json # NDJSON output
| Flag | Description |
|---|---|
-t, --type | Filter by control type |
-r, --room | Filter by room |
-c, --control | Filter by control name |
--initial | Include initial state snapshot |
Conditional checks
Check a control’s state value. Returns exit code 0 (true) or 1 (false):
lox if "Temperatur Aussen" gt 25
lox if "Schalter" eq 1 && lox on "Licht"
Operators: eq, ne, gt, ge, lt, le
Useful for scripting conditional automation:
# Close blinds if temperature exceeds 28
lox if "Temperatur Aussen" gt 28 && lox blind "Beschattung Sud" pos 70
Rooms & Categories
lox rooms # list all rooms
lox categories # list all categories
lox globals # global states (operating mode, sunrise, etc.)
lox modes # operating modes
Sensors
lox sensors # all sensor readings
lox sensors --type temperature # temperature sensors only
lox sensors --type door-window # door/window sensors
lox sensors --type motion # motion sensors
lox sensors --type smoke # smoke detectors
lox sensors -r "Wohnzimmer" # filter by room
Energy
lox energy # show energy meter readings
lox energy -r "Keller" # filter by room
Weather
lox weather # current weather data
lox weather --forecast # 7-day forecast
Statistics & History
lox stats # controls with statistics enabled
lox history "Temperatur" --month 2025-01
lox history "Temperatur" --day 2025-01-15
lox history "Temperatur" -o csv # CSV output for spreadsheets
Autopilot rules
lox autopilot ls # list all automatic rules
lox autopilot state "Rule Name" # show when a rule last fired