Pan Tilt Zoom (PTZ) Controls for OBS Studio

Plugin for OBS Studio to add a PTZ Camera control dock.

Features:

• Pan, Tilt, and Zoom controls
• Auto and manual focus
• Save and recall camera presets
• Control any number of cameras
• Auto select active camera based on active scene
• Control camera power
• Whitebalance control
• Supported protocols
  • VISCA
  • VISCA over UDP (Sony protocol)
  • VISCA over TCP (PTZ Optics and others)
  • Pelco-P
  • Pelco-D

OBS project resource page

#obsptz on Twitter

Build Instructions

Linux

• Install OBS Studio including headers
  • Follow instructions for your distribution: https://obsproject.com/wiki/install-instructions
• clone this repository and build:

git clone https://github.com/glikely/obs-ptz
mkdir obs-ptz/build
cd obs-ptz/build
cmake ..
make

Copy or symlink ptz-controls.so into the OBS plugins directory. Typically /usr/lib/obs-plugins.

Windows

To simplify development it helps to include MSBuild, 7-Zip, and Inno Setup Compiler in your default path (Search for 'Edit the System Environment Variables' in the Windows search bar).

This project contains a helper script for building the plugin that assumes that obs-studio and obs-ptz share the same top level directory. It also assumes that Qt5 is installed under c:\Qt\. If you have Qt5 installed or obs-studio checked out somewhere else then you'll need to modify the winbuild and winrun scripts.

Both 32 and 64 bit versions of the plugin will be built if you've built both version of OBS Studio. Edit the script if you only want to build one version.

• Build OBS Studio using instructions on OBS-Studio Wiki: https://obsproject.com/wiki/Install-Instructions
• Clone this repository into a working directory
• Run scripts\winbuild.cmd to build the plugin
• Run scripts\winrun32.cmd or scripts\winrun64.cmd to run OBS either the 32bit or 64bit version of the plugin

From Powershell:

git clone https://github.com/glikely/obs-ptz
cd obs-ptz
.\scripts\winbuild.cmd
.\scripts\winrun64.cmd

Use the scripts\winbuild-rel.cmd script to build the release version of the plugin as a zip file and installer. You'll first need to build a RelWithDebInfo version of OBS Studio before building the release plugin.

Contributing

Contributions welcome! You can submit changes as GitHub pull requests. Or email patches to me at mailto:[email protected]

See CONTRIBUTING.md for details.