We have a Pastor who is partial to graphical illustrations. Especially in our current climate of COVID, we've struggled with the best way to display them for our online viewers. Going to fullscreen graphics for long enough to absorb them can detach you from the speaker. Picture-in-picture can be awkward (inexperienced camera operators mess up the timing or placement of the transition) and tiny (40% of our often-mobile audience is watching on < 720p). What we finally settled on was general use of split screen graphics, so viewers can see the speaker and a sizeable image simultaneously. This looks great, but can still be awkward to transition to traditionally, requiring precise coordination between your technical director, graphics operator, and camera operator.
I started to explore options to solve this problem, and discovered that people have been able to do animated transitions of the SuperSource on Blackmagic Design ATEM switchers using nothing but some clever scripting. In particular, I found this excellent article by Ian Morrish where he does this, and also provides a flexible Windows Powershell library for doing this and more with an ATEM. Taking his groundwork and implementing a sleek solution to automate fly-ins of our side graphics was fairly easy.
Concept
Pre-Requisites
- A general comfort with scripting: This project uses Microsoft Powershell scripts. I don't have the time to provide you scripts that are 100% fool-proof and robustly ready to use in your exact situation, so you will need to tinker at least a little bit under the hood by adjusting some things. Powershell is super easy, though, so comfort with any basic scripting should be enough to get started; I actually hadn't done much with Powershell before starting this.
- A Windows 10 Computer with ProPresenter 7: Sorry, Mac users; because this project uses powershell as its script language of choice, and relies on Ian Morrish's ATEM Powershell library, it is very specific to running on a Windows computer. The theory here could easily be adapted to other scripting environments on other systems, but you'd be starting from scratch and on your own.
- A Blackmagic Design ATEM Switcher with SuperSource: This means a ATEM 2 M/E or higher. It does not include the ATEM Mini or Mini Pro, or the ATEM 1 M/E. No way around this; SuperSource is where the magic happens. NOTE: My scripts are setup such that you are using your 1 M/E for output (it will always use the SuperSource as it's source) and doing actual camera switching on 2 M/E. I hope to expand this article later with a few ideas of other ways to do this that I explored, but right now if you want a different setup you will need to modify things.
- ATEM Software installed on the computer: Like most third party libraries that access the ATEM, you have to have the actual blackmagic design ATEM software installed on your computer. Make sure you've launched it once to see it can connect to your switcher.
- Propresenter 7 output is sent to your ATEM via some keyed method: The explanations below rely on the left half of your image slides being transparent as seen by the ATEM, so however you connect from ProPresenter 7 to the ATEM needs to support transparency. Key/Fill is preferred, Chroma or Luma key would probably work too.
- Bome Midi Translator Pro - If you do ANY work with MIDI triggers you should already consider having this in your toolkit. It allows you to take simple MIDI signals (such as those done by ProPresenter) and translate them into any number of different, complex tasks. This is how I glue ProPresenter 7 midi triggers to Powershell scripts. The steps below assume you've already set up a connection so that ProPresenter MIDI output is going to a Bome Translator virtual input.
Getting Started
- While not strictly necessary, having a good development environment for PowerShell will help you a lot with adjusting things and testing. Ian Morrish has good instructions for setting up the 32bit PowerShell ISE here. Configuring the ISE lets you open the scripts (in step 3) and easily run them with debug output independent of any of the other pieces, and validate they are working ok.
- Download Ian Morrish's ATEM powershell library (switcherlib.dll) from this site and place it some place you can remember (His suggested location of C:\Users\[UserName]\Documents\WindowsPowerShell\SwitcherLib.dll is fine). NOTE: as briefly alluded to on that page, current versions of Windows 10 have a security feature where .dll files downloaded from the internet are automatically blocked from use. After placing your file, you need to Right Click->Properties and you will see either a checkbox or button (depending on your exact version of Windows 10) to allow. Make sure you do this or later steps will inexplicably fail with ambiguous error messages.
- Download my adaptation of Ian Morrish's automation example script by using this Google Drive link. Place them someplace you can remember. NOTE: Powershell scripts like those contained in this download have the capability of executing arbitrary code on your computer. You should ONLY run scripts you trust and know the origin of, or better yet review the code yourself to make sure they're doing what you expect and nothing extra or malicious.
- After you've placed the scripts, open both of them in the editor of your choice. At the very top of each, there are two variables. ATEMipAddress needs to be set to the IP of your ATEM, and LibPath needs to be set to the location of Ian Morish's ATEM powershell library you downloaded in step 2.
- Generate a 10x10 transparent PNG (OR, ALTERNATIVELY, WHATEVER CHROMA/LUMA YOUR ATEM SEES AS TRANSPARENT) file using this website. We'll use this when building our ProPresenter slides. For the transition effects we will be using to work properly, our "empty"/clear slide must have a foreground image.
Configure Your ATEM
- Set your ATEM 1 M/E source to SuperSource.
- In the SuperSource configuration, set the Box 1 source to 2 M/E Program. Set the scale of Box 1 to 1.0, and the Crop and Position values to zero.
- Set your 2 M/E Program to a camera. You will do all camera switching on your 2 M/E.
- Make sure your downstream key is turned on so you can see output from ProPresenter overlaid
- Monitor your 1 M/E program output.