Skip to content
Ben edited this page Jul 21, 2023 · 20 revisions

⚠️ It is recommended (and easier) to use the Homebridge/HOOBS UI plugin settings screen to configure the plugin

Required Settings

Add the following to your configuration file in the appropriate place. The following are the basic required fields.

{
   "name": "Meross",
   "username": "your-meross-username",
   "password": "your-meross-password",
   "userkey": "your-meross-userkey",
   "platform": "Meross"
}
  • ⚠️ The "platform": "Meross" line must not be changed
  • For cloud device control, enter your username and password
  • For local device control, enter your username and password OR your userkey (read more)
  • You can optionally use a base64-encoded version of your password

Optional Settings

Entry Type Default Explanation
ignoreHKNative bool false If true, the plugin will attempt to match known HomeKit native models to your devices and skip them.
disableDeviceLogging bool false Global logging setting for accessory status changes. If true then accessory status changes will not be logged. This can also be set per accessory later in the config.
cloudRefreshRate int 0 Number of seconds between polls to devices using cloud connection. Should not be needed since the plugin supports real-time updates. Must be 30 or more. If 0 is set then a value of 600 will be used.
refreshRate int 5 Number of seconds between polls to local Meross devices. Must be 5 or more. If 0 is set then a value of 600 will be used.
singleDevices array [] Optional settings for single-channel Meross switches and outlets.
See Single Channel Devices for a further explanation about this option and configuration examples.
multiDevices array [] Optional settings for multi-channel Meross switches and outlets.
See Multi Channel Devices for a further explanation about this option and configuration examples.
lightDevices array [] Optional settings for Meross light dimmers/bulbs/strips.
See Light Devices for a further explanation about this option and configuration examples.
diffuserDevices array [] Optional settings for Meross diffuser devices.
See Diffuser Devices for a further explanation about this option and configuration examples.
humidifierDevices array [] Optional settings for Meross humidifier devices.
See Humidifier Devices for a further explanation about this option and configuration examples.
garageDevices array [] Optional settings for Meross garage devices.
See Garage Devices for a further explanation about this option and configuration examples.
rollerDevices array [] Optional settings for Meross rolling motor devices.
See Roller Devices for a further explanation about this option and configuration examples.
babyDevices array [] Optional settings for Meross baby light/sound devices.
See Baby Devices for a further explanation about this option and configuration examples.
sensorDevices array [] Optional settings Meross sensor hubs and subdevices.
See Sensor Devices for a further explanation about this option and configuration examples.