scrypted-tuya & Tuya Camera Bridge

Unofficial standalone Scrypted Tuya / Smart Life camera plugin & companion Home Assistant WebRTC-to-RTSP bridge.

Extracted from plugins/tuya and significantly extended with:

• Maximum quality selection — requests the highest writable quality advertised by each camera before RTSP allocation.
• Smart Life P2P bridge — companion Home Assistant add-on with a custom C++ WebRTC-to-RTSP streaming engine.

This project is unofficial and is not affiliated with or endorsed by Scrypted or Tuya.

---

Features

• Tuya and Smart Life camera discovery via MQTT.
• Cloud RTSP camera streaming.
• Maximum advertised video-quality selection with safe fallback.
• Tuya doorbell ring notifications.
• Motion events on supported devices.
• Camera indicator and floodlight controls when exposed by the device.
• QR-code login flow (Tuya / Smart Life app — no developer keys required).

---

Home Assistant — Tuya Camera Bridge Add-on

For cameras that stream at low resolution via Tuya Cloud RTSP (or not at all), use the companion add-on in the bridge/ folder. It runs a custom C++ streaming engine that:

1. Authenticates via Smart Life QR code (scanned once from the Web UI).
2. Opens a WebRTC P2P session to the camera using the Tuya protocol.
3. Re-streams it as a standard RTSP feed on your local network.

1-Click Install via Home Assistant

Manual Install (Home Assistant)

1. Settings → Add-ons → Add-on Store → ⋮ → Repositories
2. Add https://github.com/resonaura/scrypted-tuya
3. Install Tuya Camera Bridge → Start
4. Open the Web UI (ingress or http://<ha-host>:6767)
5. Create a profile → scan the QR code in Smart Life
6. Copy the RTSP URL shown on the camera card, e.g. rtsp://<ha-host>:8655/<CameraName>
7. In Scrypted → camera settings → Smart Life P2P HD RTSP URL → paste URL

The Scrypted plugin continues handling discovery, motion, doorbell events and controls. Video comes from the P2P bridge.

---

Standalone Docker (without Home Assistant)

You can run the Tuya Camera Bridge on any Linux/macOS machine with Docker:

Using Docker Compose (Recommended)

Clone the repository and run:

git clone https://github.com/resonaura/scrypted-tuya.git
cd scrypted-tuya/bridge
docker compose up -d --build

Example docker-compose.yml:

services:
  tuya-bridge:
    build:
      context: .
      dockerfile: Dockerfile
    container_name: tuya-bridge
    restart: unless-stopped
    # CRITICAL: host network mode is required for camera P2P WebRTC / UDP discovery
    network_mode: host
    environment:
      - PORT=6766
      - WEB_PORT=6767
      - RTSP_BASE_PORT=8655
      # Optional: set LAN IP explicitly if auto-detection fails:
      # - RTSP_HOST=192.168.1.50
      - LOG_LEVEL=info
    volumes:
      - ./data:/data/tuya-bridge
      - ./config:/config/tuya-bridge

Using docker run

docker run -d \
  --name tuya-bridge \
  --restart unless-stopped \
  --network host \
  -v $(pwd)/data:/data/tuya-bridge \
  -v $(pwd)/config:/config/tuya-bridge \
  ghcr.io/resonaura/tuya-rtsp-bridge:latest

After starting, open http://<host-ip>:6767 in your browser.

Network Ports

Port	Protocol	Purpose
6766	TCP	REST / WebSocket API
6767	TCP	Web UI dashboard
8655+	TCP/UDP	RTSP streams (one per camera, starting at 8655)

---

Authentication (Scrypted plugin)

The recommended login method is the QR-code flow from the Tuya or Smart Life application. The legacy Tuya Developer Account login remains available for existing configurations.

---

Development

Requirements: Node.js, npm, a Scrypted server for deployment.

npm ci
npm run typecheck
npm run build

The plugin archive is generated at out/plugin.zip.

---

Attribution

The original Tuya plugin was written by the Scrypted contributors. This standalone fork is based on upstream commit abd37e4.

The bridge add-on was originally inspired by DanEng1982/tuya-rtsp-bridge. We are grateful for their pioneering work. The current add-on is a full from-scratch rewrite with a custom C++ engine, NestJS backend, and React frontend.

---

License

See UPSTREAM-LICENSE-NOTICE.md. Review upstream terms before redistributing.