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

 

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.

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.

 

  1. Companion 3.4.2
  2. Blackmagic Switcher Software 9.6.2
  3. Elgato Stream Deck 6.7.3
  4. VLC 3.0.21
  5. VICREO 5.0.1
  6. H2R Graphics 2.21.0

 

Need Help?