Browse all articles

Page

Camera Control

Works in:web appTech Manager 16 min read Open this page in WorshipMetrics
On this page
  1. Where to find it
  2. Add a PTZ camera
  3. Add a USB camera (Tech Manager)
  4. Move and zoom a camera
  5. Recall and store presets
  6. Focus the camera
  7. Use the keyboard or a game controller
  8. Watch all cameras at once
  9. Adjust the picture and preview
  10. Track a person automatically
  11. See who is driving a camera
  12. Troubleshooting
  13. Good to know

Camera Control drives your PTZ (pan, tilt, zoom) cameras: move and zoom them, focus, recall and store position presets, and watch their pictures.

Where to find it

Open Produce > Camera Control. You can also get there from Open PTZ Control in a camera's menu on Patch > Devices (right-click the camera, or click its ... button), or by clicking a camera name in the PTZ Cameras card on Produce > Dashboard.

  • In Tech Manager (the desktop app on the booth computer), commands go straight to the cameras over VISCA or ONVIF on the booth's network, and the picture is live from the camera.
  • On the web app, every command is passed through your booth's Tech Manager, so Tech Manager must be running and paired. The header shows which booth carried the last command and how long it took (for example "via Booth · 40 ms").
  • On the web app the picture is live video from the booth. While it is starting, the last snapshot shows dimmed under Connecting to live video…, and the controls stay off until the live picture is up, because a camera cannot be steered off a still snapshot.

Only cameras that have PTZ Control enabled in Patch > Devices appear here.

Add a PTZ camera

  1. Go to Produce > Camera Control.
  2. Click Add camera (at the bottom of the camera list, or on the empty page), or the plus icon above the list.
  3. The window asks How is this camera connected? Click Network (on the booth network, reached by its IP address). For a camera plugged into the computer by USB, see "Add a USB camera (Tech Manager)" below.
  1. Fill in Camera label and Camera IP. If you know the model, type it into Camera model and pick it: the RTSP address, VISCA port and control settings are filled in for that model. Otherwise leave VISCA port at 52381 unless your camera uses another port, and leave VISCA dialect on Detect automatically.
  1. To see a picture, add the RTSP URL. If the camera needs a login, type it in Username and Password, never inside the RTSP address. An address filled in for you follows the Camera IP as you type it. Click Test RTSP preview to check it.
  2. Under Picture, Camera's network stream (the default for a network camera) shows the RTSP picture. If vMix already takes this camera in, pick vMix input instead: the picture and the preset pictures then come from that vMix input. Choose the input in Tech Manager on the booth computer; Automatic uses the vMix input named after the camera.
  3. Click Add camera. It appears in the list and in Patch > Devices.

To look for cameras on the network instead, click Discover cameras (or the search icon above the list) in Tech Manager on the booth. Scanning runs only there, so the web app does not offer it: on the web, add the camera by IP or scan from the booth. When the scan finishes, a message says how many cameras it found among the devices that answered. A camera the scan finds shows up here once it is in Patch > Devices with PTZ control turned on. If the booth is not connected to a church yet, what it scans is saved on the booth only; connect it in Settings > Booths to sync it.

Add a USB camera (Tech Manager)

A PTZ camera plugged into the booth computer by USB is driven by Tech Manager on that computer, while vMix keeps its video. It uses the same controls as a network camera: the Move pad, presets, focus and the Image tab.

  1. In Tech Manager on the computer the camera is plugged into, go to Produce > Camera Control and click Add camera.
  2. Under How is this camera connected?, click USB. On the web app this choice is greyed out and reads "Add it in Tech Manager on the computer it is plugged into."
  3. Add a USB camera lists the cameras with pan, tilt or zoom plugged in by USB. Pick yours, change its Name if you like, and click Add camera. If the list is empty, plug the camera in and click Look again; Back returns to the first question.
  4. The camera shows in the list with USB where a network camera shows its IP address. Its picture comes from vMix: open the gear (Camera settings) and pick the vMix input that shows this camera, or leave it on Automatic.

To keep control if the USB link drops while the camera still feeds video by HDMI or SDI, type a Network address (backup) in Camera settings. Tech Manager drives the camera over USB while it is plugged in, and over that address only while the USB link is down. To drive the camera over the network all the time, choose Network at the top of Camera settings and type its IP address.

