# Amcrest PTZ Bridge

Amcrest PTZ Bridge is a self-hosted home automation app. Amcrest PTZ Bridge exposes the local pan and tilt controls of an Amcrest SmartHome camera as an Open Network Video Interface Forum (ONVIF) PTZ service that Frigate can use. It is open source and self-hosted, installable on Unraid.

Canonical page: https://ourlocalhost.com/app/2602/amcrest-ptz-bridge

## Description

Amcrest PTZ Bridge exposes the local pan and tilt controls of an Amcrest SmartHome camera as an Open Network Video Interface Forum (ONVIF) PTZ service that Frigate can use. Video and audio continue to stream directly between the camera and Frigate; the bridge only relays movement commands. It is designed for one camera per container instance, never phones home, and suits self-hosters who want PTZ control inside Frigate instead of the Amcrest SmartHome app.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

39/100 (Low), based on 3 of 4 factors.
- Maintained: 65 (last commit 99 days ago)
- Popular: 0 (0 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)

## Links

- Unraid: https://ca.unraid.net/apps/amcrest-ptz-bridge-0r7c0by15u2zze?q=Amcrest-PTZ-Bridge

## Common questions

### How do I configure the bridge in Frigate for PTZ controls?

Add an onvif block to the existing Frigate camera definition, at the same indentation level as ffmpeg, with the host set to the Unraid server LAN address and the port set to the bridge instance's ONVIF host port. The existing ffmpeg and detect settings remain alongside it.

### Can one container instance control multiple Amcrest cameras?

No, the project is designed for one camera per container instance. Install another instance with a different name and ONVIF host port for each additional camera.

### What camera password options does the Unraid template support?

You can enter the camera password in the standard field, or use an optional secret file containing only the camera password. For the secret file, select the host file in the template and set the container path to /run/secrets/camera_password. The host file must be readable by container user 10001.

### Which ports does Frigate use to talk to the bridge, and which port does the bridge use for the camera?

Frigate uses the bridge's ONVIF host port, starting at 18880 and using 18881, 18882, and so on for additional instances. The bridge connects to the camera's local DVRIP port 37777.

### What happens if the ONVIF client loses its connection while moving the camera?

Every movement has a configurable fail-safe timer that stops the camera if the bridge does not receive Stop before the timeout. This stops the camera even if the ONVIF client loses its connection before sending Stop.

### Does the bridge require an internet connection or send camera credentials?

No, it does not reach out to the internet and does not send credentials anywhere. It relays movement commands to the camera's local DVRIP interface.

---
Source: Our Local Host (https://ourlocalhost.com/app/2602/amcrest-ptz-bridge), the self-hosted and open-source app directory.
