Skip to main content
Free Tools:
Cost Calculator | Subscription Audit | All Tools
Wyze
Partial Compatibility

Wyze + Home Assistant

Wyze has no official Home Assistant integration. All methods rely on community projects that can break when Wyze updates their API or firmware. This guide covers the most reliable approaches and common pitfalls.

30 min setup Unofficial integration Multiple methods

Before You Begin

Wyze integration relies on unofficial, reverse-engineered methods. These can break at any time when Wyze updates their systems. Plan for occasional maintenance and troubleshooting.

If you want reliable, local smart home cameras, consider UniFi Protect or Reolink instead.

What You Need

  • Wyze camera or device (Cam V2/V3/V4, Pan, Doorbell, Plugs, Bulbs)
  • Wyze API Key + API ID from Wyze Developer Portal
  • For Docker-Wyze-Bridge: Home Assistant OS or Supervised (for add-on) or separate Docker host
  • For ha-wyzeapi: HACS installed in Home Assistant

Choose Your Method

Method Best For Local? Difficulty
Docker-Wyze-Bridge Camera streams (all models) Partial Easy
wz_mini_hacks Full local control (Cam V3) Yes Advanced
ha-wyzeapi (HACS) Plugs, bulbs, locks No (cloud) Easy

Method 1: Docker-Wyze-Bridge (Recommended for Cameras)

The easiest way to get Wyze camera streams into Home Assistant. No firmware flashing required. Supports WebRTC, RTSP, RTMP, and HLS streaming.

Supported Cameras

  • Wyze Cam V1, V2, V3, V4
  • Wyze Cam Pan, Pan V2, Pan V3, Pan Pro
  • Wyze Outdoor, Outdoor V2
  • Wyze Doorbell, Doorbell V2
  • Wyze Floodlight, Floodlight V2, V3 Pro

Setup Steps

  1. 1

    Generate Wyze API credentials

    Go to Wyze Developer Portal and create an API Key + API ID. Save these securely.

  2. 2

    Add the repository

    Settings → Add-ons → Add-on Store → ⋮ → Repositories → Add: https://github.com/mrlt8/docker-wyze-bridge

  3. 3

    Install and configure

    Install "Docker Wyze Bridge" add-on. In Configuration, add your email, password, API key, and API ID.

  4. 4

    Start and check logs

    Start the add-on. Check logs for camera names (e.g., "Front Door" becomes "front_door").

  5. 5

    Add cameras to dashboard

    Use RTSP URL: rtsp://homeassistant.local:8554/front_door

# Example configuration

WB_EMAIL: your@email.com
WB_PASSWORD: yourpassword
WB_API_KEY: your-api-key
WB_API_ID: your-api-id
RTSP_READTIMEOUT: 10

Method 2: wz_mini_hacks (Full Local Control)

Custom firmware for Wyze Cam V3 that enables true local control without cloud dependency. More complex setup but provides the most control.

Features

  • True RTSP streaming via go2rtc
  • Local motion detection sensors
  • IR filter, LED, and night mode control
  • Self-hosted mode (blocks Wyze cloud)
  • Works with Frigate for AI detection

Setup Overview

  1. 1. Download Wyze firmware 4.36.9.139 from Wyze
  2. 2. Flash via SD card (hold setup button until purple LED)
  3. 3. Download wz_mini_hacks SD_ROOT folder
  4. 4. Configure WiFi credentials and enable go2rtc
  5. 5. Insert SD card and power on camera
  6. 6. Add to Home Assistant as generic camera

Important: Disable "Motion Tagging" in the Wyze app before flashing. Otherwise, you'll see green boxes on your video feed.

Method 3: ha-wyzeapi (Plugs, Bulbs, Locks)

HACS integration for non-camera Wyze devices. Cloud-dependent but easy to set up.

Supported Devices

  • Wyze Bulbs (including color) → light.*
  • Wyze Plugs → switch.*
  • Wyze Locks → lock.*
  • Cameras → on/off only (no streaming)

Setup Steps

  1. 1

    Install via HACS

    HACS → Integrations → Search "Wyze" → Install "ha-wyzeapi"

  2. 2

    Add integration

    Settings → Devices & Services → Add Integration → Wyze

  3. 3

    Enter credentials

    Enter your Wyze email, password, API Key, and API ID.

