NixOS系统中OBS Studio插件安装后不显示的排查求助

问题描述 #

在NixOS系统中安装OBS Studio及多款插件后，插件未在OBS界面中显示。已完成的操作如下：

已执行的安装步骤 #

修改configuration.nix文件，添加OBS及目标插件：

{ config, pkgs, ... }:

{
  environment.systemPackages = with pkgs; [
    obs-studio
    obs-studio-plugins.obs-shaderfilter
    obs-studio-plugins.obs-composite-blur
    obs-studio-plugins.obs-scale-to-sound
    obs-studio-plugins.obs-move-transition
    obs-studio-plugins.obs-gradient-source
    obs-studio-plugins.obs-backgroundremoval
  ];
}

执行系统重建命令：

sudo nixos-rebuild switch

排查与解决步骤 #

• 查看OBS启动日志定位加载问题
  带 verbose 参数启动OBS，获取插件加载的详细日志：

  obs-studio --verbose
  

  日志中会显示插件搜索路径、加载成功/失败状态，以及具体的错误原因（如依赖缺失、版本不兼容）。

• 验证插件与OBS版本兼容性
  检查当前OBS和插件的版本是否匹配，执行以下命令查看版本信息：

  nix-instantiate --eval -E 'with import <nixpkgs> {}; obs-studio.version'
  nix-instantiate --eval -E 'with import <nixpkgs> {}; obs-studio-plugins.obs-backgroundremoval.version'
  

  若版本差异过大，可切换到NixOS稳定分支（如nixos-23.11），或通过overlay机制调整插件版本以匹配OBS。

• 手动指定插件路径测试加载
  部分插件可能未被自动识别，可临时设置环境变量指定插件路径后启动OBS，逐个测试插件：

  export OBS_PLUGINS_PATH=$(nix-build '<nixpkgs>' -A obs-studio-plugins.obs-backgroundremoval)/lib/obs-plugins:$OBS_PLUGINS_PATH
  obs-studio
  

• 检查插件动态库依赖完整性
  用ldd命令检查插件的动态库是否存在缺失：

  ldd $(nix-build '<nixpkgs>' -A obs-studio-plugins.obs-backgroundremoval)/lib/obs-plugins/*.so | grep "not found"
  

  若有缺失的库，需在configuration.nix的environment.systemPackages中添加对应依赖包。

• 尝试用户级安装替代系统级安装
  将插件安装到用户环境而非系统环境，测试是否能正常加载：

  nix-env -iA nixpkgs.obs-studio-plugins.obs-shaderfilter
  

  重启OBS后查看插件是否显示。

内容的提问来源于stack exchange，提问作者Linuts