Skip to content

OBS‐NDI Is Now DistroAV

Trouffman edited this page Nov 4, 2024 · 9 revisions

OBS-NDI was renamed to DistroAV ~2024/06 per obsproject.com's request to drop OBS from our name.

Migrate From OBS-NDI to DistroAV

The only steps required to migrate from OBS-NDI to DistroAV are:

  1. Install DistroAV
  2. Make sure that OBS-NDI is uninstalled

DistroAV uses the same settings as OBS-NDI, no special migration required. Note: Only one parameter is not migrated.

Uninstall OBS-NDI

Windows

  • If you installed OBS-NDI via the obs-ndi-*-installer.exe installer:
    1. Use Add/Remove Programs and uninstall OBS-NDI
  • If you installed OBS-NDI manually from the obs-ndi-*-windows*.zip:
    1. Delete files %ProgramFiles%\obs-studio\obs-plugins\64bit\obs-ndi.*
    2. Delete folder %ProgramFiles%\obs-studio\data\obs-plugins\obs-ndi\

MacOS

  1. Open Finder
  2. Show hidden files with Command-Shift-.
  3. Browse to ~/Library/Application Support/obs-studio/plugins/
  4. Delete ~/Library/Application Support/obs-studio/plugins/obs-ndi.plugin

Repeat Step 3 & 4 to delete : /Library/Application Support/obs-studio/plugins/obs-ndi.plugin

You can also run this in the Terminal rm -rv ~/Library/Application\ Support/obs-studio/plugins/obs-ndi.plugin ~/Library/Application\ Support/obs-studio/plugins/obs-ndi.dSYM /Library/Application\ Support/obs-studio/plugins/obs-ndi.plugin /Library/Application\ Support/obs-studio/plugins/obs-ndi.dSYM

Linux

Debian

Remove the plugin

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

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

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

Flatpak

This is still a work in progress

FAQ

Why was OBS-NDI renamed to DistroAV?

OBS-NDI was renamed to DistroAV ~2024/06 per obsproject.com's request to drop OBS from our name.

Why do I have to uninstall OBS-NDI?

The "OBS-NDI to DistroAV" rename was a total rename, including file names.
The obs-ndi.* files were renamed to DistroAV.*.
OBS-NDI and DistroAV are separate plugins that use the same settings and should not be run simultaneously.
It is possible to have both OBS-NDI and DistroAV installed and running at the same time.
They should not be run at the same time because they use the same settings values.

If DistroAV detects OBS-NDI then DistroAV will not load and will display a dialog saying that OBS-NDI needs to be uninstalled.

Why doesn't DistroAV uninstall OBS-NDI?

Windows Installer

The DistroAV Windows installer does uninstall OBS-NDI; the install GUID did not change and the MSI installer will treat this as a standard update and automatically uninstall any currently installed [OBS-NDI] files before installing the new [DistroAV] files.

Still, there could be bugs and Windows users may need to manually uninstall OBS-NDI.

MacOS Installer

The MacOS installer package changed from fr.palakis.obs-ndi to org.distroav.distroav.
This complicates a clean update.
MacOS users need to manually uninstall OBS-NDI.

Linux Installer

The Linux .deb installer is a mystery.
Linux users need to manually uninstall OBS-NDI.

Manual Install (All Platforms)

For obvious reasons, DistroAV should not and will not read/write/delete files on your system.
Users that manually installed OBS-NDI need to manually uninstall OBS-NDI.

Will I lose my OBS-NDI settings/sources/filters/etc?

DistroAV uses the same settings as OBS-NDI, so no settings need to be migrated.