@homebridge-plugins/homebridge-meross 10.17.0-beta.0 → 10.17.0-beta.2

package/CHANGELOG.md

@@ -7,6 +7,8 @@ All notable changes to `@homebridge-plugins/homebridge-meross` will be documente
 ### Changed
 
 - feat(ui): add, remove and hide devices from the config via the my devices tab
+- style(ui): standardise the custom ui layout and sync the support tab with the readme
+- feat(ui): add a remove all devices action to the my devices tab
 
 ## v10.16.5 (2026-07-18)
 

package/lib/homebridge-ui/public/index.html

@@ -102,6 +102,17 @@
           </button>
         </div>
       </li>
+      <li class="list-group-item">
+        <div class="d-flex justify-content-between align-items-center">
+          <div class="pr-2">
+            <div>Remove All Devices</div>
+            <div class="text-muted action-desc" id="removeAllText">Remove every device from the plugin config.</div>
+          </div>
+          <button type="button" class="btn btn-primary m-0 ml-3 py-1 min-w-50" id="removeAllBtn" aria-label="Remove all devices from the config">
+            <i aria-hidden="true" class="fas fa-arrow-right"></i>
+          </button>
+        </div>
+      </li>
       <li class="list-group-item">
         <div class="d-flex justify-content-between align-items-center">
           <div class="pr-2">
@@ -169,114 +180,61 @@
     </table>
   </div>
 </div>
-<div id="pageSupport" class="mt-4" style="display: none;">
+<div id="pageSupport" class="mt-4" style="display: none">
   <p class="text-center lead">Thank you for using <strong>homebridge-meross</strong></p>
-  <p class="text-center">The links below will take you to our GitHub wiki</p>
-  <h4>Setup</h4>
-  <ul>
-    <li>
-      <a href="https://github.com/homebridge-plugins/homebridge-meross/wiki/Installation" target="_blank"
-        >Installation</a
-      >
-    </li>
-    <li>
-      <a href="https://github.com/homebridge-plugins/homebridge-meross/wiki/Configuration" target="_blank"
-        >Configuration</a
-      >
-    </li>
-    <li>
-      <a href="https://github.com/homebridge/homebridge/wiki/How-to-Install-Alternate-Plugin-Versions" target="_blank"
-        >Beta Version</a
-      >
-    </li>
-    <li>
-      <a href="https://github.com/homebridge-plugins/homebridge-meross/wiki/Node-Version" target="_blank"
-        >Node Version</a
-      >
-    </li>
-  </ul>
-  <h4>Features</h4>
-  <ul>
-    <li>
-      <a href="https://github.com/homebridge-plugins/homebridge-meross/wiki/Supported-Devices" target="_blank"
-        >Supported Devices</a
-      >
-    </li>
-    <li>
-      <a href="https://github.com/homebridge-plugins/homebridge-meross/wiki/Cloud-Control" target="_blank"
-        >Cloud Control</a
-      >
-    </li>
-    <li>
-      <a href="https://github.com/homebridge-plugins/homebridge-meross/wiki/Local-Control" target="_blank"
-        >Local Control</a
-      >
-    </li>
-  </ul>
-  <h4>Help/About</h4>
+  <h5>Plugin Information</h5>
+<ul>
+  <li>This plugin allows you to view and control your Meross devices within HomeKit. The plugin:</li>
   <ul>
-    <li>
-      <a href="https://github.com/homebridge-plugins/homebridge-meross/wiki/Common-Errors" target="_blank"
-        >Common Errors</a
-      >
-    </li>
-    <li>
-      <a href="https://github.com/homebridge-plugins/homebridge-meross/issues/new/choose" target="_blank"
-        >Support Request</a
-      >
-    </li>
-    <li>
-      <a href="https://github.com/homebridge-plugins/homebridge-meross/blob/latest/CHANGELOG.md" target="_blank"
-        >Changelog</a
-      >
-    </li>
-    <li>
-      <a href="https://github.com/sponsors/bwp91" target="_blank">About Me</a>
-    </li>
+    <li>downloads a device list if your Meross credentials are supplied</li>
+    <li>attempts to control your devices locally, reverting to cloud control if necessary</li>
+    <li>listens for real-time device updates when controlled externally</li>
+    <li>supports configuring devices for local-only control without your Meross credentials</li>
+    <li>can ignore any HomeKit-native devices you have using the configuration</li>
   </ul>
