Code Monkey home page Code Monkey logo

obs-ndi's Introduction

obs-ndi

Discord Shield

Network Audio/Video in OBS-Studio using NDI technology.

Features

  • 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

Requirements

  • 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.

Install OBS-NDI

Download and install the Linux, MacOS, or Windows version at Releases.

  • Linux
    1. Download obs-ndi-4.13.1-x86_64-linux-gnu.deb
    2. sudo dpkg -i obs-ndi-4.13.1-x86_64-linux-gnu.deb
    3. 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:
    1. Download obs-ndi-4.13.1-macos-universal.pkg
    2. Run obs-ndi-4.13.1-macos-universal.pkg
      If MacOS complains about the file, either:
      1. Allow it in System Settings->Privacy & Security
        -or-
      2. sudo xattr -r -d com.apple.quarantine obs-ndi-4.13.1-macos-universal.pkg
  • Windows:
    1. Download obs-ndi-4.13.1-windows-x64-Installer.exe
    2. Run obs-ndi-4.13.1-windows-x64-Installer.exe

Download & Install The NDI 5 Runtime

Uninstall

Reference: https://obsproject.com/kb/plugins-guide#install-or-remove-plugins

Linux

  1. sudo rm /usr/lib/x86_64-linux-gnu/obs-plugins/obs-ndi.so
    sudo rm -rf /usr/share/obs/obs-plugins/obs-ndi/
    
  2. Optionally delete NDI Runtime:
    sudo rm /usr/local/lib/libndi*
    sudo ldconfig
    

MacOS

  1. Open Finder
  2. Show hidden files with Command-Shift-.
  3. Delete ~/Library/Application Support/obs-studio/plugins/obs-ndi.plugin
  4. Optionally delete NDI Tools/Runtime:
    1. Finder->Applications: Delete all NDI * applications
    2. Delete /Library/Application Support/NewTek/NDI
    3. Delete /usr/local/lib/libndi*

Windows

  1. Add/Remove Programs: obs-ndi
  2. Delete %ProgramFiles%\obs-studio\obs-plugins\64bit\obs-ndi.*
  3. Delete %ProgramFiles%\obs-studio\data\obs-plugins\obs-ndi\
  4. Optionally delete NDI Tools/Runtime:
    1. Add/Remove Programs:
      1. NDI 5 Runtime
      2. NDI 5 Tools
      3. NDI 5 SDK
      4. NDI 5 Advanced SDK
    2. Delete %ProgramFiles%\NDI\NDI 5 Runtime
    3. Delete %ProgramFiles%\NDI\NDI 5 Tools
    4. Delete %ProgramFiles%\NDI\NDI 5 SDK
    5. Delete %ProgramFiles%\NDI\NDI 5 Advanced SDK

Development

Building

Windows

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

Linux

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.

OS X

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.

Formatting

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

obs-ndi's People

Contributors

aramg avatar cerastudios avatar congoblue avatar cooliguay avatar darthsteven avatar ddrboxman avatar derrod avatar dx9s avatar exeldro avatar fredemmott avatar jeffreymartin93 avatar kovalevartem avatar mant1kor avatar mattatcha avatar mhhen avatar norihiro avatar palakis avatar paulpv avatar rytoex avatar stephanel avatar trouffman avatar tt2468 avatar vainock avatar venepe avatar wkpark avatar wwj402 avatar

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.