Jeha

Run it

jeha init connects to Zigbee2MQTT, discovers your groups and devices, and writes a starter config you can edit.

docker run --rm -v $(pwd):/out vpetersson/jeha:latest \
  init --mqtt <mqtt-host>:1883 --output /out/config.toml

docker run -d --name jeha --restart unless-stopped \
  -v $(pwd)/config.toml:/config.toml \
  vpetersson/jeha:latest

New Zigbee2MQTT groups with lights in them get appended to the config automatically. Restart or send SIGHUP to pick them up. A bad config on reload is rejected and the old one keeps running.

The curve

Circadian is a cosine interpolation between three points: wake, midday and sleep. The defaults run 06:00 to 23:00, from 2700K up to 4000K and back down to 2200K. Set curve to linear if you would rather it ramp evenly. Transitions run over 30 seconds, so you never catch it moving.

[circadian.defaults]
wake_time = "06:00"
sleep_time = "23:00"
start_temp_k = 2700
peak_temp_k = 4000
end_temp_k = 2200
curve = "cosine"
transition_secs = 30

Override any of it per room, or set circadian_enabled = false for somewhere it makes no sense, like a porch.

Schedules

Night mode, motion gating and custom automations all share one schedule predicate. Time ranges cross midnight, and day and month filters combine with them.

[rooms.bedroom.night_mode]
schedule = { after = "22:00", before = "06:30" }

[rooms.office]
z2m_group = "Office"
motion_sensor = "0x00158d000AAAAAAA"
motion_schedule = { after = "08:00", before = "17:00", days = ["mon", "tue", "wed", "thu", "fri"] }

An API instead of a dashboard

There is no web UI. Jeha exposes a REST API on port 8420, which is the thing you point a script, a shortcut or an assistant at. Asking a room for the relax scene returns what it did and why:

{
  "room": "kitchen",
  "scene": "relax",
  "brightness": 150,
  "color_temp_k": 2700,
  "description": "kitchen: relax - Relaxed - dimmer, warm white. Circadian paused. Use resume_circadian to go back to automatic.",
  "status": "ok"
}

Rooms, circadian pause and resume, snooze, night mode, Zigbee2MQTT scene recall and a system health endpoint are all there.

Remotes

Zigbee2MQTT remote actions map onto built-in behaviour with no configuration: add the remote’s address to a room’s remotes list and toggle, dim, hold-to-dim and night mode all work. Tested against IKEA STYRBAR, TRADFRI and RODRET, Philips Hue dimmers and the Smart button, Aqara Mini, Sonoff SNZB-01 and Tuya TS004F.