Install DJF Companion Profile on a Mac

 

Companion also runs on Windows and Pi.

This article will focus on a Mac installation.

Running Companion is one of those “easy when you know how” things.

This article will show you how. Easy!

There are 6 Segments we will dive into below:

  1. Companion 2.2.0
  2. Blackmagic Switcher Software 8.6.3
  3. Stream Deck 5.0
  4. VLC 3.0.13
  5. VICREO 3.0.3
  6. H2R 0.4

 

 

1. COMPANION (2.2.0 – beta build)

Download Companion:

    • The DJF Companion Profiles require running Companion 2.2.0 to support the most up-to-date features and modules.
    • You will not be able to operate or install this profile using Companion 2.1.3.
    • DJF Companion Profile was built and tested using 2.2.0 build 3479. Don’t use a build prior to 3479. It is generally recommended to simply use the most recent build available.
    • While 2.2.0 is still pre-release, it’s generally pretty stable. That said, make sure you thoroughly test your setup before implementing in a live production.

 

Open Companion

    • If running for the first time, right-click the Companion app and select “Open”.
    • You’ll receive a notification that the developer is unknown. Cancel this.
    • Right-click “Open” a second time, and now you can open the app.
    • 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 (or 8888)
    • 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.0:
          • Extreme………..Pages 55, 56, 57, 58
          • Pro………………Pages 83, 84
        • Backend service pages for v2.5:
          • Pro………………Pages 22, 23

 

    • 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 Extreme and 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’s Button #1) to target your configuration layout.

 

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 instance labels the way they are (i.e. “ext-atem” and “pro-atem” etc.) Changing the instance 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.

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: 
          • DJF PROFILE v3.0
            • 32-button Extreme…………………..PAGE 1
            • 32-button Pro…………………………PAGE 66
            • Vertical Pro…………………………….PAGE 88
            • Vertical Extreme……………………..PAGE 93 
          • DJF PROFILE v2.5
            • 32-button Pro…………………………PAGE 1
            • 15-button Pro…………………………PAGE 31
            • Vertical Pro…………………………….PAGE 71

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”.

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).
    • **Note: The DJF Companion Profiles require running Companion 2.2.0 to support the most up-to-date features and modules. Some functions will be missing if you try to operate the profile using Companion 2.1.3.
Read More

DJF Companion Profile Trials

Welcome!

If you’ve found this page via my YouTube Companion tutorials, note that the free v2.0 DJF Companion Profiles have been superseded by a Free Trial of the Home Page v3.0 (below).

This download is a single, standalone page, giving you the opportunity to test out your network configurations and Companion modules (VLC, H2R, VICREO) before purchasing the full-featured, all-new v3.0 profiles for both ATEM Mini Pro and Extreme below. It does not include the native Stream Deck application profiles or the ATEM Macros.

It’s also an awesome portable Switcher page! 🙂

And please do join the mailing list to keep track of my Companion updates as well as production tutorials!




Get Companion release updates!

FREE TRIAL OF DJF COMPANION PROFILES v3.0

 

A MORE POWERFUL
ATEM MINI PRO & EXTREME

The DJF Companion Profiles below are recommended for use with an Elgato Stream Deck XL, Regular, or Mobile app for best user experience.

The layouts also run without Stream Deck by using a web browser on a computer, tablet, or mobile.

ALL NEW! FULL-FEATURED DJF COMPANION PROFILES v3.0

SEE ALL PROFILE CONFIGURATIONS