PTZOptics Moondream Tracker

Video Source:

Select which webcam to use for tracking

Target Object: Describe what you want to track (e.g., "person", "red ball", "coffee mug")

PTZ Camera IP:

Enable HTTP Authentication

Camera Operation Style: Presets adjust speed, deadzone, and detection rate

Detection Rate: 1.0 per second

0.1/sec (Slower) 5/sec (Faster)

Lower = Less API usage, Higher = More responsive tracking

Movement Speed

Pan Speed: 5

Tilt Speed: 5

Center Target Position

Horizontal: 50% Where to center horizontally

Vertical: 50% Where to center vertically

Centering Precision

Horizontal Deadzone: 5% Smaller = tighter centering

Vertical Deadzone: 5% Smaller = tighter centering

Tip: Set center target to where you want the object (50% = true center). Use smaller deadzone (1-5%) for precise centering, larger (15-30%) for smoother tracking.

Auto-Zoom (Headroom Control)

Enable Auto-Zoom Automatically zoom in/out to maintain proper headroom

Min Headroom: 10% Zoom OUT if less than this

Max Headroom: 30% Zoom IN if more than this

Zoom Speed: 3

How it works: Measures space above/below the detected object. If headroom exceeds max, zooms in. If below min, zooms out. Sweet spot = no zoom change.

Initializing...

Manual PTZ Controls

Zoom

Hold buttons to move camera. Release to stop.

⚡ Performance Tip

The Moondream cloud API processes ~1-2 frames/second. For smoother tracking (5-10+ fps), run Moondream locally:

Install: pip install moondream
Run: moondream serve --host 0.0.0.0 --port 3475
Use local endpoint in API settings

View Moondream Documentation →