RTMP/RTSP/HLS Bridge for Wyze Cam

Docker container to expose a local RTMP, RTSP, and HLS stream for all your Wyze cameras including v3. No Third-party or special firmware required.

Based on @noelhibbard's script with kroo/wyzecam and aler9/rtsp-simple-server.

Changes in v0.7.2 ~ v0.7.6

🔨 Doorbell related changes: adjust HD frame size. Please post feedback here

Changes in v0.7.1

🔨 Doorbell related changes - rotate other direction and set HD frame size. #150 #133
🏠 Home Assistant: Add additional RTSP intervals.

Changes in v0.7.0

💥 BREAKING: API_THUMB and RTSP_THUMB are now SNAPSHOT=API or SNAPSHOT=RTSP or SNAPSHOT=RTSP30 for custom interval. See Snapshot
💥 BREAKING: LAN_ONLY is now NET_MODE=LAN. See LAN Mode
✨ NEW: NET_MODE=P2P to block relay mode and stream from the camera using P2P mode for VPS/cloud and remote installs. see P2P Mode
✨ NEW: Basic MQTT support with discovery - publishes camera status, connections to camera, and snapshot if available. See MQTT
✨ NEW: ROTATE_DOOR will use ffmpeg to roate the Doorbell (WYZEDB3) stream. NOTE: this will re-encoding rather than copy h264 stream, which may require additional processing power.
🔀 Removed Supervisord
📦 Switch to static build of ffmpeg-for-homebridge
🔨 Fixed broken rtsp auth

View older changes

Compatibility

Should work on most x64 systems as well as on some arm-based systems like the Raspberry Pi.

The container can be run on its own, in Portainer, or as a Home Assistant Add-on.

Supported Cameras

Some reports of issues with v1 and WCO models that need further investigation.

Firmware Compatibility

The bridge currently has issues connecting to cameras on newer firmware with DTLS enabled.

Some reports of DTLS being rolled out on the V3 beta firmware.

If you wish to continue using your camera with the bridge, you should downgrade or remain on a firmware without DTLS:

Camera	Latest Firmware w/o DTLS
V2	4.9.6.241 (March 9, 2021)
V3	4.36.3.19 (August 26, 2021)
PAN	4.10.6.241 (March 9, 2021)

Basic Usage

docker run

Use your Wyze credentials and run:

docker run -p 8888:8888 -e WYZE_EMAIL= -e WYZE_PASSWORD=  mrlt8/wyze-bridge:latest

This will start the bridge with the HLS ports open and you can view your stream by visiting: http://localhost:8888/cam-nickname where localhost is the hostname or ip of the machine running the bridge followed by the cam nickname in lowercase with - in place of spaces.

docker-compose (recommended)

This is similar to the docker run command, but will save all your options in a yaml file.

Download and rename or create a docker-compose.yml file
Edit docker-compose.yml 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.

🏠 Home Assistant

Visit the wiki page for additional information on Home Assistant.

Additional Info

Two-Step Verification
ARM/Raspberry Pi
LAN mode
Portainer
Home Assistant

Special Characters

If your email or password contains a % or $ character, you may need to escape them with an extra character. e.g., pa$$word should be entered as pa$$$$word

Camera Stream URIs

By default, the bridge will create three streams for each of your cameras which can be acccessed at the following URIs, where camera-nickname is the name of the camera set in the Wyze app and converted to lower case with hyphens in place of spaces. e.g. 'Front Door' would be /front-door

Replace localhost with the hostname or ip of the machine running the bridge:

RTMP:
```
rtmp://localhost:1935/camera-nickname
```
RTSP:
```
rtsp://localhost:8554/camera-nickname
```

HLS:

http://localhost:8888/camera-nickname/stream.m3u8

HLS can also be viewed in the browser using:
```
http://localhost:8888/camera-nickname
```

Multi-Factor Authentication

Two-factor authentication ("Two-Step Verification" in the wyze app) is supported and will automatically be detected, however additional steps are required to enter your verification code.

Echo the verification code directly to /tokens/mfa_token by opening a second terminal window and using:
```
docker exec -it wyze-bridge sh -c 'echo "123456" > /tokens/mfa_token'
```
Mount /tokens/ locally and add your verification code to a file named mfa_token:
```
volumes:
    - ./tokens:/tokens/
```
🏠 Home Assistant:

Add your code to the text file: /config/wyze-bridge/mfa_token.txt.

ARM/Raspberry Pi

The default docker-compose.yml will pull a multi-arch image that has support for both amrv7 and arm64, and no changes are required to run the container as is.

libseccomp2

arm/arm64 users on 32-bit Debian-based distros may experience errors such as can't initialize time which can be resolved by updating libseccomp2:

