Skip to content

2. Troubleshooting

Jump to bottom Edit New page
Trouffman edited this page Nov 12, 2024 · 14 revisions

Troubleshooting

OBS Logs

In OBS select Help->Log Files.

To access the log files, in OBS menu Help -> Log Files :

  • View Current Log - to debug by yourself

    -or-

  • Upload Current Log File, and share the URL in your Bug Report or Support Request

Troubleshooting Installation

(Work-in-Progress)

Troubleshooting DistroAV plugin (via OBS Error Log)

(Work-in-Progress)

Known Error messages:

Troubleshooting Plugin Launch (when starting OBS) - Error Message

obs_module_load: ERROR - load_ndilib() failed; message=%s

obs_module_load: ndiLib->initialize() failed; CPU unsupported by NDI library. Module won't load.

Solution:

  • Hardware is unsupported
  • Other limitation exists (from error message) - Open a ticket if this seems unexpected

load_ndilib: ERROR: NDIlib_v5_load not found in loaded library

load_ndilib: ERROR: Can't find the NDI library

load_ndilib: ERROR: QLibrary returned the following error: '%s'

Solution:

  • Follow the Installation Steps fully (especially per-requisites)
  • Clean any old NDI Runtime (See Installation Steps)

warning: unsupported pixel format %d

ndi_source_thread_process_video2: warning: unsupported video pixel format:

Solution:

  • None (ahahahah!)
  • If all other troubleshooting steps did not solve the problem, open a ticket.

Troubleshooting Plugin Update (usually when launching OBS) - Error Message

onCheckForUpdateNetworkFinish: Failed to get main OBS window

onCheckForUpdateNetworkFinish: Error! httpStatusCode=%d, errorData=%s; ignoring response

updateCheckStart: timer: Request timed out

RemoteTextThread: HTTP request failed. %s

CalculateFileHash: Failed to open file: %s

CalculateFileHash: Failed to read data from file: %s

Solution:

  • Close OBS
  • Confirm Internet is working (confirm access to distroav.org is working and no firewall rule block access)
  • Relaunch OBS

If problem persist: +1 if the issue already exists, otherwise: Open an issue.

DistroAV NDI Source - Error Message

%s ndi_source_thread: reset_ndi_receiver: Cannot create ndi_receiver for NDI source %s

Root Cause: Something is wrong with the NDI Source

Action: Delete and recreate the source

%s ndi_source_thread: Cannot create ndi_frame_sync for NDI source %s Symptom: Source is black or only audio or only video

Root Cause: NDI Framesync is enabled but something is missing

Action: Disable framesync, confirm source work, re-enable framesync.

Troubleshooting DistroAV NDI Output (from DistroAV settings Program/Preview) - Error Message

Program:

main_output_stop: NDI main output %s is not running

main_output_start: failed to start NDI main output %s; error=%s

main_output_start: NDI main output %s is not initialized

main_output_init: failed to create NDI main output %s

Preview:

preview_output_stop: NDI preview output %s is not running

preview_output_start: failed to start NDI preview output %s; error=%s

preview_output_start: NDI preview output %s is not initialized

preview_output_init: failed to create NDI preview output %s

Root Cause: TBD

Action: Disable NDI Preview/Program Output, restart OBS, re-enable

Troubleshooting Filters (NDI Filter) - Error Message

ndi_output_start

%s ndi_output_start: no video and audio available

%s ndi_output_start: data capture start failed

%sndi_output_start: ndi sender init failed

Root Cause: Filter is used on an incompatible OBS Source

Action: Remove Filter, restart OBS, add NDI filter again. If problem persist : open an issue

Troubleshooting Solutions

Firewall Settings & requirements

(It's always the firewall!)

Windows

Allow OBS to use the network (send / receive)

  1. Set your network as "Private"

Open "Firewall & network protection", set your network to Private.

-or-

  1. Allow OBS-Studio on Private & Public Network

Open "Windows Defender Firewall" -> "Allow an app or feature through the Windows Defender Firewall" -> Allow OBS-Studio on both Private & Public network

If using a different software, please allow OBS executable and NDI related Network ports.

MacOS

  1. Configure Firewall to allow OBS to communicate on the network.
  • System Settings -> Network -> Firewall -> Options
  • OBS should be set to "Allow incoming connections"

image

  1. Allow OBS to access Local network

Context: MacOS Sequoia 15+ has a privacy feature that block local network access by default unless approved

  • System Settings -> Privacy & Security -> Local Network
  • OBS must be allowed

Linux

Check the installation notes

Symptoms solved:

  • No NDI Source in dropdown menu
  • NDI Source is Black / black screen

Troubleshooting Matrix

Symptom Check
  • No NDI Output Settings in the OBS Tools menu.
  • No NDI Source listed when trying to add a Source.
  • No NDI Filter listed when trying to add a Filter.
  • OBS Compatibility: Ensure your OBS version is 30.0.0 or higher.
  • Verify OBS-NDI Installation: Check the installation paths for OBS-NDI files based on your operating system:
    • Linux:
      /usr/lib/x86_64-linux-gnu/obs-plugins/obs-ndi.so
      /usr/share/obs/obs-plugins/obs-ndi/
    • MacOS: ~/Library/Application Support/obs-studio/plugins/obs-ndi.plugin
    • Windows:
      %ProgramFiles%\obs-studio\obs-plugins\64bit\obs-ndi.*
      %ProgramFiles%\obs-studio\data\obs-plugins\obs-ndi\​​
  • Verify NDI Runtime Installation: Ensure the NDI runtime is correctly installed:
    • Linux: /usr/local/lib/libndi*
    • MacOS:
      /Library/Application Support/NewTek/NDI
      /usr/local/lib/libndi*
    • Windows: %ProgramFiles%\NDI\NDI 5 Runtime
  • Check OBS Log: Go to Help->Log Files->View Current Log in OBS to check for obs-ndi related entries.
  • Check Firewall:
    • Ensure that all NDI devices are on the same network.
    • Turn off all other device network interfaces.
    • Test with firewall temporarily turned off.
    • Windows:
      • Check if network is Private
A transmitting OBS-NDI source is not listed in NDI Source->Source name
  • See if the OBS-NDI Source shows up in NDI Studio Monitor.
  • See if using NDI Screen Capture on the transmitting device shows up in NDI Studio Monitor or OBS-NDI.
A transmitting NDI source is not listed in NDI Source->Source name
  • See if the NDI Source shows up in NDI Studio Monitor.

In general: FIRST try to get a pure NDI Screen Capture + Studio Monitor solution working, and THEN add OBS & OBS-NDI into that working pure NDI solution.

Debugging

obs[64.exe] --obs-ndi-verbose --verbose

Installation Troubleshooting

MacOS - Known issues

  • Runtime not found - But runtime are installed - Error log: "libNDI not found" / "libndi_load_v5: not found".

Reason: The /usr/local/lib folder is set with the wrong permissions in the libNDI 6.0.0 installer. Status : libNDI for Mac 6.0.1 fixes this but if the libNDI 6.0.0 was used (for the first time) the following workaround still need to be applied.

Fix:

  • Install NDI Runtime package for MacOS version 6.0.1 or higher
  • In Terminal
sudo chmod 755 /usr/local/lib
Add a custom footer
Add a custom sidebar
Clone this wiki locally