-  <h4>Credits</h4>
+</ul>
+  <h5>Prerequisites</h5>
+<ul>
+  <li>To use this plugin, you will need to already have:</li>
   <ul>
-    <li>
-      This is a fork of the work originally done by
-      <a href="https://github.com/Robdel12" target="_blank">@Robdel12</a> and
-      <a href="https://github.com/dylanfrankcom" target="_blank">@dylanfrankcom</a>.
-    </li>
-    <li>
-      To <a href="https://github.com/donavanbecker" target="_blank">@donavanbecker</a> the previous
-      maintainer of this plugin.
-    </li>
-    <li>
-      To <a href="https://github.com/Apollon77" target="_blank">@Apollon77</a> and
-      <a href="https://github.com/colthreepv" target="_blank">@colthreepv</a> for the
-      <a href="https://github.com/Apollon77/meross-cloud" target="_blank">meross-cloud</a> library
-      (contained in this plugin).
-    </li>
-    <li>
-      To the creator of the awesome plugin header logo:
-      <a href="https://www.instagram.com/keryan.me" target="_blank">Keryan Belahcene</a>.
-    </li>
-    <li>
-      To the creators/contributors of
-      <a href="https://github.com/simont77/fakegato-history" target="_blank">Fakegato</a>:
-      <a href="https://github.com/simont77" target="_blank">@simont77</a> and
-      <a href="https://github.com/NorthernMan54" target="_blank">@NorthernMan54</a>.
-    </li>
-    <li>
-      To the creators/contributors of
-      <a href="https://homebridge.io" target="_blank">Homebridge</a> who make this plugin possible.
-    </li>
-  </ul>
-
-  <h4>Disclaimer</h4>
-  <ul>
-    <li>
-      I am in no way affiliated with Meross and this plugin is a personal project that I maintain in
-      my free time.
-    </li>
-    <li>
-      Use this plugin entirely at your own risk - please see licence for more information.
-    </li>
+    <li><a href="https://nodejs.org" target="_blank">Node</a>: latest version of <code>v22</code> or <code>v24</code> - any other major version is not supported.</li>
+    <li><a href="https://homebridge.io" target="_blank">Homebridge</a>: <code>v1.6</code> or above - refer to link for more information and installation instructions.</li>
   </ul>
+</ul>
+  <h5>Setup</h5>
+<ul>
+  <li><a href="https://github.com/homebridge-plugins/homebridge-meross/wiki/Installation" target="_blank">Installation</a></li>
+  <li><a href="https://github.com/homebridge-plugins/homebridge-meross/wiki/Configuration" target="_blank">Configuration</a></li>
+  <li><a href="https://github.com/homebridge-plugins/homebridge-meross/wiki/Beta-Version" target="_blank">Beta Version</a></li>
+  <li><a href="https://github.com/homebridge-plugins/homebridge-meross/wiki/Node-Version" target="_blank">Node Version</a></li>
+</ul>
+  <h5>Features</h5>
+<ul>
+  <li><a href="https://github.com/homebridge-plugins/homebridge-meross/wiki/Supported-Devices" target="_blank">Supported Devices</a></li>
+  <li><a href="https://github.com/homebridge-plugins/homebridge-meross/wiki/Cloud-Control" target="_blank">Cloud Control</a></li>
+  <li><a href="https://github.com/homebridge-plugins/homebridge-meross/wiki/Local-Control" target="_blank">Local Control</a></li>
+</ul>
+  <h5>Help/About</h5>
+<ul>
+  <li><a href="https://github.com/homebridge-plugins/homebridge-meross/wiki/Common-Errors" target="_blank">Common Errors</a></li>
+  <li><a href="https://github.com/homebridge-plugins/homebridge-meross/issues/new/choose" target="_blank">Support Request</a></li>
+  <li><a href="https://github.com/homebridge-plugins/homebridge-meross/blob/latest/CHANGELOG.md" target="_blank">Changelog</a></li>
+  <li><a href="https://github.com/sponsors/bwp91" target="_blank">About Me</a></li>
+</ul>
+  <h5>Credits</h5>
+<ul>
+  <li>This is a fork of the work originally done by <a href="https://github.com/Robdel12" target="_blank">@Robdel12</a> and <a href="https://github.com/dylanfrankcom" target="_blank">@dylanfrankcom</a>.</li>
+  <li>To <a href="https://github.com/donavanbecker" target="_blank">@donavanbecker</a> the previous maintainer of this plugin.</li>
+  <li>To <a href="https://github.com/Apollon77" target="_blank">@Apollon77</a> and <a href="https://github.com/colthreepv" target="_blank">@colthreepv</a> for the <a href="https://github.com/Apollon77/meross-cloud" target="_blank">meross-cloud</a> library (contained in this plugin).</li>
+  <li>To the creator of the awesome plugin header logo: <a href="https://www.instagram.com/keryan.me" target="_blank">Keryan Belahcene</a>.</li>
+  <li>To the creators/contributors of <a href="https://github.com/simont77/fakegato-history" target="_blank">Fakegato</a>: <a href="https://github.com/simont77" target="_blank">@simont77</a> and <a href="https://github.com/NorthernMan54" target="_blank">@NorthernMan54</a>.</li>
+  <li>To the creators/contributors of <a href="https://homebridge.io" target="_blank">Homebridge</a> who make this plugin possible.</li>
+</ul>
+  <h5>Disclaimer</h5>
+<ul>
+  <li>I am in no way affiliated with Meross and this plugin is a personal project that I maintain in my free time.</li>
+  <li>Use this plugin entirely at your own risk - please see licence for more information.</li>
+</ul>
 </div>
 <script>
   ;(async () => {
@@ -302,6 +260,7 @@
       ]
       let pickerAccessories = []
       let removeConfirmTimer
+      let removeAllConfirmTimer
 
       // The action buttons always show the settings-page arrow; the row text
       // (and the button's aria-label) says what the arrow will do
@@ -523,6 +482,58 @@
           homebridge.toast.error(err.message, 'Error')
         }
       })
