Configuration

⚠️ It is recommended (and easier) to use the Homebridge UI plugin settings screen to configure the plugin. The settings screen is generated from the same source as this page, and always reflects the full, current set of options.

This page is for reference and for users who edit their configuration JSON manually.

Required Settings

Add the following to your configuration file inside the platforms array.

{
   "name": "Lutron",
   "platform": "LutronCasetaLeap"
}

• ⚠️ The "platform": "LutronCasetaLeap" line must not be changed
• No credentials are typed in - use the plugin settings screen to pair with your Lutron Smart Bridge by pressing its physical pairing button, which fills in the secrets (bridge id and certificates) for you.

Optional Settings

Setting	Type	Default	Explanation
enableMatter	boolean	true	When enabled, the plugin will use the Homebridge Matter API to register accessories if it is available.

Options (options)

Setting	Type	Default	Explanation
filterPico	boolean	-	Exclude Pico remotes that are associated with devices directly or in the Lutron app
clickSpeed	string	-	Double- and long-press speed
excludedDeviceTypes	array	[]	Selected device types will not be registered by this plugin in either HAP or Matter mode.
logLevel	string	normal	Controls which plugin log levels are emitted. 'Normal' is the default and what most users want — info is reserved for one-time lifecycle events, per-event noise is at debug. 'Quiet' suppresses info; 'Errors only' suppresses info AND warn. Homebridge's global debug toggle is not affected by this setting.
buttonPressLogging	string	info	How verbose to be about button-press events specifically. 'Info' is the default so presses are visible in normal logs. Use 'Debug' to show presses only with global Homebridge debug enabled. Use 'Silent' to drop them entirely.