- updated to ATEM SDK v6.6
- added support for running ATEM Macros
- updated to ATEM SDK v6.4
- updated to ATEM SDK v6.0
- re-added Edit menu to allow for Copy/Paste
- added Log window to show debug messages
- updated support for controlling DSKs
- added support for controlling SuperSource
- added support for setting Aux output source
- added support for specifying transition style
- added more control over downstream keyer states
- added support for controlling Media Players
- updated OSC-addresses help menu to display correct addresses for ATEM 2M/E and above switchers
- update to Blackmagic SDK 5.1
- prevent AppNap on Mavericks (thanks to @thetzel)
- bugfixes
- using Blackmagic SDK 4.2
- enhancements for Mac OS 10.9
- fixed numbering of upstream keyers
- added toggle functionality for keyers
- support for Mac OS 10.7 (updated binary)
- added support for controlling Upstream Keyers
- supports all available input-sources, depending on your switcher
- added help-menu with all OSC-addresses available
This is a Mac OS X application, providing an interface to control an ATEM video switcher via OSC. The code is based on the SwitcherPanel-Democode (Version 3.5) provided by Blackmagic. Additionally the control of a tally-light interface via Arduino is provided.
- VVOSC is used as OSC-framework.
- AMSerialPort is used for Arduino-connection
The current version is built for Mac OS 10.9 SDK (as of version 2.2.3). A compiled and runnable version of the atemOSC is included. Caution: The software lacks of many usability features (like input validation).
Program icon based heavily on the ATEM Software Control icon by Blackmagic Design.
Program and preview selection as well as transition control are exposed via following OSC addresses (addresses given below are for ATEM TVS model, actual values depend on your ATEM switcher and are shown in the help menu):
-
Cam 1
/atem/program/1 -
Cam 2
/atem/program/2 -
Cam 3
/atem/program/3 -
Cam 4
/atem/program/4 -
Cam 5
/atem/program/5 -
Cam 6
/atem/program/6 -
and so on...
-
Black
/atem/program/0 -
Bars
/atem/program/7 -
Color 1
/atem/program/8 -
Color 2
/atem/program/9 -
Media 1
/atem/program/10 -
Media 2
/atem/program/12
For preview selection /atem/preview/$i can be used.
- T-bar
/atem/transition/bar - Cut
/atem/transition/cut - auto
/atem/transition/auto - fade-to-black
/atem/transition/ftb
To set the transition style of the Auto transition:
- Mix
/atem/transition/set-style/mix - Dip
/atem/transition/set-style/dip - Wipe
/atem/transition/set-style/wipe - Stinger
/atem/transition/set-style/sting - DVE
/atem/transition/set-style/dve
Additional options.
- Set Aux $i source to $x
/atem/aux/$i $x- Where $x is a valid program source. Check the Help Menu for the correct values.
- e.g.
/atem/aux/1 1to set Aux 1 output to source 1 (Camera 1) - (up to
/atem/aux/6 $x, depends on your ATEM switcher)
- Toggle Upstream Keyer 1
/atem/usk/1(up to/atem/usk/4, depends on your ATEM switcher) - Prepare Upstream Keyer 1
/atem/nextusk/1(up to/atem/nextusk/4, depends on your ATEM switcher) - Auto Toggle On Air Downstreamkeyer 1
/atem/dsk/1(up to/atem/dsk/4, depends on your ATEM switcher) - Force On Air Downstreamkeyer 1
/atem/dsk/on-air/1 <0|1>(up to/atem/dsk/4, depends on your ATEM switcher)- Where
<0|1>is an int-value of 0 (disabled) or 1 (enabled)
- Where
- Toggle Tie Downstreamkeyer 1
/atem/dsk/tie/1(up to/atem/dsk/tie/4, depends on your ATEM switcher) - Force Tie Downstreamkeyer 1
/atem/dsk/set-tie/1 <0|1>(up to/atem/dsk/4, depends on your ATEM switcher)- Where
<0|1>is an int-value of 0 (disabled) or 1 (enabled)
- Where
- Cut Toggle Downstreamkeyer 1
/atem/dsk/toggle/1(up to/atem/dsk/toggle/4, depends on your ATEM switcher) - Set Media Player $i source to Clip $x
/atem/mplayer/$i/clip/$x- e.g.
/atem/mplayer/1/clip/1(up to/atem/mplayer/1/clip/2, depends on your ATEM switcher) - e.g.
/atem/mplayer/2/clip/1(up to/atem/mplayer/2/clip/2, depends on your ATEM switcher)
- e.g.
- Set Media Player $i source to Still $x
/atem/mplayer/$i/still/$x- e.g.
/atem/mplayer/1/still/1(up to/atem/mplayer/1/still/20, depends on your ATEM switcher) - e.g.
/atem/mplayer/2/still/1(up to/atem/mplayer/2/still/20, depends on your ATEM switcher)
- e.g.
- SuperSource (when available)
- Toggle SuperSource Box $i enabled
/atem/supersource/$i/enabled <0|1>- Where
<0|1>is an int-value of 0 (disabled) or 1 (enabled)
- Where
- Set SuperSource Box $i source to input $x
/atem/supersource/$i/source $x- Where
$xis a valid program source. Check the Help Menu for the correct values.
- Where
- Other options are available. Check the Help Menu for the full list.
- Toggle SuperSource Box $i enabled
- Macros
- Macros should be recorded within the ATEM Control Panel software.
- Macros are stored within the ATEM in a 0-index array
- This means that to access the first recorded Macro, you should use an index
$iof0, to access the second recorded Macro, you should use an index of1etc.
- This means that to access the first recorded Macro, you should use an index
- Get the Maximum Number of Macros:
/atem/macros/get-max-number- Returns an
intof the maximum number of Macros supported by your ATEM - Access to these Macros should be used via an index of
n-1
- Returns an
- Stop the currently active Macro (if any):
/atem/macros/stop - Get the Name of a Macro:
/atem/macros/$i/name- Returns a
stringwith the name, or "" if the Macro is invalid
- Returns a
- Get the Description of a Macro:
/atem/macros/$i/description- Returns a
stringwith the description, or "" if the Macro is invalid
- Returns a
- Get whether the Macro at index $i is valid:
/atem/macros/$i/is-valid- Returns an
intof0|1to indicate whether the requested Macro is valid
- Returns an
- Run the Macro at index $i:
/atem/macros/$i/run- Returns an
intof0|1to indicate whether the requested Macro was executed. A0will be returned if the Macro is invalid, or does not exist
- Returns an
All OSC-addresses expect float-values between 0.0 and 1.0 unless otherwise stated.
A full overview of all OSC-addresses available for your switcher can be obtained from the help-menu inside the application.
This software has been used successfuly with TouchOSC on the iPad. A TouchOSC-interface for the iPad can be found in the repository.
This software has been used successfuly with ControllerMate and X-keys via sendOSC and iTerm 2. An example ActionScript for use within ControllerMate can be found in the repository.