Network Audio/Video in OBS-Studio using NDI technology.
- NDI Source : receive NDI video and audio in OBS
- NDI Output : transmit OBS video and audio to NDI
- NDI Filter (a.k.a NDI Dedicated Output) : transmit a single OBS source or scene audio to NDI
- OBS >= 30.0.0 (Qt6 & x64)
- NDI 5 Runtime
We are not allowed to directly distribute the NDI runtime here, but you can get it from either the links below, or installing NDI Tools, or the NDI SDK.
Download and install the Linux, MacOS, or Windows version at Releases.
- Linux
- Download obs-ndi-4.13.0-x86_64-linux-gnu.deb
sudo dpkg -i obs-ndi-4.13.0-x86_64-linux-gnu.deb
- If this does not work then try:
sudo ln -s /usr/lib/x86_64-linux-gnu/obs-plugins/obs-ndi.so /usr/local/lib/obs-plugins/obs-ndi.so sudo ln -s /usr/share/obs/obs-plugins/obs-ndi/ /usr/local/share/obs/obs-plugins/obs-ndi
- Flatpak and similar installs of this plugin or OBS can cause complications; please experiment and report on our Discord server any problems and preferrably solutions.
- MacOS:
- Download obs-ndi-4.13.0-macos-universal.pkg
- Run
obs-ndi-4.13.0-macos-universal.pkg
If MacOS complains about the file, either:- Allow it in
System Settings
->Privacy & Security
-or- sudo xattr -r -d com.apple.quarantine obs-ndi-4.13.0-macos-universal.pkg
- Allow it in
- Windows:
- Download obs-ndi-4.13.0-windows-x64-Installer.exe
- Run
obs-ndi-4.13.0-windows-x64-Installer.exe
- Linux: ./CI/libndi-get.sh
- MacOS: http://ndi.link/NDIRedistV5Apple
- Windows: http://ndi.link/NDIRedistV5
Reference: https://obsproject.com/kb/plugins-guide#install-or-remove-plugins
-
sudo rm /usr/lib/x86_64-linux-gnu/obs-plugins/obs-ndi.so sudo rm -rf /usr/share/obs/obs-plugins/obs-ndi/
- Optionally delete NDI Runtime:
sudo rm /usr/local/lib/libndi* sudo ldconfig
- Open Finder
- Show hidden files with
Command-Shift-.
- Delete
~/Library/Application Support/obs-studio/plugins/obs-ndi.plugin
- Optionally delete NDI Tools/Runtime:
- Finder->Applications: Delete all
NDI *
applications - Delete
/Library/Application Support/NewTek/NDI
- Delete
/usr/local/lib/libndi*
- Finder->Applications: Delete all
- Add/Remove Programs: obs-ndi
- Delete
%ProgramFiles%\obs-studio\obs-plugins\64bit\obs-ndi.*
- Delete
%ProgramFiles%\obs-studio\data\obs-plugins\obs-ndi\
- Optionally delete NDI Tools/Runtime:
- Add/Remove Programs:
- NDI 5 Runtime
- NDI 5 Tools
- NDI 5 SDK
- NDI 5 Advanced SDK
- Delete
%ProgramFiles%\NDI\NDI 5 Runtime
- Delete
%ProgramFiles%\NDI\NDI 5 Tools
- Delete
%ProgramFiles%\NDI\NDI 5 SDK
- Delete
%ProgramFiles%\NDI\NDI 5 Advanced SDK
- Add/Remove Programs:
In PowerShell Core 7 terminal:
git clone https://github.com/obs-ndi/obs-ndi.git
cd obs-ndi
First build:
.github/scripts/Build-Windows.ps1 && .github/scripts/Package-Windows.ps1 -BuildInstaller
Subsequent builds:
.github/scripts/Build-Windows.ps1 -SkipDeps && .github/scripts/Package-Windows.ps1 -BuildInstaller
See Help .github/scripts/Build-Windows.ps1
for more details.
If you get SecurityError/PSSecurityException/UnauthorizedAccess
error then:
Set-ExecutionPolicy -ExecutionPolicy Unrestricted -Scope CurrentUser
NOTE: Only Debian and Ubuntu are officially supported
In terminal:
git clone https://github.com/obs-ndi/obs-ndi.git
cd obs-ndi
.github/scripts/build-linux
...
.github/scripts/package-linux
...
sudo cp -r release/obs-plugins/64bit/* /usr/local/lib/x86_64-linux-gnu/obs-plugins/
...
sudo cp -r release/data/obs-plugins/* /usr/local/share/obs/obs-plugins/
...
sudo ldconfig
Subsequent builds can be sped up by using build-linux --skip-deps
.
See build-linux --help
for more details.
In terminal:
git clone https://github.com/obs-ndi/obs-ndi.git
cd obs-ndi
.github/scripts/build-macos
...
.github/scripts/package-macos
...
cp -r release/obs-ndi.plugin ~/Library/Application\ Support/obs-studio/plugins/
...
Subsequent builds can be sped up by using build-macos --skip-deps
.
See build-macos --help
for more details.
Requires [obsproject/tools/]clang-format@13, cmakelang, and zsh installed.
From a Linux or MacOS terminal:
./build-aux/run-clang-format
./build-aux/run-cmake-format