** Post UPDATED October 16, 2024 **
Install Bitfocus Companion (3.4.2)

Download Companion (here)
- The DJF Companion Profiles require running Companion 3.4.2 or later to support the most up-to-date features and modules.
- Companion runs on Windows, Mac, and Pi – choose your correct system application to download.
Open Companion
- Click Companion’s Web Server icon in the top-right menu bar to show/hide the window.
- Set the GUI Interface to run either locally at 127.0.0.1 (easiest setup), or at your computer’s wireless or wired IP address (if you want to access Companion across the network).
- Set the Port to 8000
- Click “Launch GUI” to view Companion in a web browser.

Install the DJF Companion Profile
- Navigate tabs to Import/Export.
- If you already have your own custom Companion setup, click “Export” to save a backup of your profile first!
- Click “Import” and locate your profile (ends with “.companionconfig”).

- Full Import (recommended)
- Select Full Import.
- Make sure all components (Buttons, Triggers, Custom Variables and Surfaces) remain selected for import.
- Click “Reset and Import”.
- **Note that this will wipe all existing Companion pages, so make sure you’ve backed up any essential work first!

Set the Target IP Address for each Connection
- Under the Connections tab, select the Module you’d like to configure.
- For instance, for the ATEM Modules, update the Target IP to the static IP address for your ATEM Mini/Pro/ISO/2ME/4ME etc, as well as the type of ATEM Model
- If running two or three ATEMS, update the IP addresses for “atem2” and “atem3” connections.
- **Note: it is recommended to keep the connection labels the way they are (i.e. “atem”, “atem2”, “atem3” 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.
- Other modules such as VLC, H2R, and VICREO are pre-set to local 127.0.0.1 and in many circumstances don’t need to be changed.
- Under the Connections tab, select the Module you’d like to configure.

Remove the Top Bar in Settings
- Go to Companion > Settings > Buttons > “Show the topbar on each button. This can be overridden per-button” > DESELECT this box.
- **If you don’t deselect this Topbar option, the DJF button design will look squished and will be missing some text lines. The DJF profile was designed to take up the full square button.
- Go to Companion > Settings > Buttons > “Show the topbar on each button. This can be overridden per-button” > DESELECT this box.

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 tablet or phone instead), click on “Surfaces” > “+ Add Emulator” and then open that URL on the local computer or on a tablet or phone connected to the local network.
- It’s recommended to quit the native Elgato Stream Deck software and run the Stream Deck hardware directly from Companion.
- Changing the default Home Page: By default, a surface will begin at Page 1 of the DJF Cue. From there you can navigate to all other aspects of the DJF profile. If you’d like to change the default Home page for a surface (for instance, for a PTZ camera profile to always begin on page 77), select the Surfaces tab, and click the “Settings” button for the surface you want to update.
Quick-Links to Software Downloads
- Companion 3.4.2
- Blackmagic Switcher Software 9.6.2
- Elgato Stream Deck 6.7.3
- VLC 3.0.21
- VICREO 5.0.1
- H2R Graphics 2.21.0

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://djflive.com/consult/
Enjoy your Extreme!
Hi, David, with my latest upgrade to Companion 3.4.0 the button CUT/AUTO (e.g. from page 10, button 32 down right) from my ATEM Extrem DJF profiles stopped working. Do you face the same issue? Any advise how to get them back to working? I do not see any log file error… If you are not able to see the same error in your profiles I am happy to share more details / screenshots. Thanks for your support, Michael
Hi Michael, I haven’t encountered that issue in v3.4.0. Feel free to email me screenshots/recordings to elaborate and include your computer OS version and network setup.
Hi, David!
I’m trying to import my 3.1 profile to Companion 3.4.3 and the Button and Custom Variables are the only components that can be selected. No Triggers or Surfaces. Is there a fix for this?
Hi Robert! v3.1 predates Triggers and Surfaces being saved in Companion, so there are none to worry about in that version. v4 has these.