Install the latest DistroAV release from Releases and the NDI requirements

Preferred Method

Use the built-in Windows Package Manager to install DistroAV.

winget install --exact --id DistroAV.DistroAV

This will install DistroAV, OBS and fetch the dependencies automatically

Alternative Method

or Chocolatey

choco install distroav

Windows Installer

Get the latest version installer of the plugin .exe at Releases This requires the installation of NDI runtime.

Manual Install

Use the windows .zip and unzip directly in C:\ProgramData\obs-studio\plugins or %programdata%\obs-studio\plugins. Note: This is a new location for the plugins to follow OBS Plugins Recommendations This requires the installation of NDI runtime.

Portable Mode

Use the Windows-Portable .zip and unzip in your OBS portable folder obs-studio. This requires the installation of NDI runtime.

Known issue

• The system might prompt a warning at download and at execution that the file is not trusted/signed: Select Run Anyway. (Work-In-Progress with our partner EPEAK Studio to solve this.)

Preferred Method

Use the MacOS HomeBrew Package Manager to install DistroAV.

brew install distroav

This will install DistroAV and fetch the dependencies automatically

Package Install Method 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 that the file is not signed/trusted
  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

Note: This prompt should not appear anymore, thanks to our partner EPEAK Studio providing the codesigning & digital signature for this.

Troubleshooting

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

Recommended for all distros using Flatpak

flatpak install com.obsproject.Studio com.obsproject.Studio.Plugin.DistroAV

Due to an OBS 32 commit, there is need to add an extra command, otherwise Avahi won't work causing NDI to not find any sources. Source

sudo flatpak override com.obsproject.Studio --system-talk-name=org.freedesktop.Avahi

**DistroAV's Flakpak is maintained by the community : Flathub DistroAV package

Get the latest version of the plugin .deb at Releases and install NDI SDK.

Install package

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

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

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

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

DistroAV v6+ requires NDI Runtime v6+

• Windows: http://ndi.link/NDIRedistV6 or Alternative link
• MacOS: http://ndi.link/NDIRedistV6Apple or Alternative link
• Linux:
  • Debian/Ubuntu Install Script
  • Flatpak: Already included in the Flatpak DistroAV installer.

The NDI runtime is also available if you use:

• NDI Tools: Official Page or Alternative link
• NDI SDK: Official Page

Use the Windows Package Manager to install NDI Runtime.

winget install --exact --id NDI.NDIRuntime

or Chocolatey

choco install ndi-runtime

Optional: Install NDI Tools

winget install --exact --id NDI.NDITools

Install libNDI v6.0.1 or higher.

Install via HomeBrew

brew install --cask libndi

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:

• NDI Docs - Platform Considerations
• NDI Docs - Networking Best Practice

Known Linux Issues

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

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

1. Add/Remove Programs: DistroAV (only available if you used the installer method)
2. Delete DistroAV files at: 6.1.0+ : %programdata%\obs-studio\plugins\distroav 6.0.0 : %ProgramFiles%\obs-studio\obs-plugins\64bit\distroav.* & %ProgramFiles%\obs-studio\data\obs-plugins\distroav\
3. (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\

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*

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 maintained by the community

flatpak remove com.obsproject.Studio.Plugin.DistroAV

Make sure to remove an older version of a previous Flatpak

flatpak remove com.obsproject.Studio.Plugin.NDI

Moved to OBS-NDI Is Now DistroAV