1. Installation - DistroAV/DistroAV GitHub Wiki

Required Components - NDI Runtime

The DistroAV plugin requires the NDI runtime to be installed and accessible on your system.

DistroAV v6+ requires NDI Runtime v6+

Manual install

The NDI runtime is also available if you use:

Windows

Use the built-in Windows Package Manager to install NDI Runtime.

winget install --exact --id NDI.NDIRuntime

Optional: Install NDI Tools

winget install --exact --id NDI.NDITools

MacOS

Install libNDI v6.0.1 or higher.

Install via HomeBrew

brew install --cask libndi

Linux

Debian/Ubuntu install script.
This script downloads and installs LibNDI from the official NDI site:

wget https://raw.githubusercontent.com/DistroAV/DistroAV/refs/heads/master/CI/libndi-get.sh
chmod +x libndi-get.sh
./libndi-get.sh install

Additional Requirements for NDI to work on Linux:

sudo apt install avahi-daemon ffmpeg
sudo systemctl enable avahi-daemon
sudo systemctl start avahi-daemon
sudo ufw allow 5353/udp
sudo ufw allow 5959:5969/tcp
sudo ufw allow 5959:5969/udp
sudo ufw allow 6960:6970/tcp
sudo ufw allow 6960:6970/udp
sudo ufw allow 7960:7970/tcp
sudo ufw allow 7960:7970/udp
sudo ufw allow 5960/tcp

References:

*Note: FFmpeg >= 7.0 is required for NDI HX to work on Linux, otherwise it will crash!

Install DistroAV

Install the latest release from Releases.

Windows

Get the latest version of the plugin .exe at Releases.

Alternative Installation Methods Use the .zip method if you are using OBS in portable mode or have windows warning "file is suspicious". Unzip directly in your obs-studio folder.

Known issues

  • The system might prompt a warning that the file is not trusted/signed: Select Run Anyway

MacOS

Get the latest version of the plugin .pkg at Releases.

If installing from Command-line use installer -pkg THE_PACAKGE_HERE.pkg -target CurrentUserHomeDirectory

Known issues

  • The system might prompt a warning that the file is not trusted/signed
    1. Press "control^" and open. -or-
    2. Allow it in System Settings->Privacy & Security->Security and click Allow -or-
    3. sudo xattr -r -d com.apple.quarantine [distroav-package-file].pkg

Troubleshooting If for any reason, you have issue installing the plugin on macos run the command: installer -pkg distroav-6.0.0-macos-universal.pkg -target CurrentUserHomeDirectory -verbose note : there is no requirement to be root expected unless you are using a root user or trying to install on System's /Library folder (none are supposed to be the case)

Linux

Debian / Ubuntu

Get the latest version of the plugin .deb at Releases.

Install package

sudo dpkg -i [distroav-package-file].deb

If some dependencies are missing and not installed auto-magically sudo apt-get -f install image

Known issues If the previous steps did not succeed, try:

sudo ln -s /usr/lib/x86_64-linux-gnu/obs-plugins/distroav.so /usr/local/lib/obs-plugins/distroav.so
sudo ln -s /usr/share/obs/obs-plugins/distroav/ /usr/local/share/obs/obs-plugins/distroav

Flatpak

_This is a work in progress)

flatpak install com.obsproject.Studio com.obsproject.Studio.Plugin.DistroAV
obs --system-talk-name=org.freedesktop.Avahi

DistroAV's Flakpak is still a work in progress; please experiment and report problems or improvement suggestions.

Uninstall

To remove the plugin, you can follow the official OBS documentation or check the steps below

Windows

  1. Add/Remove Programs: DistroAV (only available if you used the installer method)
  2. Delete %ProgramFiles%\obs-studio\obs-plugins\64bit\distroav.*
  3. Delete %ProgramFiles%\obs-studio\data\obs-plugins\distroav\
  4. (Optional) Remove other NDI components
    1. Add/Remove Programs
      1. NDI Runtime
      2. NDI Tools
      3. NDI SDK
      4. NDI Advanced SDK
    2. Delete %ProgramFiles%\NDI\

MacOS

  1. Open Finder
  2. Show hidden files with Command-Shift-.
  3. Delete ~/Library/Application Support/obs-studio/plugins/distroav.plugin
  4. (Optional) Remove other NDI components
    1. Finder->Applications: Delete all NDI * applications
    2. Delete /Library/Application Support/NewTek/NDI
    3. Delete /usr/local/lib/libndi*

Linux

Debian Remove the plugin

sudo rm /usr/lib/x86_64-linux-gnu/obs-plugins/distroav.so
sudo rm -rf /usr/share/obs/obs-plugins/distroav/

If you made symbolic links, don't forget to delete those too:

sudo rm /usr/local/lib/obs-plugins/distroav.so
sudo rm /usr/local/share/obs/obs-plugins/distroav

(Optional) Remove the NDI Runtime:

sudo rm /usr/local/lib/libndi*
sudo ldconfig

Flatpak _This is a work in progress)

flatpak remove com.obsproject.Studio.Plugin.NDI

Migrate From OBS-NDI to DistroAV

Moved to OBS-NDI Is Now DistroAV