DistroAV OBS-NDI 插件安装避坑全指南6 个要点告别 NDI Runtime Not Found【免费下载链接】obs-ndiDistroAV (formerly OBS-NDI): NDI integration for OBS Studio项目地址: https://gitcode.com/gh_mirrors/ob/obs-ndiDistroAV原 OBS-NDI是 OBS Studio 中实现 NDI 网络音视频传输的核心插件它让两台甚至多台电脑之间可以像插了根隐形视频线一样低延迟互传画面和声音。但不少用户在安装时第一眼看到的不是功能菜单而是一个弹窗——NDI Runtime Not Found。这篇文章就用一个双机位直播的真实场景串起全部内容从环境检查到踩坑排查帮你一次把 DistroAV 装好、配对、用顺。DistroAV原 OBS-NDI的项目横幅它就是让 OBS 具备 NDI 网络传输能力的核心插件。先搞清楚一个现实问题为什么插件装好了却报 Runtime 缺失假设你正在搭建一个双机位直播间A 电脑运行 OBS 负责推流B 电脑用另一台设备采集特写画面两台电脑想通过局域网互相看到对方。没有 NDI你得拉 HDMI 线、配采集卡有了 NDI一切走网线即可。但这里有一个容易被忽略的依赖链DistroAV 插件本身只是一个遥控器真正干活的是底层的 NDI Runtime 运行库。插件通过它去调用 NDI 的 API 接口和系统服务。这就像你装好了打车软件但手机里没有定位服务界面再漂亮也约不到车——插件、运行库、OBS 三者缺一不可。源码中这段加载逻辑最能说明问题插件启动时会依次尝试/usr/lib、/usr/lib64、/usr/local/lib等路径查找libndi.so找不到就抛出 ERR-404/ERR-401 并弹窗提示。相关实现见src/plugin-main.cpp。安装前的一张环境检查清单版本、架构、权限逐项核对很多安装失败其实在动手之前就已经注定了因为环境不达标。请对照下面这份清单自查✅OBS 版本需 v31.1.1 或更高要求 Qt6 构建。版本过低时插件会报 ERR-424。✅NDI Runtime 版本需 v6.3 或更高插件会做版本比对过低时报 ERR-425。✅系统架构64 位系统x64 / ARM64 / Apple Silicon32 位系统直接放弃。✅管理员权限Windows 下安装 Runtime 需要管理员权限注册系统组件。✅关闭 OBS安装期间完全退出 OBS Studio避免文件被占用。✅清理旧插件如果电脑上还残留老版 OBS-NDI 插件必须先行卸载否则 DistroAV 检测到冲突会拒绝加载ERR-403。这些硬性要求同样写在项目的 buildspec.json 和 CMakeLists.txt 中OBS 31.1.1 是明确的构建基线版本。主流安装方式横向对比按你的平台对号入座环境确认无误后不同系统的安装命令差异很大建议直接对照下表操作平台推荐方式命令特点WindowsWinGet 包管理器winget install --exact --id DistroAV.DistroAV一条命令完成自动处理依赖macOSHomebrew Caskbrew install --cask distroav/distroav/distroav与 Homebrew 生态无缝集成Linux通用Flatpakflatpak install com.obsproject.Studio com.obsproject.Studio.Plugin.DistroAV需配合 Avahi 系统总线权限Ubuntu/Debianapt 仓库sudo apt install distroav随发行版维护版本更新可能略慢其中 Flatpak 方式有一个容易漏掉的后续步骤——网络发现依赖 Avahi 服务需要额外授予系统总线权限sudo flatpak override com.obsproject.Studio --system-talk-nameorg.freedesktop.Avahi装完插件只是第一步NDI Runtime 还需要单独安装两者是独立的。Windows 用户尤其注意Runtime 安装包必须右键以管理员身份运行否则组件注册不完整插件启动时依然会报NDI Runtime Not Found。核心配置逐项讲解NDI Source 到底在调些什么安装完成只是开始真正决定体验的是配置。在 OBS 的来源面板点击添加NDI Source你会看到一堆参数它们对应的正是源码 src/ndi-source.cpp 里的配置项源码配置项界面含义一句话建议ndi_source_name源名称选择要接收的 NDI 设备ndi_bw_mode带宽模式局域网内选 Highest 画质最好ndi_sync音视频同步默认 Network 模式即可ndi_framesync帧同步实验性画面撕裂时再开启ndi_recv_hw_accel请求硬件加速高分辨率解码建议开启yuv_rangeYUV 范围Limited 与 Full 二选一混用会发灰yuv_colorspaceYUV 色彩空间按制作流程选 Rec.601 / 709 / 2100latency延迟模式追求实时选 Lowest追求稳定选 Normalndi_audio启用音频默认开启即可这里重点说说两个最容易踩坑的选项带宽模式Bandwidth它决定了画质与网络占用的平衡。同一局域网内直播建议选 Highest如果网络带宽紧张可以降到 Lowest 甚至 Audio Only只听声音。它就像一个水管阀门开多大由你的网管决定。YUV 范围与色彩空间这是新手最容易忽略、却又最影响画面观感的两个参数。如果发送端用 Full 范围接收端却按 Limited 解码画面就会整体发灰、像蒙了一层雾。跨设备协作时务必和对方确认统一的色彩设置。发送端的三件套NDI Output、Preview Output 与 Filter接收讲完了再来看发送。DistroAV 提供三种把画面送出去的方式对应不同使用场景NDI Output主输出在工具→DistroAV NDI 设置中启用把 OBS 当前节目画面整体发送到 NDI 网络。这是最常用的方式适合整场直播推给另一台电脑的场景。Preview Output预览输出单独把预览窗口发送出去适合导播场景——导播在另一台设备上看你的未播出画面。NDI Filter专用输出给单个来源或场景添加滤镜把这一路单独发出去。实现代码见 src/ndi-filter.cpp它的 NDI 名称支持${source}和${filter}两个动态令牌源或滤镜改名时发送端会自动重建方便批量管理多路输出。主输出与预览输出的开关和命名都保存在全局配置文件中如 Linux 下为~/.config/obs-studio/global.ini对应代码见 src/config.h。值得留意的是Tally 指示灯功能可以让你在接收端直观看到哪台设备正在被切出多机位导播时非常好用。高频踩坑避雷清单看懂日志里的错误码遇到问题别慌DistroAV 会把具体的错误码写进 OBS 日志先看日志再动手能省一半排查时间。下面是常见错误码的一键排查思路错误码含义排查方向ERR-401NDI Runtime Not Found安装官方 NDI Runtime并以管理员权限运行安装包ERR-403检测到旧版 OBS-NDI先卸载旧插件再启动 OBSERR-404NDI 库未找到检查 Runtime 是否安装到系统标准库路径ERR-406NDI 库无法初始化多为 CPU 过旧不支持检查硬件ERR-424OBS 版本过低升级 OBS 至 v31.1.1 及以上ERR-425NDI 版本过低升级 NDI Runtime 至 v6.3 及以上除了错误码还有两个高频场景值得单独提醒场景一装完 Runtime 依然报错。先重启电脑——Windows 下 NDI 服务注册和系统环境变量往往要重启后才生效。重启后仍报错就去服务管理器里确认 NDI 相关服务处于正在运行状态。场景二能收到画面但搜不到设备。优先排查防火墙和网络隔离。NDI 走的是局域网组播/单播发现机制设备在不同子网、或者防火墙拦了相关端口都会导致眼瞎。Linux Flatpak 用户则先确认 Avahi 权限是否已按上文命令授予。最后的验证与进阶玩法从能跑到好用一切配置完成后建议按双机位直播场景做一次端到端验证B 电脑启动 OBS 添加 NDI SourceA 电脑开启 NDI OutputB 电脑的来源下拉列表里应该能看到 A 电脑的输出名点击即可接入画面。如果能流畅看到画面、听到声音恭喜你NDI 工作流已经打通。在此基础上进阶玩法还很多多设备管理通过 NDI Groups 分组让接收端按组筛选源避免列表刷屏。硬件加速高分辨率多路接入时开启 NDI Source 的硬件加速能显著降低 CPU 占用。色彩科学统一全链路的 YUV 色彩空间与范围让各设备画面观感一致。Alpha 通道插件内置的 Alpha Blending Fix 滤镜可以修复带透明通道画面的混合问题详见 src/premultiplied-alpha-filter.cpp。一句话收尾把插件、Runtime、环境这三角关系理顺DistroAV 就能从报错钉子户变成你直播间最省心的传输底座——现在就去打开 OBS按这份清单把第一个 NDI 源接进来吧。【免费下载链接】obs-ndiDistroAV (formerly OBS-NDI): NDI integration for OBS Studio项目地址: https://gitcode.com/gh_mirrors/ob/obs-ndi创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 DistroAV OBS-NDI 插件安装避坑全指南：6 个要点告别 NDI Runtime Not Found
DistroAV OBS-NDI 插件安装避坑全指南6 个要点告别 NDI Runtime Not Found【免费下载链接】obs-ndiDistroAV (formerly OBS-NDI): NDI integration for OBS Studio项目地址: https://gitcode.com/gh_mirrors/ob/obs-ndiDistroAV原 OBS-NDI是 OBS Studio 中实现 NDI 网络音视频传输的核心插件它让两台甚至多台电脑之间可以像插了根隐形视频线一样低延迟互传画面和声音。但不少用户在安装时第一眼看到的不是功能菜单而是一个弹窗——NDI Runtime Not Found。这篇文章就用一个双机位直播的真实场景串起全部内容从环境检查到踩坑排查帮你一次把 DistroAV 装好、配对、用顺。DistroAV原 OBS-NDI的项目横幅它就是让 OBS 具备 NDI 网络传输能力的核心插件。先搞清楚一个现实问题为什么插件装好了却报 Runtime 缺失假设你正在搭建一个双机位直播间A 电脑运行 OBS 负责推流B 电脑用另一台设备采集特写画面两台电脑想通过局域网互相看到对方。没有 NDI你得拉 HDMI 线、配采集卡有了 NDI一切走网线即可。但这里有一个容易被忽略的依赖链DistroAV 插件本身只是一个遥控器真正干活的是底层的 NDI Runtime 运行库。插件通过它去调用 NDI 的 API 接口和系统服务。这就像你装好了打车软件但手机里没有定位服务界面再漂亮也约不到车——插件、运行库、OBS 三者缺一不可。源码中这段加载逻辑最能说明问题插件启动时会依次尝试/usr/lib、/usr/lib64、/usr/local/lib等路径查找libndi.so找不到就抛出 ERR-404/ERR-401 并弹窗提示。相关实现见src/plugin-main.cpp。安装前的一张环境检查清单版本、架构、权限逐项核对很多安装失败其实在动手之前就已经注定了因为环境不达标。请对照下面这份清单自查✅OBS 版本需 v31.1.1 或更高要求 Qt6 构建。版本过低时插件会报 ERR-424。✅NDI Runtime 版本需 v6.3 或更高插件会做版本比对过低时报 ERR-425。✅系统架构64 位系统x64 / ARM64 / Apple Silicon32 位系统直接放弃。✅管理员权限Windows 下安装 Runtime 需要管理员权限注册系统组件。✅关闭 OBS安装期间完全退出 OBS Studio避免文件被占用。✅清理旧插件如果电脑上还残留老版 OBS-NDI 插件必须先行卸载否则 DistroAV 检测到冲突会拒绝加载ERR-403。这些硬性要求同样写在项目的 buildspec.json 和 CMakeLists.txt 中OBS 31.1.1 是明确的构建基线版本。主流安装方式横向对比按你的平台对号入座环境确认无误后不同系统的安装命令差异很大建议直接对照下表操作平台推荐方式命令特点WindowsWinGet 包管理器winget install --exact --id DistroAV.DistroAV一条命令完成自动处理依赖macOSHomebrew Caskbrew install --cask distroav/distroav/distroav与 Homebrew 生态无缝集成Linux通用Flatpakflatpak install com.obsproject.Studio com.obsproject.Studio.Plugin.DistroAV需配合 Avahi 系统总线权限Ubuntu/Debianapt 仓库sudo apt install distroav随发行版维护版本更新可能略慢其中 Flatpak 方式有一个容易漏掉的后续步骤——网络发现依赖 Avahi 服务需要额外授予系统总线权限sudo flatpak override com.obsproject.Studio --system-talk-nameorg.freedesktop.Avahi装完插件只是第一步NDI Runtime 还需要单独安装两者是独立的。Windows 用户尤其注意Runtime 安装包必须右键以管理员身份运行否则组件注册不完整插件启动时依然会报NDI Runtime Not Found。核心配置逐项讲解NDI Source 到底在调些什么安装完成只是开始真正决定体验的是配置。在 OBS 的来源面板点击添加NDI Source你会看到一堆参数它们对应的正是源码 src/ndi-source.cpp 里的配置项源码配置项界面含义一句话建议ndi_source_name源名称选择要接收的 NDI 设备ndi_bw_mode带宽模式局域网内选 Highest 画质最好ndi_sync音视频同步默认 Network 模式即可ndi_framesync帧同步实验性画面撕裂时再开启ndi_recv_hw_accel请求硬件加速高分辨率解码建议开启yuv_rangeYUV 范围Limited 与 Full 二选一混用会发灰yuv_colorspaceYUV 色彩空间按制作流程选 Rec.601 / 709 / 2100latency延迟模式追求实时选 Lowest追求稳定选 Normalndi_audio启用音频默认开启即可这里重点说说两个最容易踩坑的选项带宽模式Bandwidth它决定了画质与网络占用的平衡。同一局域网内直播建议选 Highest如果网络带宽紧张可以降到 Lowest 甚至 Audio Only只听声音。它就像一个水管阀门开多大由你的网管决定。YUV 范围与色彩空间这是新手最容易忽略、却又最影响画面观感的两个参数。如果发送端用 Full 范围接收端却按 Limited 解码画面就会整体发灰、像蒙了一层雾。跨设备协作时务必和对方确认统一的色彩设置。发送端的三件套NDI Output、Preview Output 与 Filter接收讲完了再来看发送。DistroAV 提供三种把画面送出去的方式对应不同使用场景NDI Output主输出在工具→DistroAV NDI 设置中启用把 OBS 当前节目画面整体发送到 NDI 网络。这是最常用的方式适合整场直播推给另一台电脑的场景。Preview Output预览输出单独把预览窗口发送出去适合导播场景——导播在另一台设备上看你的未播出画面。NDI Filter专用输出给单个来源或场景添加滤镜把这一路单独发出去。实现代码见 src/ndi-filter.cpp它的 NDI 名称支持${source}和${filter}两个动态令牌源或滤镜改名时发送端会自动重建方便批量管理多路输出。主输出与预览输出的开关和命名都保存在全局配置文件中如 Linux 下为~/.config/obs-studio/global.ini对应代码见 src/config.h。值得留意的是Tally 指示灯功能可以让你在接收端直观看到哪台设备正在被切出多机位导播时非常好用。高频踩坑避雷清单看懂日志里的错误码遇到问题别慌DistroAV 会把具体的错误码写进 OBS 日志先看日志再动手能省一半排查时间。下面是常见错误码的一键排查思路错误码含义排查方向ERR-401NDI Runtime Not Found安装官方 NDI Runtime并以管理员权限运行安装包ERR-403检测到旧版 OBS-NDI先卸载旧插件再启动 OBSERR-404NDI 库未找到检查 Runtime 是否安装到系统标准库路径ERR-406NDI 库无法初始化多为 CPU 过旧不支持检查硬件ERR-424OBS 版本过低升级 OBS 至 v31.1.1 及以上ERR-425NDI 版本过低升级 NDI Runtime 至 v6.3 及以上除了错误码还有两个高频场景值得单独提醒场景一装完 Runtime 依然报错。先重启电脑——Windows 下 NDI 服务注册和系统环境变量往往要重启后才生效。重启后仍报错就去服务管理器里确认 NDI 相关服务处于正在运行状态。场景二能收到画面但搜不到设备。优先排查防火墙和网络隔离。NDI 走的是局域网组播/单播发现机制设备在不同子网、或者防火墙拦了相关端口都会导致眼瞎。Linux Flatpak 用户则先确认 Avahi 权限是否已按上文命令授予。最后的验证与进阶玩法从能跑到好用一切配置完成后建议按双机位直播场景做一次端到端验证B 电脑启动 OBS 添加 NDI SourceA 电脑开启 NDI OutputB 电脑的来源下拉列表里应该能看到 A 电脑的输出名点击即可接入画面。如果能流畅看到画面、听到声音恭喜你NDI 工作流已经打通。在此基础上进阶玩法还很多多设备管理通过 NDI Groups 分组让接收端按组筛选源避免列表刷屏。硬件加速高分辨率多路接入时开启 NDI Source 的硬件加速能显著降低 CPU 占用。色彩科学统一全链路的 YUV 色彩空间与范围让各设备画面观感一致。Alpha 通道插件内置的 Alpha Blending Fix 滤镜可以修复带透明通道画面的混合问题详见 src/premultiplied-alpha-filter.cpp。一句话收尾把插件、Runtime、环境这三角关系理顺DistroAV 就能从报错钉子户变成你直播间最省心的传输底座——现在就去打开 OBS按这份清单把第一个 NDI 源接进来吧。【免费下载链接】obs-ndiDistroAV (formerly OBS-NDI): NDI integration for OBS Studio项目地址: https://gitcode.com/gh_mirrors/ob/obs-ndi创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考