bitfocus / companion-module-requests

Repository for tracking module requests
101 stars 11 forks source link

PTZ-Director (NDI PTZ camera control app for macOS) #748

Open Ninakadin opened 2 years ago

Ninakadin commented 2 years ago

Today PTZ-Director for macOS was released, an app to control up to 4 NDI PTZ cameras from a Mac. The app has USB-HID joystick support and having Bitfocus Companion in mind, LiveSkills has implemented a rich AppleScript Interface to provide a useful integration into Companion for Stream Decks. Here is the documentation of the AppleScript commands: https://apps.apple.com/de/app/id1613397327 Each function is designed to be used as shortcut. An evaluation copy can be downloaded via TestFlight (requires macOS 12.x): https://testflight.apple.com/join/7vdMSs7V

LiveSkills is happy to support anyone working on this. If you need support, contact: info@liveskills.net

josephdadams commented 2 years ago

Applescript is great, but requires a middleman app to be run currently. Be a lot more efficient if you could implement a TCP API of some kind to allow for direct control over the network.

Ninakadin commented 2 years ago

Am I right that you would prefer e.g. a TCP Telnet interface with a kind of "AT command“ like interface, so there is no need for Companion to have software running on that Mac? If this is the case, do you have common protocols that are already in use by Companion? I mean, we don’t need to invent the wheel again ;-) Using AppleScript of course would require an app to run on the Mac, on the other hand AppleScript is a standardised interface. In general, yes, we could do that (with some minimal support, so that we take the right approach at first try), but would take some time.

josephdadams commented 2 years ago

Yes, something like that would be nice. If you can provide return data in the protocol, even better. Take a look at some of the Roland modules for a simple TCP protocol.

Ninakadin commented 2 years ago

@josephdadams Do you have a link to some documentation? Just the basics.

josephdadams commented 2 years ago

https://static.roland.com/assets/media/zip/XS-82H_83H_84H_reference_v30_eng03_W.pdf https://github.com/bitfocus/companion-module-roland-xs84h/blob/master/src/index.js

josephdadams commented 2 years ago

Once you have the protocol in place on your end, if you'd like to hire me to write the Companion module side, I'm available. You can find my email address on my Github profile.