PyWeMoGUI

A simple GUI that lets you manage your Belkin WeMo devices.

Overview

PyWeMoGUI lets you control, setup*, and reset any supported Belkin WeMo devices over the local network. This is useful, for example, to get your WeMos onto your home Wi-Fi network in order to use them with Home Assistant. It also supports acquiring HomeKit setup codes from compatible WeMos, in the case that the WeMo's own HomeKit QR code was lost/damaged/etc.
_{* Requires a computer with Wi-Fi}

PyWeMoGUI does not require an internet connection to get your WeMos up and running thanks to the pywemo library, and will continue to work after Belkin shuts down the WeMo online services and app.

You can download easy-to-run binaries of PyWeMoGUI on the Releases page, currently they are only available for Windows but macOS binaries are planned too.

This README and project are not final, it will improve with time but I wanted to get this project out with the upcoming WeMo server shutdown.

Requirements

• Computer with Wi-Fi
• A relatively recent OS, I used Windows
• Optional: OpenSSL installed and usable as openssl from the commandline
  • Allows setting up WeMos with password protected Wi-Fi networks
  • PyWeMoGUI's utilities tab lets you check your OpenSSL setup
  • Should be pre-installed on macOS and Linux

For development, with manual setup:

• Python 3.10 or newer
  • Pip & Tkinter must be supported

Using PyWeMoGUI

If you set up for running locally with the development instructions, see those instructions first.
If you downloaded the binary from the Releases then just run it like you would any other binary.

After a few seconds the main window should open and say "Autodiscovery in progress" in the list.

After autodiscovery completes, any WeMos on your network will show up in the list. It'll show the name of the device, the type, the IP address, MAC address and serial number. You can click on a device in the list to select it.

You can right click inside of the list for quick actions, or you can use the buttons in the tabs below.

There are some tabs:

• Controls lets you:
  • Test a device by toggling it on/off
  • View a device's HomeKit details so you can add it to HomeKit
  • Change a device's name
  • Copy a device's IP address, MAC address or serial number
• Utilities lets you rescan devices, check if PyWeMoGUI can access OpenSSL, and links to this page
• Setup WeMo contains everything required to setup a WeMo that has been reset, more on this later
• Reset WeMo lets you reset a WeMo's personalized info, Wi-Fi settings or even fully factory reset it.
• Debug is just for testing purposes and will have things inside that can appear nonsensical or even broken.

Setting up a WeMo

To set up a WeMo, it has to be factory reset - or at the very least have had its Wi-Fi settings reset. You can reset it with PyWeMoGUI or via the WeMo itself, see the section below.

Once you are sure the WeMo is reset:

1. Plug it in/turn it on and wait for it to start up
2. Search for a WeMo Wi-Fi network nearby, something like "Wemo.Dim2G.295"
3. Connect to the WeMo's network, it should have no password
4. Open PyWeMoGUI or rescan devices if it's already open
5. You should see a single device in the table with the factory name of your device. For example a Dimmer will be named "Wemo Dimmer" in the list. Select it.
6. Navigate to the Setup WeMo tab, then enter the details of the Wi-Fi network you want the WeMo to connect to. If it has no password, check the 'No password/Open network' checkbox

Note

Remember that you need OpenSSL usable from the commandline if you want to connect the WeMo to a password-protected network!

7. If all goes well, your WeMo should reboot a few seconds later to apply its new settings.
8. After about a minute, it should be on your Wi-Fi network. You can then re-connect to your home Wi-Fi network and rescan for devices to see your Wemo!

Resetting a WeMo

Select the WeMo you want to reset in the list, click the appropriate button for the reset you want to perform, then click Yes in the confirmation box.

Resetting the WeMo via its hardware controls also works great.

The WeMo will restart after a few seconds to clear its settings. After about a minute, it should start broadcasting its Wi-Fi network.

Development

Manual setup

Note

If you do not want to develop PyWeMoGUI or manually set up for running locally, there are binaries on the Releases page.

• Clone the repo with git:
  git clone https://github.com/thatstella7922/pywemogui
• Create a venv if you want to keep this self-contained
  • python3 -m venv venv to create it
  • venv\scripts\activate to enter it
• Install pywemo - pip should install its dependencies (requests, ifaddr, lxml, urllib3)
  • pip3 install pywemo
• Optional: Install OpenSSL and make sure it's usable as openssl from the commandline. On Windows this might require editing your PATH.
  • PyWeMoGUI's utilities tab lets you check your OpenSSL setup
  • Should be pre-installed on macOS and Linux

You can now run PyWeMoGUI. If you set up pywemo inside a venv, make sure to activate it if you haven't already and then run python3 main.py. Otherwise, don't worry about activation and simply run the with the same command.

Once you see the main window, you can refer back to the usage instructions to use the app.

Building

Since PyWeMoGUI is written in Python there is no real build process. You can run it as-is. The build.py file is mainly a convenience script to me to take some of the tedium out of the binary packaging process.

"Roadmap"

• Refactor most device-related functions for more robust exception handling
• QR code generation for HomeKit setup codes (WeMos can return an X-HM:// URL for setup)
• Renaming devices
• Device specific controls such as dimmer brightness
• Device specific configuration such as dimmer brightness range

Contributing

I am not the best programmer by any stretch of the imagination so I really appreciate any help. Please fork & pull request if you have any code contributions, and if not, I also appreciate well-written issue reports. Both help and can make me aware of things that need improvement.

Attribution and license

All rights are not reserved. https://github.com/pywemo/pywemo and https://github.com/iancmcc/ouimeaux are not my code and those belong to their respective authors. PyWeMoGUI is not endorsed by the pywemo or ouimeaux projects in any way. The PyWeMoGUI code is licensed under the GPLv3.