~martijnbraam/pyatem

Python lib for controlling Blackmagic Design ATEM video mixers
778aeee5 — Peter Newman 8 months ago
Initial basics of ATEM 2 M/E Production Studio 4K
893df89c — Peter Newman 8 months ago
Add Atem 2 M/E Prod Studio 4K to udev rules
fb87d2c4 — Thomas J. Duck 2 months ago
Documentation updates. Changed incorrect index descriptions. Created placeholders for missing function parameter descriptions. A few additional minor tweaks.

clone

read-only
https://git.sr.ht/~martijnbraam/pyatem
read/write
git@git.sr.ht:~martijnbraam/pyatem

You can also use your local clone with git send-email.

#PyATEM

Library implementing the ATEM video switcher protocol and a GTK3.0 application

Screenshot of the control application

#Installation

Install the pyatem protocol module::

setup.py build
sudo setup.py install

Build and install the gtk application and proxy::

meson build
meson compile -C build
sudo meson install -C build

Run the application::

switcher-control

There is also the openswitcher-install.sh script which will install the library, proxy and gtk application in /usr/local for a quick installation of all components.

#External dependencies

The only external dependency for pyatem is pyusb for the USB protocol support. It contains a native compiled module so it also requires a toolchain and python-dev headers at build time.

OpenSwitcher depends on the python bindings from gtk3.

OpenSwitcher-proxy only depends on pyatem for the core functionality but it might need more dependencies when loading specific frontends or backends:

  • MQTT Frontend: paho-mqtt

#Developing

To work on the pyatem library the quickest way to get up and running is using the openswitcher-develop.sh script that will install the pyatem library in devel mode where the files are symlinked to the git repository. It will also install the proxy and gtk application in /usr/local which will use the symlinked library.

Development happens on matrix on #openatem:brixit.nl

#Proxy

There is also the openswitcher_proxy python module in this repository. It will run an API wrapper around one or more ATEM switchers. There is currently a single api supported which is a HTTP REST api for sending commands and reading the mixer state.

It can be run by starting the module::

python3 -m openswitcher_proxy --config /etc/myconfigfile.toml

Or if the software installed it can be started using the launcher script::

openswitcher-proxy --config /etc/myconfigfile.toml

The default config location is /etc/openswitcher/proxy.toml if not specified. Here's an example config:

[[hardware]]
id = "mini"
label = "Atem Mini"
address = "192.168.2.84"

[[hardware]]
id = "mini2"
label = "Local switcher"
address = "usb"

[[frontend]]
type = "http-api"
bind = ":8080"
auth = true
username = "bob"
password = "hunter2"
hardware = "mini,mini2"
 
[[frontend]]
type = "status"
bind = "127.0.0.1:8082"
auth = false

The status frontend provides a simple html page with the state of the connected switchers and a list of the enabled frontends.

The http-api frontend provides a HTTP server that can return any of the supported fields as json and trigger commands by sending a HTTP POST request with formfields or json

#Translations

The main language for the software is english, the translation for the project happens on https://hosted.weblate.org/projects/openswitcher