@homebridge-plugins/homebridge-wemo 7.6.0-beta.0 → 7.6.0-beta.2

package/CHANGELOG.md

@@ -7,6 +7,8 @@ All notable changes to `@homebridge-plugins/homebridge-wemo` will be documented
 ### 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
 
 ## v7.5.3 (2026-07-18)
 

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

@@ -92,6 +92,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">
@@ -162,100 +173,63 @@
     </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-wemo</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-wemo/wiki/Installation" target="_blank"
-        >Installation</a
-      >
-    </li>
-    <li>
-      <a href="https://github.com/homebridge-plugins/homebridge-wemo/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-wemo/wiki/Node-Version" target="_blank"
-        >Node Version</a
-      >
-    </li>
-  </ul>
-  <h4>Features</h4>
-  <ul>
-    <li>
-      <a href="https://github.com/homebridge-plugins/homebridge-wemo/wiki/Supported-Devices" target="_blank"
-        >Supported Devices</a
-      >
-    </li>
-  </ul>
-  <h4>Help/About</h4>
-  <ul>
-    <li>
-      <a href="https://github.com/homebridge-plugins/homebridge-wemo/wiki/Common-Errors" target="_blank"
-        >Common Errors</a
-      >
-    </li>
-    <li>
-      <a href="https://github.com/homebridge-plugins/homebridge-wemo/issues/new/choose" target="_blank"
-        >Support Request</a
-      >
-    </li>
-    <li>
-      <a href="https://github.com/homebridge-plugins/homebridge-wemo/blob/latest/CHANGELOG.md" target="_blank"
-        >Changelog</a
-      >
-    </li>
-    <li><a href="https://github.com/sponsors/bwp91" target="_blank">About Me</a></li>
-  </ul>
-  <h4>Credits</h4>
+  <h5>Plugin Information</h5>
+<ul>
+  <li>This plugin allows you to view and control your Wemo devices within HomeKit. The plugin:</li>
   <ul>
-    <li>
-      To the creator of this plugin:
-      <a href="https://github.com/rudders" target="_blank">@rudders</a>, and to
-      <a href="https://github.com/devbobo" target="_blank">@devbobo</a> for his contributions.
-    </li>
-    <li>
-      To the creator of
-      <a href="https://github.com/timonreinhard/wemo-client" target="_blank">wemo-client</a> (which
-      is now contained within this plugin):
-      <a href="https://github.com/timonreinhard" target="_blank">@timonreinhard</a>.
-    </li>
-    <li>
-      To <a href="http://www.hardill.me.uk/wordpress/tag/wemo/" target="_blank">Ben Hardill</a> for
-      his research on Wemo devices.
-    </li>
-    <li>To all users who have helped/tested to enable functionality for new devices.</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 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://homebridge.io" target="_blank">Homebridge</a> who make this plugin possible.
-    </li>
+    <li>does not require your Wemo credentials as uses local network discovery (SSDP) and local control</li>
+    <li>will attempt to control your devices via a local HTTP request</li>
+    <li>will attempt to establish a UPnP connection to your devices to listen for external changes (if disabled, HTTP polling is used)</li>
   </ul>
-  <h4>Disclaimer</h4>
+</ul>
+  <p>&gt; [!NOTE]</p>
+  <p>&gt; This plugin does not use the Wemo cloud service - it is designed to work entirely on your local network.</p>
+  <p>&gt; This means that the plugin should continue to work after the Wemo cloud service is discontinued.</p>
+  <p>&gt; See <a href="https://github.com/homebridge-plugins/homebridge-wemo/issues/203" target="_blank">issue #203</a> for more information.</p>
+  <h5>Prerequisites</h5>
+<ul>
+  <li>To use this plugin, you will need to already have:</li>
   <ul>
-    <li>
-      I am in no way affiliated with Belkin/Wemo 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>
+    <li>For the UPnP connection, make sure your Homebridge instance has an allocated IP from the same IP network or VLAN as your Wemo devices. Otherwise, you should disable the UPnP connection to avoid connection errors.</li>
   </ul>
+</ul>
+  <h5>Setup</h5>
+<ul>
+  <li><a href="https://github.com/homebridge-plugins/homebridge-wemo/wiki/Installation" target="_blank">Installation</a></li>
+  <li><a href="https://github.com/homebridge-plugins/homebridge-wemo/wiki/Configuration" target="_blank">Configuration</a></li>
+  <li><a href="https://github.com/homebridge-plugins/homebridge-wemo/wiki/Beta-Version" target="_blank">Beta Version</a></li>
+  <li><a href="https://github.com/homebridge-plugins/homebridge-wemo/wiki/Node-Version" target="_blank">Node Version</a></li>
+</ul>
+  <h5>Features</h5>
+<ul>
+  <li><a href="https://github.com/homebridge-plugins/homebridge-wemo/wiki/Supported-Devices" target="_blank">Supported Devices</a></li>
+</ul>
+  <h5>Help/About</h5>
+<ul>
+  <li><a href="https://github.com/homebridge-plugins/homebridge-wemo/wiki/Common-Errors" target="_blank">Common Errors</a></li>
+  <li><a href="https://github.com/homebridge-plugins/homebridge-wemo/issues/new/choose" target="_blank">Support Request</a></li>
+  <li><a href="https://github.com/homebridge-plugins/homebridge-wemo/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>To the creator of this plugin: <a href="https://github.com/rudders" target="_blank">@rudders</a>, and to <a href="https://github.com/devbobo" target="_blank">@devbobo</a> for his contributions.</li>
+  <li>To the creator of <a href="https://github.com/timonreinhard/wemo-client" target="_blank">wemo-client</a> (which is now contained within this plugin): <a href="https://github.com/timonreinhard" target="_blank">@timonreinhard</a>.</li>
+  <li>To <a href="http://www.hardill.me.uk/wordpress/tag/wemo/" target="_blank">Ben Hardill</a> for his research on Wemo devices.</li>
+  <li>To all users who have helped/tested to enable functionality for new devices.</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 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://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 Belkin/Wemo 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 () => {
@@ -291,6 +265,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
@@ -497,6 +472,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-wemo",
   "alias": "Wemo",
   "type": "module",
-  "version": "7.6.0-beta.0",
+  "version": "7.6.0-beta.2",
   "description": "Homebridge plugin to integrate Wemo devices into HomeKit.",
   "author": {
     "name": "bwp91",