Create a local WebRTC, RTSP, RTMP, or HLS/Low-Latency HLS stream for most of your Wyze cameras including the outdoor, doorbell, and 2K cams.
No modifications, third-party, or special firmware required.
It just works!
Streams direct from camera without additional bandwidth or subscriptions.
Based on @noelhibbard's script with kroo/wyzecam and bluenviron/mediamtx.
Please consider ⭐️ starring or ☕️ sponsoring this project if you found it useful, or use the affiliate link when shopping on amazon!
Important
As of July 2023, you will need to update your bridge to v2.3.x or newer for compatibility with the latest changes to the Wyze API.
See the supported cameras section for additional information.
Install docker and run:
docker run -p 8554:8554 -p 8888:8888 -p 5000:5000 mrlt8/wyze-bridgeYou can then use the web interface at http://localhost:5000 where localhost is the hostname or ip of the machine running the bridge.
See basic usage for additional information or visit the wiki page for additional information on using the bridge as a Home Assistant Add-on.
-
NEW: ARM 64-bit native library (#529 #604 #664 #871 #998 #1004)
The arm64 container now runs in 64-bit mode, addressing compatibility issues, particularly on Apple Silicon M1/M2/M3, when using the Home Assistant Add-on.
Resolves issues on the Raspberry Pi 4/5 running the 64-bit version of Raspbian.
-
Update: Python 3.11 -> Python 3.12
- How does this work?
- It uses the same SDK as the app to communicate directly with the cameras. See kroo/wyzecam for details.
- Does it use internet bandwidth when streaming?
- Not in most cases. The bridge will attempt to stream locally if possible but will fallback to streaming over the internet if you're trying to stream from a different location or from a shared camera. See the wiki for more details.
- Can this work offline/can I block all wyze services?
- No. Streaming should continue to work without an active internet connection, but will probably stop working after some time as the cameras were not designed to be used without the cloud. Some camera commands also depend on the cloud and may not function without an active connection. See wz_mini_hacks for firmware level modification to run the camera offline.
- Why aren't all wyze cams supported yet (OG/Doorbell Pro)?
- These cameras are using a different SDK and will require a different method to connect and stream.
Should work on most x64 systems as well as on most modern arm-based systems like the Raspberry Pi 3/4/5 or Apple Silicon M1/M2/M3.
The container can be run on its own, in Portainer, Unraid, as a Home Assistant Add-on, locally or remotely in the cloud.
Note
Some network adjustments may be needed - see this discussion for more information.
| Camera | Model | Tutk Support | Latest FW |
|---|---|---|---|
| Wyze Cam v1 [HD only] | WYZEC1 | ✅ | 3.9.4.x |
| Wyze Cam V2 | WYZEC1-JZ | ✅ | 4.9.9.x |
| Wyze Cam V3 | WYZE_CAKP2JFUS | ✅ | 4.36.11.x |
| Wyze Cam V4 [2K] | HL_CAM4 | ❓ | 4.52.? |
| Wyze Cam Floodlight | WYZE_CAKP2JFUS | ✅ | 4.36.11.x |
| Wyze Cam Floodlight V2 | HL_CFL2 | ❓ | - |
| Wyze Cam V3 Pro [2K] | HL_CAM3P | ✅ | 4.58.11.x |
| Wyze Cam Pan | WYZECP1_JEF | ✅ | 4.10.9.x |
| Wyze Cam Pan v2 | HL_PAN2 | ✅ | 4.49.11.x |
| Wyze Cam Pan v3 | HL_PAN3 | ✅ | 4.50.4.x |
| Wyze Cam Pan Pro [2K] | HL_PANP | ✅ | - |
| Wyze Cam Outdoor | WVOD1 | ✅ | 4.17.4.x |
| Wyze Cam Outdoor v2 | HL_WCO2 | ✅ | 4.48.4.x |
| Wyze Cam Doorbell | WYZEDB3 | ✅ | 4.25.1.x |
| Wyze Cam Doorbell v2 [2K] | HL_DB2 | ✅ | 4.51.1.x |
| Wyze Cam Doorbell Pro 2 | AN_RDB1 | ❓ | - |
| Wyze Battery Cam Pro | AN_RSCW | - | |
| Wyze Cam Flood Light Pro [2K] | LD_CFP | - | |
| Wyze Cam Doorbell Pro | GW_BE1 | - | |
| Wyze Cam OG | GW_GC1 | - | |
| Wyze Cam OG Telephoto 3x | GW_GC2 | - |
This is similar to the docker run command, but will save all your options in a yaml file.
- Install Docker Compose.
- Use the sample as a guide to create a
docker-compose.ymlfile with your wyze credentials. - Run
docker-compose up.
Once you're happy with your config you can use docker-compose up -d to run it in detached mode.
Caution
If your credentials have special characters, you must escape them or leave your credentials blank and use the webUI to login.
Note
You may need to update the WebUI links if you're changing the ports or using a reverse proxy.
To update your container, cd into the directory where your docker-compose.yml is located and run:
docker-compose pull # Pull new image
docker-compose up -d # Restart container in detached mode
docker image prune # Remove old imagesVisit the wiki page for additional information on Home Assistant.
- Camera Commands (MQTT/REST API)
- Two-Factor Authentication (2FA/MFA)
- ARM/Apple Silicon/Raspberry Pi
- Network Connection Modes
- Portainer
- Unraid
- Home Assistant
- Homebridge Camera FFmpeg
- HomeKit Secure Video
- WebUI API
The bridge features a basic Web-UI which can display a preview of all your cameras as well as direct links to all the video streams.
The web-ui can be accessed on the default port 5000:
http://localhost:5000/
See also:
WebRTC should work automatically in Home Assistant mode, however, some additional configuration is required to get WebRTC working in the standard docker mode.
-
WebRTC requires two additional ports to be configured in docker:
ports: ... - 8889:8889 #WebRTC - 8189:8189/udp # WebRTC/ICE
-
In addition, the
WB_IPenv needs to be set with the IP address of the server running the bridge.environment: - WB_IP=192.168.1.116
-
See documentation for additional information/options.
WYZE_EMAIL and WYZE_PASSWORD are the only two required environment variables.
- Audio
- Bitrate and Resolution
- Camera Substreams
- MQTT Configuration
- Filtering Cameras
- Doorbell/Camera Rotation
- Custom FFmpeg Commands
- Interval Snapshots
- Stream Recording and Livestreaming
- rtsp-simple-server/MediaMTX Config
- Offline/IFTTT Webhook
- Proxy Stream from RTSP Firmware
- BOA HTTP Server/Motion Alerts
- Debugging Options
- gtxaspec/wz_mini_hacks - firmware level modification with a self-hosted mode to use the cameras without the wyze services.
- jfarmer08/homebridge-wyze-smart-home - homebridge plugin to interact with other wyze devices over the cloud.
- shauntarves/wyze-sdk - python library to interact with wyze devices over the cloud.