USB camera control works on Windows booth computers for now. A few network-only controls, such as AF sensitivity, AF zone and Reboot camera, do not show for a USB camera, and the camera's own built-in tracker is not used over USB.

Move and zoom a camera

  1. Go to Produce > Camera Control and click the camera in the list on the left.
  2. Use the Move panel on the right: hold an arrow to pan and tilt, hold the zoom buttons to zoom. The centre button and Stop all stop every motion.
  1. Or use the picture itself with the pointer tools above it:
    • Move — drag on the picture to pan and tilt, scroll to zoom. On the web app it works only while the picture is live video; until then it says Move needs the live picture.
    • Target — click a spot to centre the camera on it.
    • Frame — a box follows the pointer; scroll to size it, click to take that shot.
    • Search — click where the subject went; the camera re-centres there and briefly zooms out so you can find them.
  2. Set speed under Pan & tilt and Zoom: Fixed gives Slow, Med and Fast; Variable gives a slider.
  3. To change what Slow, Med and Fast mean for this camera, click the pencil beside them (Edit speed steps), type a speed from 1 to 18 for each, and click Done. Reset puts the three back to the built-in values. The steps are saved per camera.

While the mouse wheel zooms, a large + (zooming in) or − (zooming out) shows on the picture. Tech Manager opens on Move; the web app opens on Target.

The Move panel can also show a Virtual joystick instead of the button pad.

Recall and store presets

  1. Go to Produce > Camera Control and pick the camera.
  2. Under Position presets, click a preset to send the camera there.
  3. To save a new position: aim the camera, click Store, then click the preset to save into. A thumbnail is captured for reference. Click Cancel to leave store mode.
  4. To rename presets, click Labels, type the names and click Save labels.

Each camera holds up to 9 presets. To add or remove preset slots, click the gear (Camera settings), use + Add preset or the remove button under Preset Labels, and click Save changes.

To remove a camera, open the same dialog and click Delete camera. You are asked to confirm, and the dialog lists what goes with it (cables, its place on the Signal Map, health history): a camera is a device, so this removes it from Patch > Devices too.

Focus the camera

On Produce > Camera Control, in the Controls tab on the right, under Focus:

  1. Auto keeps the camera focusing by itself. Manual lets you use Near and Far (they only work in Manual).
  2. One-push auto-focus focuses once and then holds.
  3. The focus lock button (it reads "Focus unlocked" or "Focus locked") freezes focus so someone walking through the shot does not pull it.
  4. AF sensitivity and AF zone tune auto-focus.

Some cameras also show an On-screen menu (OSD) card in the Controls tab, which opens the camera's own settings menu. Click Open on-screen menu, then use the arrows to move through it (left and right change the highlighted value), the centre button to enter, and the back button to go back a level or close it. The menu appears on the camera's video, so it is on Program if that camera is live.

Use the keyboard or a game controller

  1. On Produce > Camera Control, click the keyboard button above the picture to turn keyboard control on.
  2. Keys: W A S D pan and tilt, R / F zoom in and out, T / G focus far and near, 1–9 recall a preset, Shift+1–9 save a preset, Space or X stop, Y auto-focus, [ / ] speed down and up, Esc exit.
  3. For a controller, click the gamepad button and press any button on the controller. The right stick pans and tilts, the left stick zooms, and A B X Y recall presets 1–4.

Click the ? button (Control methods) to see which inputs work where you are.

Watch all cameras at once

  1. On Produce > Camera Control, click the grid button (All cameras) above the picture.
  2. Every camera shows as a tile. Pick a size under Tile size: S, M or L. This computer remembers your choice.
  3. A click on a tile follows the pointer tool picked above the picture, and the bar over the tiles says what it does. With Target, a click centres that camera on the spot. With Move, you drag the tile to drive and a click opens the camera.
  4. To open one camera full size, double-click its tile or use the expand button on it.

On the web app, up to six tiles show live video from the camera's smaller second stream; the rest show booth snapshots and move up when a live slot frees. A tile showing only a snapshot cannot be driven.

If the computer cannot keep up, tiles drop to a lower quality. Click Try full quality to try again.

