Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/SecKatie/ha-wyzeapi
Home Assistant Integration for Wyze devices.
https://github.com/SecKatie/ha-wyzeapi
bulb home-assistant home-automation homeassistant switch wyze wyze-bulbs wyze-switchs
Last synced: about 1 month ago
JSON representation
Home Assistant Integration for Wyze devices.
- Host: GitHub
- URL: https://github.com/SecKatie/ha-wyzeapi
- Owner: SecKatie
- Created: 2019-12-11T20:21:17.000Z (about 5 years ago)
- Default Branch: master
- Last Pushed: 2024-10-10T21:25:13.000Z (2 months ago)
- Last Synced: 2024-10-29T17:28:33.927Z (about 1 month ago)
- Topics: bulb, home-assistant, home-automation, homeassistant, switch, wyze, wyze-bulbs, wyze-switchs
- Language: Python
- Homepage:
- Size: 957 KB
- Stars: 751
- Watchers: 44
- Forks: 113
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- Funding: .github/FUNDING.yml
- License: LICENSES/Apache-2.0.txt
- Codeowners: .github/CODEOWNERS
- Security: SECURITY.md
Awesome Lists containing this project
- awesome - SecKatie/ha-wyzeapi - Home Assistant Integration for Wyze devices. (Python)
README
# Home Assistant - Wyze Integration
This is a custom component to allow control of various Wyze devices in Home Assistant using the unofficial API. Please
note this mimics the Wyze app and therefore access may be cut off at anytime.
### Highlights of what **WyzeApi** can do
* Control Wyze Bulbs as lights through HA
* Control Wyze Plugs as switches through HA
* Use Wyze Cameras as motion sensors **NOTE:** Disabled following API usage incident with Wyze
* Turn on and off Wyze Cameras
* Lock, unlock, and view status of lock and door for the Wyze Lock
### Potential Downsides
* This is an unofficial implementation of the api and therefore may be disabled or broken at anytime by WyzeLabs
* ~~***It requires two factor authentication to be disabled on your account***~~
* ***Two Factor Authentication is supported as of version 2021.9.2***
## Funding
If you like what I have done here and want to help I would recommend that you firstly look into supporting Home
Assistant. You can do this by purchasing some swag from their [store](https://teespring.com/stores/home-assistant-store)
or paying for a Nabu Casa subscription. None of this could happen without them.
After you have done that if you feel like my work has been valuable to you I welcome your support through BuyMeACoffee or Github Sponsers in the right hand menu.
## Installation (HACS) - Highly Recommended
1. Have HACS installed, this will allow you to easily update
2. Add [https://github.com/SecKatie/ha-wyzeapi](https://github.com/SecKatie/ha-wyzeapi) as a custom
repository as Type: Integration
3. Click install under "Wyze Bulb and Switch Api Integration" in the Integration tab
4. Restart HA
5. Navigate to _Integrations_ in the config interface.
6. Click _ADD INTEGRATION_
7. Search for _Wyze Home Assistant Integration_
**NOTE:** If _Wyze Home Assistant Integration_ does not appear, hard refresh the browser (ctrl+F5) and search again
9. Enter your email, password, keyid & apikey when prompted.
**NOTE:** If you do not know how to generate your keyid & apikey, please see the following official Wyze documentation: [Creating an API Key](https://support.wyze.com/hc/en-us/articles/16129834216731-Creating-an-API-Key)
10. Click _SUBMIT_ and profit!
## Usage
* Entities will show up as `light.`, `switch.`, `binary_sensor.`
or `lock.` for example (`light.livingroom_lamp`).
* Instructions for interacting with lights can be found here: https://www.home-assistant.io/integrations/light/
* Switches: https://www.home-assistant.io/integrations/switch/
* Camera motion sensors: https://www.home-assistant.io/integrations/binary_sensor/
## Contributing
* For development contributions please join our IRC channel #wyzeapi on Libre.Chat
* For instructions on intercepting data from the Wyze app see: https://mulliken.net/p/intercepting-pinned-tls-connections-on-android/
## Support
If you need help with anything then please connect with the community!
* Visit us on IRC at librechat in the #wyzeapi channel!
* Visit the discussions tab on this repo
* For bugs or feature requests create an issue
* Check out the [wiki](https://github.com/SecKatie/ha-wyzeapi/wiki)!
## Reporting an Issue
1. Setup your logger to print debug messages for this component by adding this to your `configuration.yaml`:
```yaml
logger:
default: warning
logs:
custom_components.wyzeapi: debug
wyzeapy: debug
```
2. Restart HA
3. Verify you're still having the issue
4. File an issue in this Github Repository (being sure to fill out every provided field)