+      const resetRemoveAllButton = () => {
+        const btn = document.getElementById('removeAllBtn')
+        clearTimeout(removeAllConfirmTimer)
+        delete btn.dataset.confirm
+        btn.classList.remove('btn-danger')
+        btn.classList.add('btn-primary')
+        btn.innerHTML = actionArrow
+        btn.setAttribute('aria-label', 'Remove all devices from the config')
+        document.getElementById('removeAllText').innerHTML = 'Remove every device from the plugin config.'
+      }
+
+      document.getElementById('removeAllBtn').addEventListener('click', async () => {
+        try {
+          const btn = document.getElementById('removeAllBtn')
+          const blocks = await getConfigBlocks()
+          const config = blocks[0]
+          let total = 0
+          deviceArrays.forEach((key) => {
+            if (Array.isArray(config[key])) {
+              total += config[key].length
+            }
+          })
+          if (total === 0) {
+            resetRemoveAllButton()
+            homebridge.toast.info('There are no devices in the config.', 'Nothing To Remove')
+            return
+          }
+          if (btn.dataset.confirm !== 'yes') {
+            // Removing everything always asks for a second click, since any
+            // settings on the entries would be lost
+            btn.dataset.confirm = 'yes'
+            btn.classList.remove('btn-primary')
+            btn.classList.add('btn-danger')
+            btn.innerHTML = actionArrow
+            btn.setAttribute('aria-label', 'Confirm removing all devices from the config')
+            document.getElementById('removeAllText').innerHTML = 'Any settings on these entries will be lost. Click again to remove all ' + total + (total === 1 ? ' entry.' : ' entries.')
+            removeAllConfirmTimer = setTimeout(resetRemoveAllButton, 5000)
+            return
+          }
+          deviceArrays.forEach((key) => {
+            delete config[key]
+          })
+          await homebridge.updatePluginConfig(blocks)
+          resetRemoveAllButton()
+          setConfigButton(false)
+          setHideControl(false)
+          homebridge.toast.success(total + ' device entr' + (total === 1 ? 'y' : 'ies') + ' removed - press Save to apply.', 'Removed From Config')
+        } catch (err) {
+          homebridge.toast.error(err.message, 'Error')
+        }
+      })
+
       // ===== End device picker =====
 
       showIntro = () => {

package/package.json

@@ -2,7 +2,7 @@
   "name": "@homebridge-plugins/homebridge-meross",
   "alias": "Meross",
   "type": "module",
-  "version": "10.17.0-beta.0",
+  "version": "10.17.0-beta.2",
   "description": "Homebridge plugin to integrate Meross devices into HomeKit.",
   "author": {
     "name": "bwp91",