Adjust the picture and preview

On Produce > Camera Control, in the Image tab on the right:

  • Image adjustment changes exposure, picture and color on the camera itself. PTZOptics, Sony and BirdDog cameras get it over VISCA or their own API; Panasonic AW and Canon CR-N cameras get it over their own web control, using the camera's Username and Password from Edit camera. The settings are grouped under Exposure, Picture and Color.
  • Some settings only work in one mode, and stay greyed out until you pick it: Iris needs Manual or Iris priority exposure, Shutter needs Manual or Shutter priority, and red and blue gain need Manual white balance. The line under a greyed setting says which mode it needs.
  • Click Read current values from camera to load the current values. If the camera cannot be read, the panel says what it answered (for example that it wants a login). If the panel says the booth build has no image-adjustment support, update Tech Manager.
  • Live view profile shows the camera's own video settings (resolution, frame rate, keyframe, bitrate) on cameras that offer them over ONVIF. Click Prepare for live view to set the camera up for smooth live video: 30 frames a second and a keyframe every second, with the resolution left as it is. This changes the camera itself, so OBS and vMix see it too, and the live picture may blink once.
  • Orientation Mirror and Flip only change the preview in this app, not the camera's output.
  • Preview stream picks Main or Sub, TCP or UDP, and the width.
  • Thumbnail refresh sets how often the list thumbnails update: Auto, On open or Manual.
  • Test this camera walks through the camera checks and sends the result to WorshipMetrics.

Track a person automatically

Open the Auto tracking tab under the camera's picture. There are two ways to track, and the tab lists the better one for that camera first.

Built-in tracking is the camera's own tracker, on cameras that have one (such as PTZOptics Move 4K, SimplTrack, OBSBOT and AVer TR323). Click it to turn it on or off. When the camera has it, use it: it sees the full picture with no delay.

Follow a person works with any PTZ camera. Tech Manager watches the camera's picture on the booth computer and pans the camera left and right to keep the person you picked in the middle. It only pans; it does not tilt or zoom. Zooming from the web or the booth keeps tracking; panning takes control and pauses it. After a zoom it works out how fast to pan at the new zoom within a second or two.

  1. Open Produce > Camera Control and choose the camera, in Tech Manager on the booth computer or on the web app.
  2. In the Auto tracking tab, click Pick a person, then click the person in the picture. A box shows who is being followed.
  3. Under Speed, choose how fast the camera may pan: Slow, Medium or Fast. Medium suits most rooms. The setting is how fast the picture may move, so it means the same on every brand of camera and at every zoom.
  4. To end it, click Stop (or Stop all in the Controls panel).

The tab says what is happening:

  • Tracking: following the person.
  • Lost: the person left the picture. The camera holds still and picks them up again when they come back.
  • Paused: someone moved the camera by hand: the joystick or pad, a preset, the Frame or Target tool, focus, someone panning it from the web, or another operator taking control. Turning on Built-in tracking pauses it too, so the two never steer the camera at once. Tracking stays off until you click Resume, which follows the same person again.
  • Stopped: tracking ended, with the reason (for example, nobody was where you clicked).

Follow a person runs entirely on the booth computer: the camera's picture never goes to the cloud for it and it works without internet. It checks the picture about four times a second while the person moves (two on a busy computer) and about once a second while they stand still in the middle, and in between it follows them on every frame of the picture. The tab shows what that costs. It keeps going when you choose another camera or minimize Tech Manager, and up to two cameras can follow someone at once.

Follow a person from the web app

The web app's Auto tracking tab works the same way: pick the person on the picture, then use Resume, Stop and Speed. The web app only sends your clicks; Tech Manager on the booth computer still does all the tracking, so it must be running and paired, like everything else on this page.

  • Starting or resuming tracking hands the camera to Tech Manager, so the web app stops reserving it for you. If someone else is driving the camera, tracking does not start: they have to let go, or you click Take control and then pick the person.
  • While it tracks, the camera reads "Follow a person is driving" and the controls stay on. Zoom in or out and tracking carries on. Pan, and you take the camera straight away (no Take control needed) and tracking pauses until you click Resume.
  • The box on the web picture can trail the person by a moment. The camera itself follows them without that delay.
  • If Tech Manager is offline, the tab says so instead of showing the buttons. Tracking that was already running on the booth carries on.
  • If the booth's Tech Manager is too old, the tab asks you to update it on the booth computer.
  • You need control of the camera to start, resume, stop or change the speed. Anyone who can see the camera can see whether it is tracking.

