This is a script to demonstrate the pywemo reset and setup functionality as well as extend it with some additional functionality such as multiple device reset and setup. The script should work on Linux, macOS, and Windows, although some of the functionality is only currently supported on Linux.
Starting in May of 2020, Belkin started requiring users to create an account and login to the app (Android app version 1.25). In addition to the account, most of the app functionality now requires a connection to the cloud (internet access), even for simple actions such as toggling a switch. All of the commands that go through the cloud are encrypted and cannot be easily inspected. This raises the possibility that Belkin could, in the future, update Wemo device firmware and make breaking API changes that can not longer be deciphered. If this happens, pywemo may no longer function on that device. It would be prudent to upgrade firmware cautiously and preferably only after confirming that breaking API changes have not been introduced.
The following commands can be used to setup a virtual environment for this script and install the required libraries.
Linux:
python3 -m venv .venv
source .venv/bin/activate
python3 -m pip install -r requirements.txtWindows:
py -3 -m venv .venv
.venv/Scripts/activate.bat
python -m pip install -r requirements.txtThe virtual environment should then be activated when running this script.
OpenSSL is used to encrypt the password by the pywemo library (AES only).
It should be installed and available on the path via openssl.
This is not required if connecting to an open network (not recommended).
The command line interface to NetworkManager, nmcli, is used with the --setup-all option to search for and connect to Wemo device access points.
This functionality exists in other OSes, but has not been implemented and tested.
For example, airport in macOS and netsh in Windows should be able to achieve this, as well as other Linux tools for installations without NetworkManager.
Coming soon
Beware when using the --reset-all option when connected to multiple networks, e.g. if hardwired to a local lan and wirelessly connected to another network.
The pywemo discovery will find devices on all connected networks and this script when then attempt to reset them all.
This script shows a list of the devices to be reset and asks for confirmation, so reviewing this list is recommended.
- You can use
-vvvto enable all debug log message and send the log to file. This can be useful to associate the friendly names with each device if you intend to set them up again. - After reset, a device will take up to 90 seconds to reset, so wait a minute or two before trying to setup a freshly reset device.
- Wemo devices sometimes have trouble connecting to an access point that uses the same name (SSID) for the 2.4GHz and 5GHz signals. If you experience issues, try disabling the 5GHz signal while setting up the Wemo device(S), and then re-enabling it upon completion.
- If having issues with reset or setup, be sure to enable verbose output to see debug logs.
This script has been tested and confirmed working with the follow devices and firmware:
| Device Type | Market | FirmwareVersion |
|---|---|---|
| Socket (Mini) | US | WeMo_WW_2.00.11452.PVT-OWRT-SNSV2 |
| Lightswitch | US | WeMo_WW_2.00.11408.PVT-OWRT-LS |
| Dimmer | US | WeMo_WW_2.00.11453.PVT-OWRT-Dimmer |
| Insight Switch | UK | WeMo_WW_2.00.11483.PVT-OWRT-Insight |
| Switch | UK | WeMo_WW_2.00.11408.PVT-OWRT-SNS |
| Maker | UK | WeMo_WW_2.00.11423.PVT-OWRT-Maker |
Be sure to also install the dev dependencies to the virtual environment from the requirements.dev.txt file.
All code should be formatted using black with the provided pyproject.toml and cleanly pass pylint and pycodestyle