PTZOptics OBS Plugin

Control Cameras, Integrate Hotkeys, and much more!

OBS PTZ Plugin Guide OBS PTZ Dockable Modules Guide

PTZOptics OBS Plugin & Dockable Controllers


The Open Broadcaster Software platform can handle advanced video production setups for those who understand how to use it. The PTZOptics OBS Plugin can be used with NDI, to increase functionality. You can use PTZOptics cameras in OBS to control the cameras with a USB connected Xbox Joystick. The plugin allows users to quickly take control of PTZ cameras inside of OBS but more advanced users often prefer using custom HTTP commands inside OBS to automatically call PTZ camera presets when a scene is clicked.

A “PTZ” or pan, tilt, and zoom camera preset is a saved camera location stored inside a PTZ camera. This “PTZ Preset” can be used to quickly move a robotic camera to a known location in your studio. PTZOptics has continued to listen to the OBS community and make improvements to the plugin including support for hotkeys. Using only an Xbox joystick, plugged into your computer via USB, you have the ability to fully control PTZOptics robotic cameras over an ethernet connection on your local area network. 

About the OBS Plugin:

Download the PTZOptics camera control applications available for both Mac or PC here (An OBS plugin is also available) for Open Broadcaster Software on Windows machines. These stand-alone PTZ camera control applications have the following features:

  1. Control up to 8 PTZOptics cameras over an IP connection (LAN)
  2. xBox Joystick Controller Support (PC Only)
  3. Compact, Advanced and Preview Modes
  4. Live Video Preview Mode with automatic camera switching (Windows Only)
  5. Full Screen Camera Preview Modes (SD & HD Options for bandwidth conservation) (Windows Only)
  6. Name each unique camera
  7. Set up to 9 camera presets
  8. Name each unique preset & capture image representations
  9. Pan, Tilt and Zoom Speeds
  10. Pan & Tilt Speed Locks
  11. Iris Controls
  12. Focus Controls (With Focus Speed)
  13. Selectable exposure modes (Auto, Manual, SAE, AAE, and Brightness)
  14. Advanced image controls for Contrast, Luminance, and Hue
  15. Select between exposure modes
  16. Flip and Mirror camera image
  17. On Screen Display Controls
  18. Real-time reporting of camera options status

After you have the plugin installed, go to the main menu on the OBS dashboard and click on “TOOLS” to find the new “PTZOptics controller” feature. Clicking on this will bring up the PTZOptics Control pane, and you can immediately see that it offers complete control for up to eight cameras. To set up the Xbox up on OBS, click the settings tab at the top of the PTZOptics Control pane and select “Joystick Settings.” A small box opens up and if you have an Xbox Joystick connected; it will be indicated inside the box. Now all you have to do is check the square that says ‘Use Joystick’ and click okay. That connects the Joystick to OBS and your PTZOptics cameras. 

Additionally inside the PTZOptics Control pane, you have buttons to store camera presets. Some OBS users have reported that it is easier to build PTZ camera controls into each scene using a “Browser” input. To do this you can use the new HTTP-CGI Command Sheet from PTZOptics. This allows you to select a command and build it into your OBS scene via the web browser input. You can download the HTTP-CGI Command Sheet here PTZOptics.com/Downloads. This is an interesting example of extending the power of OBS with a video production plugin.

About the Dockable Controllers

Dockable Camera Control Modules in OBS

Using versions of OBS 24.0 and newer you can set up dockable PTZ camera controls inside of your OBS interface. Once you have downloaded the latest 24.0 (or greater) version of OBS, you can install it and find a new feature for “Custom Browser Docks”.

The new feature used to create custom dockable PTZ camera controllers are called “Custom Browser Docks” and it can be found under the main “View” dropdown menu nested in the “Docks” area. You can download our pre-designed PTZ camera control modules for use with OBS or customize your own with the downloads on this page. 

Download Here



Note: You must have the most up to date firmware to use these apps
You can check to see if your camera is running the latest (v6.2.50 or later) version of our firmware. You can download the latest firmware here