Common Issues & Solutions

These are real problems reported by users on Reddit, Home Assistant forums, and GitHub issues.

Authentication Problems

"Integration failed to set up" after Home Assistant update

Fix: Check if ha-wyzeapi needs an update in HACS. Wyze may have changed their API.

"Invalid authentication" errors

Fix: Remove integration from HACS, remove from configuration.yaml, reboot, then re-add with a fresh API key.

API token expires randomly

Fix: Restart Home Assistant. If persistent, delete and re-add the integration with a new API key from Wyze's developer portal.

Stream Reliability Issues

Stream freezes after 1-3 seconds

Fix: Increase RTSP_READTIMEOUT to 10 or higher in Docker-Wyze-Bridge config.

"levelLoadTimeOut" or "fragLoadTimeOut" errors

Fix: Restart RTSP on the camera via the Docker-Wyze-Bridge web UI. Check camera WiFi signal strength.

Camera shows unavailable but works in VLC

Fix: Restart Home Assistant. The stream URL may have changed; check Docker-Wyze-Bridge logs for new camera names.

Green boxes appearing on video feed

Fix: Disable "Motion Tagging" in the Wyze app. This feature draws boxes around detected motion.

Device-Specific Issues

Wyze Floodlight V2: Light toggle doesn't work

Known issue: Toggle moves in HA but doesn't change actual state. State also doesn't sync from the Wyze app. Siren and power toggles work correctly.

Wyze sensors not appearing in Home Assistant

Fix: The ha-wyzeapi integration has slower sensor responses. For better reliability, use the Wyze Sense Bridge with ha-wyzesense integration (requires USB dongle disconnected from Wyze app).

Wyze sensor battery died and won't reconnect

Warning: Letting the battery fully die can corrupt the sensor's MAC address, effectively bricking it. Replace batteries proactively.

What Breaks and When

Wyze integrations have broken multiple times in the past:

  • • 2024: API key requirement added; old email/password auth stopped working
  • • RTSP firmware removal: Wyze removed download links with no timeline for return
  • • Forced V3 firmware update: Temporarily broke wz_mini_hacks and third-party RTSP
  • • HA 2025.6.1: Broke Wyze plug integration for some users

Risk Factor: Wyze can disable unofficial API access at any time. New camera models may not be reverse-engineered quickly. Consider this when building automations that depend on Wyze.

Frequently Asked Questions

Why doesn't Wyze have official Home Assistant support?

Despite nearly 2,000 votes on a feature request since 2018, Wyze has consistently tagged it as "Maybe Later." All integration methods rely on community-developed solutions that can break when Wyze changes their API or firmware.

Which Wyze integration method should I use?

For cameras, use Docker-Wyze-Bridge (easiest, no firmware flashing). For full local control without cloud, use wz_mini_hacks on Cam V3. For plugs, bulbs, and locks, use ha-wyzeapi via HACS.

Can I use Wyze Cam V4 with Home Assistant?

Yes, but only via Docker-Wyze-Bridge. Wyze has not released RTSP firmware for the V4, and custom firmware (wz_mini_hacks) doesn't support it yet. Docker-Wyze-Bridge is currently the only option.

Why did my Wyze integration suddenly stop working?

Wyze frequently changes their API without notice. Common fixes: restart Home Assistant, regenerate your API key from Wyze's developer portal, update the HACS integration, or check GitHub issues for the specific integration you're using.

Does two-way audio work with Wyze cameras in Home Assistant?

No. Home Assistant cannot capture microphone input to send to cameras. This is a Home Assistant limitation, not specific to Wyze. You must use the Wyze app for two-way communication.

Sources

Related Guides

UniFi Protect + Home Assistant

Full local control, highly reliable

Reolink + Home Assistant

Works with HA certified, no subscription

Ring + Home Assistant

Cloud-based with limitations

Frustrated with Wyze Integration?

We can help you set up Wyze cameras with Home Assistant, or recommend more reliable alternatives like UniFi Protect or Reolink that offer true local control.

Get a Free Consultation