If something isn’t working, start here

Most issues come down to connection or setup. Keep it simple. If Companion can see your device and trigger a basic action, everything else will work.

 

Companion not loading

• Open Companion in your browser at 127.0.0.1:8000

• If that doesn’t work, use your computer’s IP address (e.g. 192.168.1.100:8000)

• Restart Companion

• Try a different browser

 

Device not responding (ATEM, PTZ, etc.)

• Confirm the device is powered on

• Confirm the device and computer are on the same network

• Check the IP address in Companion matches the device

• Confirm the correct module and model are selected

• Check connection status in Companion

If Companion cannot connect to the device, buttons will not work.

 

Buttons visible but not working

• Check that the device connection is configured correctly

• Confirm IP address and model selection

• Try a simple test action (e.g. switch input)

• Re-import using Full Import if unsure

 

Stream Deck not showing

• Quit the Elgato Stream Deck software

• Go to Surfaces → Rescan USB

• Go to Settings → Surfaces, enable “Enable direct connection to Streamdecks. When disabled support for the Elgato software Plugin will be enabled”

• Use a Surface Emulator if needed

 

Layout looks incorrect

• Go to Settings → Buttons

• Disable Show topbar on each button

If enabled, buttons will appear compressed, misaligned, and text will be missing.

 

Import issues

• Confirm you are using Companion 4.2.6 or later

• Use Full Import for a clean setup

• Ensure all components are selected during import

 

Variable or automation errors

• Usually caused by undefined variables or incomplete setup

• Re-import using Full Import to reset the system

• Advanced users: check that required variables are initialized

 

Raspberry Pi issues

• Use wired Ethernet instead of WiFi

• Allow time after boot for network to initialize

• Restart Companion if connections fail

 

Something worked before, now it doesn’t

• Check if the device IP address has changed

• Restart the device and Companion

• Confirm network connections are still active

Using static or reserved IP addresses is recommended.

 

Reset to a known working state

If you are unsure where the issue is:

• Confirm Companion is running

• Confirm the device appears in Connections

• Trigger a simple action manually

If that works, the system is functioning correctly.

 

Need help?

If you want to move faster or avoid trial-and-error:

• Book a 1:1 session for setup or troubleshooting

• Bring your system live and resolve issues in real time

This is the fastest way to get fully operational.