Companion runs on Windows, Mac, and Pi.
QUICK-LINK DOWNLOADS
Here’s a consolidated list of software downloads for the 6 Segments we will dive into below:
** UPDATED November 2, 2023 **
COMPANION (3.1.2)
Download Companion:
- The DJF Companion Profiles require running Companion 3.1.2 or later to support the most up-to-date features and modules.
Open Companion
- Companion’s Web Server icon will be in the top-right menu bar. Click it to open the tray.
- Check the server is running locally on 127.0.0.1 (easiest setup).
- Set the Port to 8000
- Launch GUI in a web browser.
Install the DJF Companion Profile
- Navigate tabs to Buttons > Import/Export.
- If you already have your own custom Companion setup, click “Export” to save a backup of your profile first!
- Replace Current Configuration (recommended)
- Select Import. Choose the DJF Companion Profile file (ends with “.companionconfig”)
- Select “Replace current configuration”.
- **Note that this will wipe all existing Companion pages, so make sure you’ve backed up any essential work first!
- Individual page import (not recommended)
- Note that the DJF Companion Profile pages are heavily inter-connected, hence it is recommended to “replace current configuration”. While you can copy and paste buttons quite easily after the initial “replace current configuration”, importing individual pages will require manually updating the Page-jump actions, plus you must be careful to target the correct instance label of a module when importing.
- If you still wish to import individual pages, note that there are also several “backend” service pages need to be imported to very specific pages to maintain integrity:
-
-
-
- Backend service pages for v3.1:
- Extreme………..Pages 55, 56, 57, 58
- Pro………………Pages 83, 84
- PTZ……………..Pages 86, 87
- Backend service pages for v2.5:
- Pro………………Pages 22, 23
- Backend service pages for v3.1:
-
-
-
- Once those backend pages have been imported to their specific page numbers, you can import individual pages to any other Companion page.
- If dealing with a dual profile that contains both ATEM Extreme and ATEM Pro, make sure you target the correct instance (i.e. “ext-atem” and “pro-atem” are completely different implementations of the same ATEM Module).
- Note that any Menu or Page-jump buttons will need to have their action “Set surface with s/n to…” updated manually.
- For example, if you wanted to import the Extreme’s VLC page:
- Import DJF Companion Profile Pages 55, 56, 57, 58 to their respective Pages, 55, 56, 57, 58 in your Companion profile.
- Import the Extreme VLC (Page 30) to whatever blank page you have available in your configuration.
- Update the Page-jump button actions (ie VLC Page’s Button #1) to target your configuration layout.
- Once those backend pages have been imported to their specific page numbers, you can import individual pages to any other Companion page.
Set ATEM Module’s Target IP Address
-
- Under the Connections tab, click “Edit” for the “atem Blackmagic Design” module. Update the Target IP to the IP address for your ATEM Mini/Pro/ISO, and for your ATEM Mini Extreme/ISO if running dual systems.
- **Note: it is recommended to keep the connection labels the way they are (i.e. “ext-atem” and “pro-atem” etc.) Changing the connection label names will update most – but not all – variable names, and will leave some button text (i.e. the BLK button) unable to find the new name.
- **Note: you can find the ATEM IP using BlackMagic’s “ATEM Setup Software”. Setting a static IP address is recommended.
- All other modules (VLC, H2R, VICREO, OSC) are pre-set to local 127.0.0.1 and don’t need to be changed.
- Under the Connections tab, click “Edit” for the “atem Blackmagic Design” module. Update the Target IP to the IP address for your ATEM Mini/Pro/ISO, and for your ATEM Mini Extreme/ISO if running dual systems.
Set the Home Page
-
- Under the Surfaces tab, click the green “Settings” button for the “Elgato Streamdeck Plugin” (or the actual Stream Deck serial number, if running Companion solo).
-
-
-
- Slide the Page number for your specific profile’s HOME PAGE:
-
-
-
-
-
-
- DJF PROFILE v3.1
- 32-button Extreme…………………..PAGE 1
- 32-button Pro…………………………PAGE 66
- PTZ……………………………………..PAGE 88
- Vertical Pro…………………………….PAGE 96
- Vertical Extreme……………………..PAGE 98
- DJF PROFILE v3.1
-
-
-
-
-
-
-
- DJF PROFILE v2.5
- 32-button Pro…………………………PAGE 1
- 15-button Pro…………………………PAGE 31
- Vertical Pro…………………………….PAGE 71
- DJF PROFILE v2.5
-
-
-
Make Changes to Companion’s Settings
-
- “Remove the Topbar on all buttons”:
- Go to Companion > Settings > Navigation Buttons > “Remove the topbar on each button” > SELECT “Enabled”.
- **Note that the PNGs and text layout on the DJF Companion Profile buttons have been designed for the full 72 x 72px.m The buttons will look squished unless you remove the topbar.
- “Enable OSC”:
- Go to Companion > Settings > OSC > SELECT “Enabled”.
- Set the OSC Listen Port to “12321”.
- “Remove the Topbar on all buttons”:
Troubleshooting:
-
- If your Stream Deck is plugged in but the Companion buttons are not showing up, go to Companion’s “Surfaces” tab, and click “Rescan USB”
- If you’d like to run this without a the actual Stream Deck hardware (i.e. use it on a computer or tablet instead), click on “Emulator” in the top left corner. Locally, the address will be http://127.0.0.1:8000/emulator
- If there’s a conflict while running Elgato Stream Deck’s native software simultaneously with Companion, quit both applications.
- Then try opening Elgato’s Stream Deck software first;
- then starting the Companion server secondly.
- (Make sure the Companion Plugin within the native Elgato Stream Deck app has been installed – see “Stream Deck” installation instructions below).
Recommended Hardware:
Canon CR N300 PTZ – BH: https://bhpho.to/3td1dbG Amazon: https://amzn.to/3GQD68l
Canon CR N500 PTZ – BH: https://bhpho.to/3aq6yG3 Amazon: https://amzn.to/3zl9gY0
Elgato Stream Deck XL – BH: https://bhpho.to/3tkNnnF Amazon: https://amzn.to/3xfqGCK
Netgear 8-port Unmanaged POE+ Network Switch: BH: https://bhpho.to/3NoQRO6 Amazon: https://amzn.to/3zfKTed
Beryl Travel Router: https://amzn.to/3MqCdnX
Hello David,
Companion version 2.2.0
At this moment 2.2.0 is still in beta with many branches. Which one is the bare minimum or tested?
Joshua
Hi Joshua, I just generally grab the latest build.
Do you have a step by step install process for Raspberry Pi? I have a Stream Deck XL attached to a Pi 4 (8GB) of ram. I installed the Companion version of the Pi build. The Pi is on my network. Stream Cast software (5.0) is on a Mac mini on the same net. I want the Pi to run the stream deck only. My intention is to leave every other app on the Mac mini. Will this work?
Hi Steve, the actual install of my Companion Profile onto a Pi is very easy because it’s the same import config process within a web browser. Getting a Pi up and running is a bit more involved. I may make a video on it in the future, but for the meantime, take a look at the CompanionPi guidelines on GitHub https://github.com/bitfocus/companion/wiki/Manual-Install-on-Raspberry-Pi
Hello David,
How do you get your video-playback from vlc to show-up in your Atem Multi-view? My video-playback shows-up only “Local” (outside of the Atem Mini) and not within the Atem Mini Multiview (this means I can’t see it within Preview or Program or Input 4) like your demo. However, vlc does work and I’m able to see loaded videos.
Everything else works too. And am extremely happy to have bought this splendid product of yours. Nonetheless I had to get touch in case you’ve already answered this question for another customer of yours, in which case, you’d only have to copy and paste. Please help. Sorry for not being able to pay the $150 per hour; you’re definitely worth it! Regards, Joan
Hi Joan, Have you connected your Macbook to the ATEM via HDMI? You’ll likely need a USB-C to HDMI adapter. Then set your Mac to dual screens (not mirrored), and within VLC, set the Video to target that output in full screen. Take a a look at the VLC section above, and let me know if that answers the question! 🙂
I DID IT!!! IT WORKED. BRILLIANT! Thanks David. I owe you one;-) Luv, Joan
Wonderful! Glad you got it sorted!!
Hi David,
Congrats on the new product roll-out. I have seen your earlier work with the ATEM mini pro and I have been eagerly awaiting the Extreme version. I have 2 questions before I purchase:
1. I have 5 cameras. The VLC input on hdmi 4, as instructed) above, is not super convenient. As long as there aren’t too many (Companion page) dependencies, is it fairly simple to make changes so that VLC could be plugged in to input 6?
2. I understand how to get VLC to output full screen on a not-mirrored “second display”. How would H2R Graphics come into play here as an input on the Extreme? Would it be full screen output on a third display? Is it possible to serve both VLC and H2R from the same MacBook Pro? How would you connect 5 cameras, VLC and H2R Graphics to an ATEM Extreme? Do I need 2 computers? (one for VLC, one for H2R)
Thanks for your help.
Scott
Hi Scott,
VLC for the Extreme has been updated to run on either inputs 7 or 8. H2R runs on Input 8, so you can either swap between VLC/H2R on a single HDMI connection via input 8, or you can run both simultaneously with VLC on 7 and H2R on 8.
I actually run everything from my one Macbook Pro – that is Companion controlling the Stream Deck, and two USBC-HDMI adapters for VLC on input 7 and H2R on Input 8.
Hope that helps!
David
That certainly does help, David. Thanks! Now I have 5 cameras on inputs 1-5. My macbook is running an aux screen for more desktop space (ATEM Software Control), as well as 2 additional screens so I can have H2R Graphics and a full-screen web browser on 2 separate inputs (8 and 6). I also have a Mac Mini connected to have my Zoom chat running on the main desktop and on the second screen is the full screen VLC playback. (input 7)
I have no more inputs remaining. Looks like I’ll have to upgrade to the ATEM mini Extreme Pro Micro-Ultra ISO.
Cheers,
Scott
Yes, or whatever TV Studio/SDI replacement BMD brings out next!
Hi David.
Bought your full package. Great work!
I need to run 2 ATEM Mini Pros side by side. Will it be a good approach to do a full install in companion, then erase the EXT pages, copy pages 66 and higher to the blank area and adjust the TARGET IP of the second ATEM Mini Pro?
Will it suffice to do this once on the instances settings or will I have to do it on all pages where the target is mentioned?
What else would I need to do?
Your comments will be appreciated.
Thanks in advance
Klaus
Hi Klaus, interesting scenario! That should work – as you re-import pages 66+ into page 1+, make sure you create a new instance (ie “pro2-atem”). Most, but not all of the labeling will carry over (for instance, check the feedback labels on the BLK button). And then the main challenge is that all the buttons that have a long press secondary function (and there’s a lot of them!) will need to have their paths updated to the new back-end pages, and the new page jump numbers.
Hi Joshua, in the download of TRIAL version Streamdeck 15 I don’t find the Streamdeck profile – or is it not included?
Thanks. Ulfert
Hi Ulfert – correct, the trial version includes the 1-page Companion profile that will allow testing of the ATEM, H2R, VLC, and VICREO modules. It doesn’t include the bonus native Stream Deck profiles or the ATEM Macros. Hope that helps!
Hi David, my stream deck and companion seems to be working but i cannot launch H2R graphics with companion. I do not know what am doing wrong. I receive an error message and do not know what am doing wrong even though i followed all the necessary steps.
Hope you can help me out of this.
Lawrence, Canada
Hi Lawrence – if you’re running H2R on your local machine, make sure your module is set to 127.0.0.1 and OSC port 8181. If you’re still stuck, send me some screen shots of your set up/computer/program versions 🙂
I am running a PC desktop. I will utilize 3 cameras. I have a large wall monitor to run the multi view function of the ATEM mini pro when live streaming. Is it possible to add a second monitor that only works as a monitor to use as a workspace when only doing things like Excel, Word, emails, etc.?
Hi Jack, if you add in an HDMI splitter hardware, you can mirror the desktop view to both HDMI 4 in the ATEM Mini Pro, and also to a secondary monitor to see what you’re doing clearly. Probably $30 on Amazon.
HI DAVID,
Yesterday I purchased the extreme version. Has changed relatively much from the first demo. Do you plan to upload a video explaining all the functions, I would be very happy.
Thanks in advance
Ilan Ben Shabbat
Hi Ben, thanks for your support! The Extreme has plenty more in it…I’m setting up for some livestreams to demonstrate – stay tuned!
Thank you very much … looking forward to it.
By the way, I did not receive in the package the ATEM Macros.
Is it supposed to be there?
There are two downloads, and the ATEM macros are in the second folder
Got it, thanks
Hi David, after buying your full package I have spent quite a lot of time adapting settings and pages for a Windows environment but particularly to move stuff over to your ATEM Mini Rig with a Raspberry Pi.
I have not found a proper way to get VLC and H2R working. Much like Lawrence Tay H2R seems to be particularly reluctant to communicate with Companion.
Please HELP
Hi Hans, my current understanding of H2R v0.4 is that it has not been fully tested to run on the Pi. Instead set the IP address to your computer and run H2R on that. Also, try out v2 of H2R as you can run it on your computer, but then connect the Pi HDMI output to the ATEM.
VLC does run on Pi, though I found it snappier on a computer, and easier to navigate.
Key takeaway is companion on a Pi as the brain, and applications distributed over the network.
Bonjour, impossible d’importer DJF_H2R_Graphics.json à chaque fois cela me met Import failed…
Merci pour votre réponse et votre travail
Hi Yves, are you running v1 or v2 of H2R? The DJF profile was built for v1 H2R.
Tout est ok !!!
MERCI
Bonjour,
Aïe … v2.4.0 !!!
Ou est-ce que je peux la télécharger ?
Merci beaucoup pour votre rapidité de réponse.
Cordialement
Tout est ok !!!
MERCI
J’ai juste encore un problème avec VLC … Cela me met “error” sur Companion…
TOUT EST OK !
MERCI MERCI MERCI
Glad you were able to work it out! Best, David
Enfin pas vraiment, car il m’est impossible de connecter Companion avec le logiciel Stream Deck !
Pourtant j’ai tout essayé…
Bon… plus qu’un problème ! Mais il est de taille…
Le Companion ne veux pas se connecter au soft Stream Deck.
Et dès que je valide la case “Use Elgato Plugin for StreamDeck access (Requires Companion restart)”
Je ne peux plus scanner le pupitre Stream Deck et il m’indique : “Ignoring Stream Decks devices as the plugin has been enabled”
Je suis perdu pourtant j’ai tout essayé !
HELP ME
Je viens de tout réinstaller mais c’est exactement la même chose sur PC
Companion v2.2.0 (3721)
Et sur MacBook Pro
Companion v2.2.0 (3719)
Impossible de connecter Companion et Stream Deck !!!
Yeeeaaahhhh !
J’ai trouvé la solution : il faut installer la version v2.2.0 (3523)
Sinon cela ne marche pas !!!
Pouvez-vous me dire quelle est la meilleur version ?
Car il y en a tellement…
Merci
Hi David, I’m wondering how far along you are with the update of a modified companion profile for H2R’s V2. Can we expect an update?
Hi Hans, I’ve started experimenting with it, but haven’t yet configured a universal layout. I suggest creating one of each of the graphic elements within the app, and then using the auto-populated Presets that will appear in the Companion H2R module to get started right away.
Hi David.
I have just bought your profile but i can’t find the companion 2.2.0 version. I can’t download it from your link in the instructions. Is there another place I can get the beta version from?
Regards,
Andreas
Hi Andreas, the link appears to be working for me. Here is is again if that helps: https://bitfocus.io/companion/download/builds/ Thanks, David.
Hi David
Trying to follow your instructions but can’t get past the set a static IP address for the atem switcher. I originally tried to set the static IP on the atem to the IP address I found in the target IP I found in the connection area of the companion software. But I got an error on the atem setup saying “Please check gateway address 0.0.0.0 can’t be used”. I’m not sure what to change the gateway address to and can’t find any mention in the instructions. any ideas as to what I need to do with the gateway address?
Hi Mick, it will depend on your router settings, but a common gateway is 255.255.255.0
Hi David, hoping to get started but the link above doesn’t lead to a download for VICREO 3.0.3 – can you suggest another place for a Windows version of this? Thanks!
Hi Nick – the link has been updated for version 5 of VICREO, thanks!
Hi David, I’m having trouble finding the “ DJF 3.1 H2R2.json” file to import into H2R. Which package do I find it in please?
Hi Dion, 3.1 is now available in the downloads section. The H2R2 file is in the “DJF 3.1 ASSETS” folder.
Hi David, Perhaps this has already been answered but can’t find it. I have H2R and VLC working on the same computer, but I am using the M1 Macbook Pro and can only use one HDMI into the ATEM Extreme. I have them both configured for Port 8 on ATEM, but every time I use VLC, it plays fine but then kicks the H2R green screen to the background and displays the second desktop. I have to manually use mission control to select the full-screen H2R green screen to select it back. Is there a way to prevent this or have it reset to show the H2R green screen after VLC plays using the same HDMI port for both?
Hi Sean – it’s a good question. In the early days I had configured the Macbook Pro to use HDMI #4 on the ATEM Mini Pro for both VLC and H2R. But the Mac Spaces is unreliable to switch back and forth correctly with other apps running, so the method I’ve adopted (for the Extreme) is to run VLC into input #7 and H2Rv2 into input #8. A solid solution, and won’t fail on you in the middle of a livestream! It’s great that you have an M1 Macbook Pro, because it can handle multiple screens out. I recommend getting this thunderbolt to HDMI adapter, it’s what I use and I love the simplicity of being able to add two HDMI connections via an additional 6ft Thunderbolt cable: https://bhpho.to/34WkN2v https://amzn.to/3zeMWie (affiliate links)
Hi David, I have downloaded and mostly installed DJF ATEM Extreme 3.1. I was a little perplexed to discover the need to run two HDMI inputs from my MacBook Pro (2017), especially given that I only have four ports on my computer + a CalDigit T-3 Hub…
…but I was happy to discover the USBC – 2 x HDMI splitter recommended above — I intended to use your link, but the shipping was $26+, and delivery was Dec 24-ish… Instead, I ordered it from B&H — free shipping and quicker delivery.
I am a little confused about how best to interface my computer with the ATEM Extreme ISO — My current configuration is to run everything though my network — fingers crossed, so far I think everything is working…!?!
Do you have videos available to walk through how to best use all the features of the download…?
Also, I’d like to arrange a one-on-one session with you, after I get the system installed, and spend some time to become familiar with the various features.
Thanks in advance for your assistance, and for the work you do…!
Hi AG! Two HDMIs are recommended if you want to run H2R and VLC at the same time – much more reliable to dedicate each their own HDMI port rather than switching between them on one HDMI. I have a Sabrent one that works well for me: https://www.bhphotovideo.com/c/product/1627770-REG/sabrent_th_s3h2_thunderbolt_3_to_dual.html
You must connect the ATEM’s ethernet port to a switch on the same network as the computer running Companion – Companion won’t speak to the ATEM via USB.
This video will run through what all the aspects of the profile control – https://youtu.be/F1pfmVG46Nw
I have consultations available at this link – https://davidjoshuaford.com/consult/
Enjoy your Extreme!