Network A/V in OBS Studio with NewTek's 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 >=28
- NDI 5 Runtime (optionally installed via NDI Tools)
- Download and install the Linux, MacOS, or Windows version at Releases.
- Linux:
- Download obs-ndi-4.11.1-linux-x86_64.deb
sudo dpkg -i obs-ndi-4.11.1-linux-x86_64.deb
- MacOS:
- Download obs-ndi-4.11.1-macos-universal.pkg
- Run
obs-ndi-4.11.1-macos-universal.pkg
- Windows:
- Download obs-ndi-4.11.1-windows-x64-Installer.exe
- Run
obs-ndi-4.11.1-windows-x64-Installer.exe
- Linux:
- Download and install the NDI 5 runtime from:
- Linux:
#!/bin/bash set -e LIBNDI_INSTALLER_NAME="Install_NDI_SDK_v5_Linux" LIBNDI_INSTALLER="$LIBNDI_INSTALLER_NAME.tar.gz" LIBNDI_INSTALLER_SHA256="00d0bedc2c72736d82883fc0fd6bc1a544e7958c7e46db79f326633d44e15153" pushd /tmp sudo apt-get install curl curl -L -o $LIBNDI_INSTALLER https://downloads.ndi.tv/SDK/NDI_SDK_Linux/$LIBNDI_INSTALLER -f --retry 5 echo "$LIBNDI_INSTALLER_SHA256 $LIBNDI_INSTALLER" | sha256sum -c tar -xf $LIBNDI_INSTALLER yes | PAGER="cat" sh $LIBNDI_INSTALLER_NAME.sh rm -rf ndisdk mv "NDI SDK for Linux" ndisdk sudo cp -P ndisdk/lib/x86_64-linux-gnu/* /usr/local/lib/ sudo ldconfig echo libndi installed to /usr/local/lib/ ls -la /usr/local/lib/libndi* rm -rf ndisdk popd
- Linux:
* MacOS: http://ndi.link/NDIRedistV5Apple
* Windows: http://ndi.link/NDIRedistV5
rm -rf ~/.config/obs-studio/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
- Delete
%ProgramFiles%\obs-studio\obs-plugins\64-bit\obs-ndi.*
- Optionally delete NDI Tools/Runtime:
- Add/Remove Programs
- Delete
%ProgramFiles%\NDI\NDI 5 Runtime
- Delete
%ProgramFiles%\NDI\NDI 5 Tools
In PowerShell v5+ terminal:
git clone https://github.com/obs-ndi/obs-ndi.git
cd obs-ndi
.github/scripts/Build-Windows.ps1
...
tbd...
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.sh
...
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
In terminal:
git clone https://github.com/obs-ndi/obs-ndi.git
cd obs-ndi
.github/scripts/build-macos.zsh
...
cp -r release/obs-ndi.plugin ~/Library/Application\ Support/obs-studio/plugins/
...
Subsequent builds can be sped up by using build-macos.zsh --skip-deps
.
[For some reason --skip-all
doesn't work.]
See build-macos.zsh --help
for more details.
From a bash shell (confirmed also works on WSL):
.github/scripts/check-format.sh 1
NOTE: obs-ndi
is based on obsplugin-template
that requires clang-format-13
:
if type clang-format-13 2> /dev/null ; then
CLANG_FORMAT=clang-format-13
elif type clang-format 2> /dev/null ; then
# Clang format found, but need to check version
CLANG_FORMAT=clang-format
V=$(clang-format --version)
if [[ $V != *"version 13.0"* ]]; then
echo "clang-format is not 13.0 (returned ${V})"
exit 1
fi
else
echo "No appropriate clang-format found (expected clang-format-13.0.0, or clang-format)"
exit 1
fi
MacOS brew only has formulaes for clang-format 15, 11, or 8. If you want to check-format on MacOS then you will need to:
- brew install clang-format
- edit
.github/scripts/check-format.sh
and change all13
to15
- !!DO NOT COMMIT THESE CHANGES!!