Full Configuration

All of these options are configured from the Configuration tab of the Superhome app in Home Assistant. After editing any value, click Save to apply it.

The two basic options are shown at the top of the tab; everything else lives under the collapsed Advanced group.

Basic

Option	Default	Effect
license_key	(empty)	Your SH-XXXX-XXXX-XXXX-XXXX license key.
rtsp_url	(empty)	RTSP stream of your camera, e.g. rtsp://user:pass@192.168.1.50:554/stream1.

Timing & sensitivity

Option	Default	Effect
confidence_threshold	0.6	Minimum model confidence to register a palm gesture (0 to 1). Lower is more sensitive but more prone to false positives.
selection_confidence_threshold	0.5	Minimum confidence to detect the L-gesture that drives entity selection.
selection_trigger_time	0.5 s	How long to hold the L-gesture before entering selection mode.
selection_entity_switch_time	2 s	How long to hold the gesture before advancing to the next entity in the list.
selection_cache_time	1.5 s	How long the selected value is remembered after leaving selection mode.
selection_hysteresis_time	2 s	Grace period: how long selection mode stays active after the gesture is briefly lost.
selection_cycle_mode	cyclic	How the entity list cycles: cyclic (1, 2, 3, 1, 2, 3...) or linear.
safety_trigger_threshold	0.3 s	How long an open palm must be held before its action fires. Acts as a safety delay against accidental triggers.
dimmer_interval	0.9 s	Time between brightness steps while you sustain an open palm.
gesture_level_hysteresis_time	2 s	Grace period during brightness control after the gesture is briefly lost.

Camera

Option	Default	Effect
downscale	true	Downscale incoming frames before inference to reduce CPU load.
downscale_factor	2	How much to downscale when downscale is enabled (2 = half resolution).

Cluster

Option	Default	Effect
inference_mode	standalone	standalone runs inference locally on the HAOS host; master-worker offloads it to a worker node. See Master-Worker Cluster.