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

package/CHANGELOG.md

@@ -2,6 +2,12 @@
 
 All notable changes to `@homebridge-plugins/homebridge-wemo` will be documented in this file.
 
+## v7.6.0 (Pending Release)
+
+### Changed
+
+- feat(ui): add, remove and hide devices from the config via the my devices tab
+
 ## v7.5.3 (2026-07-18)
 
 ### Changed

package/README.md

@@ -1,5 +1,5 @@
 <p align="center">
-   <a href="https://github.com/homebridge-plugins/homebridge-wemo"><img alt="Homebridge Verified" src="https://user-images.githubusercontent.com/43026681/126868557-d0983348-d124-4247-bea9-7dcc62849cdf.png" width="600px"></a>
+   <a href="https://github.com/homebridge-plugins/homebridge-wemo"><img alt="Homebridge Verified" src="https://raw.githubusercontent.com/homebridge-plugins/homebridge-wemo/latest/branding/Homebridge_x_Wemo.png" width="600px"></a>
 </p>
 <span align="center">
 
@@ -39,7 +39,7 @@ Homebridge plugin to integrate Wemo devices into HomeKit
 
 - [Installation](https://github.com/homebridge-plugins/homebridge-wemo/wiki/Installation)
 - [Configuration](https://github.com/homebridge-plugins/homebridge-wemo/wiki/Configuration)
-- [Beta Version](https://github.com/homebridge/homebridge/wiki/How-to-Install-Alternate-Plugin-Versions)
+- [Beta Version](https://github.com/homebridge-plugins/homebridge-wemo/wiki/Beta-Version)
 - [Node Version](https://github.com/homebridge-plugins/homebridge-wemo/wiki/Node-Version)
 
 ### Features

package/config.schema.json

@@ -3,7 +3,7 @@
   "pluginType": "platform",
   "customUi": true,
   "customUiPath": "./lib/homebridge-ui",
-  "headerDisplay": "<p align=\"center\"><img width=\"60%\" src=\"https://user-images.githubusercontent.com/43026681/126868557-d0983348-d124-4247-bea9-7dcc62849cdf.png\"></p><p align=\"center\">For help and support please visit our <a href=\"https://github.com/homebridge-plugins/homebridge-wemo/wiki\">GitHub Wiki</a>. We hope you find this plugin useful!</p>",
+  "headerDisplay": "<p align=\"center\"><img width=\"250px\" src=\"https://raw.githubusercontent.com/homebridge-plugins/homebridge-wemo/latest/branding/Homebridge_x_Wemo.png\"></p><p align=\"center\">For help and support please visit our <a href=\"https://github.com/homebridge-plugins/homebridge-wemo/wiki\">GitHub Wiki</a>. We hope you find this plugin useful!</p>",
   "singular": true,
   "strictValidation": true,
   "schema": {

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

@@ -17,6 +17,22 @@
       color: #eeeeee !important;
       font-weight: 500 !important;
     }
+
+    .list-group-item {
+      background-color: #333333;
+      border-color: #444444;
+      color: #eeeeee;
+    }
+
+    .text-muted {
+      color: #aaaaaa !important;
+    }
+  }
+  .min-w-50 {
+    min-width: 50px;
+  }
+  .action-desc {
+    font-size: 0.85rem;
   }
   select {
     background-image:
@@ -60,11 +76,46 @@
 <div id="pageDevices" class="mt-4" style="display: none;">
   <div id="deviceInfo">
     <form>
-      <div class="form-group">
+      <div class="form-group mb-0">
         <select class="form-control" id="deviceSelect"></select>
       </div>
     </form>
-    <table class="table w-100 mt-3" id="deviceTable" style="display: none;">
+    <ul class="list-group mt-4 mb-4 mx-0" id="configActionList" style="display: none;">
+      <li class="list-group-item">
+        <div class="d-flex justify-content-between align-items-center">
+          <div class="pr-2">
+            <div>Add All Devices</div>
+            <div class="text-muted action-desc">Add all devices to the config that are not already in the config.</div>
+          </div>
+          <button type="button" class="btn btn-primary m-0 ml-3 py-1 min-w-50" id="addAllBtn" aria-label="Add all devices to 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">
+            <div id="deviceConfigTitle">Add This Device</div>
+            <div class="text-muted action-desc" id="deviceConfigText">Add this device to the plugin config.</div>
+          </div>
+          <button type="button" class="btn btn-primary m-0 ml-3 py-1 min-w-50" id="deviceConfigBtn" aria-label="Add this device to 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">
+            <div id="hideDeviceTitle">Hide This Device</div>
+            <div class="text-muted action-desc" id="hideDeviceText">Hide this device from HomeKit. This adds the device to the config if needed.</div>
+          </div>
+          <button type="button" class="btn btn-primary m-0 ml-3 py-1 min-w-50" id="hideDeviceBtn" aria-label="Hide this device from HomeKit">
+            <i aria-hidden="true" class="fas fa-arrow-right"></i>
+          </button>
+        </div>
+      </li>
+    </ul>
+    <table class="table w-100 mt-0" id="deviceTable" style="display: none;">
       <thead>
         <tr class="table-active">
           <th scope="col" style="width: 40%;">Device Name</th>
@@ -210,6 +261,244 @@
   ;(async () => {
     try {
       const currentConfig = await homebridge.getPluginConfig()
+
+      // ===== Device picker (add/remove/hide config entries from the My Devices tab) =====
+      // The control state is always computed from a fresh getPluginConfig() call,
+      // so staged-but-unsaved edits made in the Settings tab are respected
+      const deviceArrays = [
+        'makerTypes',
+        'wemoInsights',
+        'wemoLights',
+        'wemoLinks',
+        'wemoMotions',
+        'wemoOutlets',
+        'wemoOthers',
+      ]
+
+      // Which config array a device belongs in, from its urn device type
+      // (mirrors the platform's own switch). The platform merges every array
+      // into one lookup by serial, so an unknown type is safe in wemoOthers.
+      const urnToArray = {
+        'urn:Belkin:device:bridge:1': 'wemoLinks',
+        'urn:Belkin:device:controllee:1': 'wemoOutlets',
+        'urn:Belkin:device:dimmer:1': 'wemoLights',
+        'urn:Belkin:device:insight:1': 'wemoInsights',
+        'urn:Belkin:device:lightswitch:1': 'wemoOutlets',
+        'urn:Belkin:device:Maker:1': 'makerTypes',
+        'urn:Belkin:device:NetCamSensor:1': 'wemoMotions',
+        'urn:Belkin:device:outdoor:1': 'wemoOutlets',
+        'urn:Belkin:device:sensor:1': 'wemoMotions',
+      }
+      let pickerAccessories = []
+      let removeConfirmTimer
+
+      // The action buttons always show the settings-page arrow; the row text
+      // (and the button's aria-label) says what the arrow will do
+      const actionArrow = '<i aria-hidden="true" class="fas fa-arrow-right"></i>'
+
+      // Compare serial numbers ignoring case and separators, so an entry typed
+      // by hand in a different format still counts as the same device
+      const looseId = id => (id || '').toString().toUpperCase().replace(/[^A-Z0-9]+/g, '')
+
+      const getConfigBlocks = async () => {
+        const blocks = await homebridge.getPluginConfig()
+        if (!blocks.length) {
+          blocks.push({ name: 'Wemo' })
+        }
+        return blocks
+      }
+
+      const findInConfig = (config, serialNumber) => {
+        const target = looseId(serialNumber)
+        for (const key of deviceArrays) {
+          if (Array.isArray(config[key])) {
+            const index = config[key].findIndex(entry => entry && looseId(entry.serialNumber) === target)
+            if (index !== -1) {
+              return { key, index }
+            }
+          }
+        }
+        return null
+      }
+
+      const selectedAccessory = () => {
+        const serial = document.getElementById('deviceSelect').value
+        return pickerAccessories.find(x => x.context.serialNumber === serial)
+      }
+
+      const setHideControl = hidden => {
+        const btn = document.getElementById('hideDeviceBtn')
+        btn.dataset.hidden = hidden ? 'yes' : 'no'
+        btn.innerHTML = actionArrow
+        btn.setAttribute('aria-label', hidden ? 'Show this device in HomeKit' : 'Hide this device from HomeKit')
+        document.getElementById('hideDeviceTitle').innerHTML = hidden ? 'Show This Device' : 'Hide This Device'
+        document.getElementById('hideDeviceText').innerHTML = hidden
+          ? 'Show this device in HomeKit again. The config entry is kept.'
+          : 'Hide this device from HomeKit. This adds the device to the config if needed.'
+      }
+
+      const setConfigButton = inConfig => {
+        const btn = document.getElementById('deviceConfigBtn')
+        clearTimeout(removeConfirmTimer)
+        delete btn.dataset.confirm
+        btn.dataset.state = inConfig ? 'remove' : 'add'
+        btn.classList.remove('btn-danger')
+        btn.classList.add('btn-primary')
+        btn.innerHTML = actionArrow
+        btn.setAttribute('aria-label', inConfig ? 'Remove this device from the config' : 'Add this device to the config')
+        document.getElementById('deviceConfigTitle').innerHTML = inConfig ? 'Remove This Device' : 'Add This Device'
+        document.getElementById('deviceConfigText').innerHTML = inConfig
+          ? 'Remove this device from the plugin config.'
+          : 'Add this device to the plugin config.'
+      }
+
+      const addDeviceToConfig = (config, acc) => {
+        // Link bulbs carry their hub's serial as linkSerialNumber and belong
+        // in wemoLights; anything with an unknown type is safe in wemoOthers
+        const arrayKey = acc.context.linkSerialNumber
+          ? 'wemoLights'
+          : urnToArray[acc.context.deviceType] || 'wemoOthers'
+        if (!Array.isArray(config[arrayKey])) {
+          config[arrayKey] = []
+        }
+        // label is included so the entry is identifiable in the config editor
+        config[arrayKey].push({ label: acc.displayName, serialNumber: acc.context.serialNumber })
+      }
+
+      document.getElementById('deviceConfigBtn').addEventListener('click', async () => {
+        try {
+          const btn = document.getElementById('deviceConfigBtn')
+          const acc = selectedAccessory()
+          if (!acc) {
+            return
+          }
+          const blocks = await getConfigBlocks()
+          const config = blocks[0]
+          const found = findInConfig(config, acc.context.serialNumber)
+          if (btn.dataset.state === 'add') {
+            // The config may have changed since the button was drawn, so
+            // re-check and never add a duplicate - just correct the button
+            if (found) {
+              setConfigButton(true)
+              setHideControl(!!config[found.key][found.index].ignoreDevice)
+              homebridge.toast.info(acc.displayName + ' is already in the config.', 'Not Added')
+              return
+            }
+            addDeviceToConfig(config, acc)
+            await homebridge.updatePluginConfig(blocks)
+            setConfigButton(true)
+            setHideControl(false)
+            homebridge.toast.success(acc.displayName + ' added - press Save to apply.', 'Added To Config')
+          } else {
+            if (!found) {
+              setConfigButton(false)
+              setHideControl(false)
+              homebridge.toast.info(acc.displayName + ' is not in the config.', 'Not Removed')
+              return
+            }
+            const entry = config[found.key][found.index]
+            const extraKeys = Object.keys(entry).filter(k => !['serialNumber', 'label'].includes(k))
+            if (extraKeys.length > 0 && btn.dataset.confirm !== 'yes') {
+              // The entry has settings beyond serial and label which would be
+              // lost, so ask for a second click within five seconds
+              btn.dataset.confirm = 'yes'
+              btn.classList.remove('btn-primary')
+              btn.classList.add('btn-danger')
+              btn.innerHTML = actionArrow
+              btn.setAttribute('aria-label', 'Confirm removing this device from the config')
+              document.getElementById('deviceConfigText').innerHTML = 'This entry has extra settings which will be lost. Click again to remove it.'
+              removeConfirmTimer = setTimeout(() => setConfigButton(true), 5000)
+              return
+            }
+            config[found.key].splice(found.index, 1)
+            if (config[found.key].length === 0) {
+              delete config[found.key]
+            }
+            await homebridge.updatePluginConfig(blocks)
+            setConfigButton(false)
+            setHideControl(false)
+            homebridge.toast.success(acc.displayName + ' removed - press Save to apply.', 'Removed From Config')
+          }
+        } catch (err) {
+          homebridge.toast.error(err.message, 'Error')
+        }
+      })
+
+      document.getElementById('hideDeviceBtn').addEventListener('click', async () => {
+        try {
+          const acc = selectedAccessory()
+          if (!acc) {
+            return
+          }
+          const blocks = await getConfigBlocks()
+          const config = blocks[0]
+          let found = findInConfig(config, acc.context.serialNumber)
+          const currentlyHidden = document.getElementById('hideDeviceBtn').dataset.hidden === 'yes'
+          if (!currentlyHidden) {
+            // Hiding needs a config entry to carry the flag, so create one if
+            // the device is not in the config yet
+            if (!found) {
+              addDeviceToConfig(config, acc)
+              found = findInConfig(config, acc.context.serialNumber)
+            }
+            config[found.key][found.index].ignoreDevice = true
+            await homebridge.updatePluginConfig(blocks)
+            setConfigButton(true)
+            setHideControl(true)
+            homebridge.toast.success(acc.displayName + ' will be hidden from HomeKit - press Save to apply.', 'Device Hidden')
+          } else {
+            if (found) {
+              // Drop the flag rather than storing ignoreDevice false, to keep
+              // the entry clean
+              delete config[found.key][found.index].ignoreDevice
+              await homebridge.updatePluginConfig(blocks)
+            }
+            setConfigButton(!!found)
+            setHideControl(false)
+            homebridge.toast.success(acc.displayName + ' will be shown in HomeKit - press Save to apply.', 'Device Unhidden')
+          }
+        } catch (err) {
+          homebridge.toast.error(err.message, 'Error')
+        }
+      })
+
+      document.getElementById('addAllBtn').addEventListener('click', async () => {
+        try {
+          const blocks = await getConfigBlocks()
+          const config = blocks[0]
+          let added = 0
+          let skipped = 0
+          pickerAccessories.forEach(acc => {
+            if (!acc.context?.serialNumber) {
+              return
+            }
+            if (findInConfig(config, acc.context.serialNumber)) {
+              skipped += 1
+              return
+            }
+            addDeviceToConfig(config, acc)
+            added += 1
+          })
+          if (added > 0) {
+            await homebridge.updatePluginConfig(blocks)
+            homebridge.toast.success(added + ' device(s) added, ' + skipped + ' already in the config - press Save to apply.', 'Added To Config')
+          } else {
+            homebridge.toast.info('All devices are already in the config.', 'Nothing To Add')
+          }
+          const acc = selectedAccessory()
+          if (acc) {
+            const nowFound = findInConfig(config, acc.context.serialNumber)
+            setConfigButton(!!nowFound)
+            if (nowFound) {
+              setHideControl(!!config[nowFound.key][nowFound.index].ignoreDevice)
+            }
+          }
+        } catch (err) {
+          homebridge.toast.error(err.message, 'Error')
+        }
+      })
+      // ===== End device picker =====
+
       showIntro = () => {
         homebridge.disableSaveButton?.()
         const introContinue = document.getElementById('introContinue')
@@ -224,7 +513,9 @@
       }
       showDevices = async () => {
         homebridge.showSpinner()
-        homebridge.disableSaveButton?.()
+        // The save button stays enabled here so entries staged by the picker
+        // buttons can be saved without switching back to the Settings tab
+        homebridge.enableSaveButton?.()
         homebridge.hideSchemaForm()
         document.getElementById('menuHome').classList.remove('btn-elegant')
         document.getElementById('menuHome').classList.add('btn-primary')
@@ -247,6 +538,7 @@
               : 0
           })
         }
+        pickerAccessories = cachedAccessories
         const deviceSelect = document.getElementById('deviceSelect')
         deviceSelect.innerHTML = ''
         cachedAccessories.forEach(a => {
@@ -290,6 +582,11 @@
                 '" style="width: 150px;">'
               : ''
           document.getElementById('deviceTable').style.display = 'inline-table'
+          const configBlocks = await getConfigBlocks()
+          const configEntry = findInConfig(configBlocks[0], context.serialNumber)
+          setConfigButton(!!configEntry)
+          setHideControl(!!(configEntry && configBlocks[0][configEntry.key][configEntry.index].ignoreDevice))
+          document.getElementById('configActionList').style.display = 'block'
           homebridge.hideSpinner()
         }
         deviceSelect.addEventListener('change', event => showDeviceInfo(event.target.value))
@@ -300,6 +597,7 @@
           option.text = 'No Devices'
           deviceSelect.add(option)
           deviceSelect.disabled = true
+          document.getElementById('configActionList').style.display = 'none'
         }
         homebridge.hideSpinner()
       }

package/lib/platform.js

@@ -794,6 +794,9 @@ export default class {
       const context = {
         connection: deviceConf.listenerType ? listenerType : disableUPNP,
         cbURL: device.cbURL,
+        // The urn device type lets the UI device picker place a device in the
+        // right config array
+        deviceType: device.deviceType,
         firmware: device.firmwareVersion,
         hidden: false,
         icon: device.iconList?.icon?.url || false,

package/package.json

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