See who is driving a camera

Only one person drives a camera at a time.

  1. On Produce > Camera Control, open the camera.
  2. If someone else has it, their name and picture show on the camera's picture with how long they have had it (for example "Sam is driving"). A strip under the header lists everyone else driving a camera; click a name to open that camera.
  3. To take over, click Take control. They are told you took it.

Moving a camera reserves it for you ("You are driving"); it frees itself a few seconds after your last move.

While Follow a person is tracking a camera, the camera reads "Follow a person is driving". That is Tech Manager, not a person, so on the web app there is nobody to take control from: zooming leaves it tracking, and panning takes the camera at once and pauses tracking.

Troubleshooting

The page says "No PTZ Cameras Ready"

No device has PTZ control turned on. Open Patch > Devices, click the camera to open its side panel, open its Camera tab, turn on PTZ control and click Apply changes. Or click Add camera here.

The camera will not move

  • A yellow banner saying Tech Manager is offline means the booth link is down: controls and previews pause. Click Check now, or Reconnect booth if the booth looks online but controls stopped responding.
  • If the camera shows Offline or Unreachable, check its power and network, then click Refresh.
  • If the picture says someone else is driving, click Take control. They are told you took it.
  • On the web app, the controls stay off while the picture reads Connecting to live video…. See the next question.
  • If it never answers, open Camera settings and check the Camera IP, VISCA port and VISCA dialect. Many PTZOptics-style cameras use port 5678.

The web picture stays on "Connecting to live video…"

The line under it says why, for example that the live relay is not installed. In Tech Manager on the booth, open Produce > Dashboard and click Install or Start on the Live video relay card. When it runs, the web picture shows LIVE and the controls come on. Live video unavailable means waiting will not help until that is fixed.

The picture says "No RTSP URL"

Add the camera's RTSP URL in Camera settings. Without it you can still move the camera, but there is no picture.

A USB camera's picture says "USB camera: the picture comes from its vMix input"

Tech Manager never opens a USB camera's video itself, because vMix holds it. Make sure vMix is running and has the camera as an input, then open Camera settings and check the vMix input. If the hint under it says vMix is not running or has no camera inputs, the picture appears once vMix shows this camera.

The USB choice is greyed out

USB cameras are added in Tech Manager on the computer the camera is plugged into. The web app cannot see a computer's USB ports.

A notice says the camera's brand and model look wrong

The network scan sometimes names a camera after another kind of gear (for example an audio mixer). Renaming the camera does not fix it: open the camera's settings in Patch > Devices and set the right brand and model.

Built-in tracking shows an error

Built-in tracking runs on the camera itself, so it only works on cameras that have one (such as PTZOptics Move, SimplTrack and OBSBOT). Other cameras refuse it. Use Follow a person instead.

Follow a person loses the person or follows the wrong one

It recognizes the person by their clothes, so it works best when they wear something different from the people around them. Pick them when they stand clear of others, with the camera wide enough to show their whole body. If it keeps losing them, choose a slower Speed.

A preview went dark with a Resume or Reconnect button

The page paused the video to save bandwidth. If you moved to another browser tab, click Resume. If nobody touched the page for 15 minutes, it counts down the last minute ("Pausing live video in 0:42 — move the mouse to keep watching") and then asks Still there?: click Reconnect. Moving the mouse or pressing a key during the countdown keeps the video running. When the page pauses, it also lets go of any camera you were driving.

Good to know

  • Panasonic AW and Canon XC cameras can be driven over their own web control (choose it as the camera's Control protocol in Patch > Devices). Moving, zooming, presets, focus near and far, and the Target, Frame and Search tools work; focus lock, AF sensitivity, AF zone and built-in tracking need VISCA (Follow a person works on them too).
  • The Audio tab in the camera list shows the audio gear in Patch > Devices, for reference only.

Was this helpful?

Still stuck?

Journey can look at your own setup once you are signed in, or you can call us.