apt-get -y install libseccomp2/unstable

wget http://ftp.us.debian.org/debian/pool/main/libs/libseccomp/libseccomp2_2.5.1-1_armhf.deb
sudo dpkg -i libseccomp2_2.5.1-1_armhf.deb

Build from source

If you would like to build the container from source, you will need to edit your docker-compose.yml to use the arm libraries by removing or commenting out the line image: mrlt8/wyze-bridge:latest and add or uncomment the following three lines:

build:
    context: ./app
    dockerfile: Dockerfile.arm

Advanced Options

WYZE_EMAIL and WYZE_PASSWORD are the only two required environment variables. The following envs are optional.

Filtering

The default option will automatically create a stream for all the cameras on your account, but you can use the following environment options in your docker-compose.yml to filter the cameras.

All options are case-insensitivE, and take single or comma separated values.

Examples

Whitelist by Camera Name (set in the wyze app):

environment:
    ..
    - FILTER_NAMES=Front Door, Driveway, porch cam

Whitelist by Camera MAC Address:

- FILTER_MACS=00:aA:22:33:44:55, Aa22334455bB

Whitelist by Camera Model:
```
- FILTER_MODEL=WYZEC1-JZ
```
Whitelist by Camera Model Name:
```
- FILTER_MODEL=V2, v3, Pan
```
Blacklisting:

You can reverse any of these whitelists into blacklists by setting FILTER_BLOCK.
```
environment:
    ..
    - FILTER_NAMES=Bedroom
    - FILTER_BLOCK=true
```

Network Connection Modes

Like the wyze app, the tutk library has three different modes to connect to the camera and will attempt to stream directly from the camera when on the same LAN as the camera in "LAN mode". If the camera is not available locally, it will either attempt to stream directly from your network using "P2P Mode" or relay the stream via the wyze servers (AWS) in "relay mode".

LAN mode is more ideal as all streaming will be local and won't use additional bandwidth.

LAN Mode

By default, the bridge will attempt to connect via "LAN Mode", but will fallback to other methods if LAN mode fails. You can restrict streaming to LAN only by setting the NET_MODE=LAN environment variable:

environment:
    ..
    - NET_MODE=LAN

P2P Mode

NET_MODE=P2P is ideal when running the bridge remotely on a different network or on a VPS and will allow the bridge to stream directly from the camera over the internet while blocking "Relay Mode".

Snapshot/Still Images

SNAPSHOT=API Will run ONCE at startup and will grab a high-quality thumbnail from the wyze api and save it to /img/cam-name.jpg on docker installs or /config/www/cam-name.jpg in Home Assistant mode.
SNAPSHOT=RTSP Will run every 180 seconds (configurable) and wll grab a new frame from the RTSP stream every iteration and save it to /img/cam-name.jpg on standard docker installs or /config/www/cam-name.jpg in Home Assistant mode. Can specify a custom interval with SNAPSHOT=RTSP(INT) e.g. SNAPSHOT=RTSP30 to run every 30 seconds

MQTT (beta)

Some basic MQTT support is now available in v0.7.0.

MQTT auth and discovery should be automatic in Home Assistant mode - can be disabled by setting MQTT_HOST to False.

ENV Name	Description	Example
MQTT_HOST	IP/Hostname AND Port of the MQTT broker	core-mosquitto:1883
MQTT_AUTH	Username AND password; leave blank if none	user:pass
MQTT_TOPIC	Optional - Specify topic prefix	myhome
MQTT_DTOPIC	Optional - Discovery topic for home assistant	homeassistant

Bitrate and Resolution

Bitrate and resolution of the stream from the wyze camera can be adjusted with:

environment:
    - QUALITY=HD120

Additional info:

Resolution can be set to SD (360p in the app) or HD - 640x360/1920x1080 for cams or 480x640/1296x1728 for doorbells.
Bitrate can be set from 30 to 255. Some bitrates may not work with certain resolutions.
Bitrate and resolution changes will apply to ALL cameras.
Adjusting the bitrate and resolution in the bridge will also change the stream in the wyze app and vice versa.
App equivalents would be:
- 360p - SD30
- SD - HD60
- HD - HD120

Custom FFmpeg Commands

You can pass a custom command to FFmpeg by using FFMPEG_CMD in your docker-compose.yml:

For all cameras

environment:
    ..
    - FFMPEG_CMD=-f h264 -i - -vcodec copy -f flv rtmp://rtsp-server:1935/

For a specific camera

where CAM_NAME is the camera name in UPPERCASE and _ in place of spaces and hyphens:

- FFMPEG_CMD_CAM_NAME=ffmpeg -f h264 -i - -vcodec copy -f flv rtmp://rtsp-server:1935/