PTZ Control for OBS 0.17.0

[glikely]

in which the lights get turned back on

Here is a new stable release of the PTZ control plugin, updated to work with OBS Studio 31.0.0 and with many bug fixes and enhancements. Binaries for MacOS, Windows and Ubuntu 24.04 are all available, and you can compile from source to support other Linux distros. The build system has been completely overhauled to use the latest build scripts from obs-plugintemplate, making it much easier to get up and running.

VISCA support (UART, TCP and UDP) have had a lot of work to more closely follow the protocol. This should result in more reliable and responsive control. This includes adding support for cameras that don't use a sequence number over UDP, and being able to specifiy UDP connections by hostname instead of IP address.

Joystick support has also improved. It is now possible to choose how joystick axes and buttons are mapped to actions in the plugin.

Support for both ONVIF and USB UVC cameras has been added to the plugin. In both cases, this support is experimental and may not work as expected. Please file issues for any problems you have with these types of cameras.

There are also lots of quality of life fixes all over the plugin. Context menus are used in more places which allows buttons to be removed from the toolbar to clean up the interface. Status of autofocus and camera power is more reliable. Verbose protocol tracing only gets written to the log if OBS Studio is run with the --verbose flag, so that your OBS log file doesn't get overloaded with the entire protocol stream. The installers will now install the plugin to the updated plugins directory.

This release should also work with OBS Studio 30.0.0, but not all the visual elements will look right because the 31 series adds a new theme system which is used by this release. Version 29 and earlier are no longer supported.

If you've got a previous version of PTZ Controls installed, uninstall it before installing this version.

Happy broadcasting!

Checksums

obs-ptz-0.17.0-macos-universal.pkg: 1b58b156d89a4b25710c8bd8a8962d3074a2ebcddc4a4876113501c13ded4364
obs-ptz-0.17.0-source.tar.xz: 35814b9b269d099acb5ab3362d6db41e141376564218405c2d75993e553706bd
obs-ptz-0.17.0-windows-x64-Installer.exe: 403d5e06d81f2d4ed2e082e3f98f2a272cc6d4270c36107d82365e46cd94ee88
obs-ptz-0.17.0-windows-x64.zip: 12ee283ec8b083d88ddd169e7d7e7e7579dd2196c1e7e21fdf273d46ba7ecff7
obs-ptz-0.17.0-x86_64-linux-gnu-dbgsym.ddeb: 851353c89ad32085b6a3b8193d5daf0ff071704ba5b52dcc3863e75512bee349
obs-ptz-0.17.0-x86_64-linux-gnu.deb: 89d3533b0da008d78c8ed991184093fd55daffde2cb167fc7a037b2e8b257493

What's Changed

• USB PTZ control by @quartzo in USB PTZ control #210
• Some non initialized stuff on windows by @quartzo in Some non initialized stuff on windows #211
• Rework the context menu by @glikely in Rework the context menu #218
• Quirk: Support VISCA UDP without sequence field by @glikely in Quirk: Support VISCA UDP without sequence field #217
• Rebased onto latest obs-plugintemplate
• Updated to support OBS Studio 31.0.0 and later.
• Updated properties-view widget from mainline obs-studio
• Moved configuration control into a context menu
• Moved live-move lock from toolbar to camera list
• Added USB UVC camera support (courtesy @quartzo)
• Fixes to speed ramping and autofocus by @glikely in Fixes to speed ramping and autofocus #220
• Enable joystick by @glikely in Enable joystick #221
• Visca udp improvements by @glikely in Visca udp improvements #222
• joystick: fix deadzone calculation. by @glikely in joystick: fix deadzone calculation. #223
• Reenable debug tracing by @glikely in Reenable debug tracing #224
• visca: Fix crash on unresolved hostname by @glikely in visca: Fix crash on unresolved hostname #225
• Fixes to ENABLE_USB_CAM handling by @quartzo in Fixes to ENABLE_USB_CAM handling #226
• Add joystick axis/button mappings by @glikely in Add joystick axis/button mappings #230

Full Changelog: v0.15.4...v0.17.0

---

This discussion was created from the release PTZ Camera Control for OBS v0.17.0.

[Omar-L]

@quartzo is USB UVC support only for Windows and Linux?

[quartzo]

Yes. No clue how to do it on a Mac.

[glikely]

I should disable it on the MacOS build so the option doesn't show in the menu.

[glikely]

@quartzo, did you look at libuvc when adding the USB support? Would that be an easy(er) path to enabling macos?

[quartzo]

Typically, libuvc takes exclusive control of the USB device, which could prevent OBS from capturing the image simultaneously, so it's not a good fit. For macOS, camera control doesn’t rely on Linux’s V4L2 (Video4Linux 2) or Windows’ DirectShow frameworks. Instead, I found that macOS uses AVFoundation, Apple’s native framework for media handling, including video capture and device interaction.

[Gittly2]

Does the OBS PTZ Controll Plugon work wuth Windows 11??

[glikely]

Yes

[BillinAZ]

I installed obs-ptz plugin in Linux OBS version 30.0.2.1-3. OBS displays the video perfectly, However, the plugin does not see any devices. I have done the same installation on Windows 11 and obs-ptz works fine. I have researched the issue online and can't find anything that addresses the issue where the plugin doesn't see any devices.
Can you give me any help with this problem.
Thanks,
Bill