Solving Wyze Integration Problems in Home Assistant
Integrating your Wyze devices into Home Assistant opens up a world of powerful automation possibilities. However, getting the two systems to communicate perfectly can sometimes be a challenge. If your Wyze devices are showing as unavailable, not responding, or failing to stream, this guide will help you troubleshoot and resolve the most common integration issues.
Step 1: Address Authentication and Configuration Errors
The most frequent point of failure is the initial connection and authentication between Home Assistant and Wyze's servers.
-
Verify Your Credentials:
- Double-check that you have entered the correct Wyze email and password in the integration's configuration in Home Assistant. A simple typo is a very common mistake.
- Crucially, if you use Two-Factor Authentication (2FA) on your Wyze account, you cannot use your normal password. You must use the 'TOTP' (Time-based One-Time Password) method with an authenticator app. You will need to generate a specific app key and use that in the password field for Home Assistant.
-
Re-authenticate the Integration:
- Go to Settings > Devices & Services in Home Assistant.
- Find the Wyze integration. If it's in an error state, it may prompt you to 'Reconfigure'.
- Follow the prompts to re-enter your credentials. This can often resolve token-related issues.
-
Restart Home Assistant:
- After making any configuration changes, it's always a good idea to restart the Home Assistant server. This ensures all changes are correctly loaded. You can do this from Settings > System > Restart.
Step 2: Troubleshoot Camera Stream Issues
Getting a live video feed from Wyze cameras into Home Assistant requires a specific setup.
- Understanding Stream Limitations: The standard, official Wyze integration does not support live video streaming. If you are using this integration, you will only get sensors and controls, not a video feed.
- Using RTSP: To enable a live stream, you must use the special RTSP (Real-Time Streaming Protocol) firmware, which is an official alternative firmware provided by Wyze for certain camera models (like the Wyze Cam v2, v3, and Pan v1). You will need to manually flash this onto your camera's SD card. Once installed, you can add the camera to Home Assistant using the generic RTSP camera integration.
- Using Custom Components: An alternative to RTSP firmware is to use a community-developed HACS integration like
wyze-bridge. This runs as a separate add-on and creates an RTSP stream from your camera that Home Assistant can then use, without you needing to flash the camera's firmware. This is often a more flexible solution.
Step 3: Resolve 'Unavailable' or 'Unknown' Entities
If your devices appear but are greyed out and marked as 'unavailable', it's usually a communication problem.
- Check for API Rate Limiting: Wyze's servers limit how many times Home Assistant can request updates. If your polling interval is set too low (i.e., too frequently), Wyze may temporarily block your requests. Check the integration's system options to see if you can adjust the polling interval.
- Network Issues: Ensure your Home Assistant instance and your Wyze devices are on the same network and can communicate with each other. Firewall rules or VLANs can sometimes block the necessary traffic.
- Update the Integration: Whether you're using the official integration or a custom one via HACS, ensure it is updated to the latest version. Developers are constantly making improvements and fixing bugs that can cause these kinds of issues.
By systematically working through these authentication, streaming, and connectivity steps, you can create a stable and reliable link between your Wyze products and Home Assistant.