DLSS shim: one-command build + install script for users (option B, user-supplied NVIDIA SDK) #967

New issue

Closed

opened 2026-10-23 08:02:06 +00:00 by sky_line · 1 comment

sky_line commented

2026-10-23 08:02:06 +00:00

Owner

Follow-up to #870 / #962. The shim (contrib/ngxshim, MIT) statically links NVIDIA's NGX loader from the SDK, so we cannot ship built shims; users build it from their own clone of the NVIDIA DLSS SDK (option B). Make that nearly effortless.

Wanted

contrib/ngxshim/build.sh /path/to/DLSS [OUTPUT_DIR] (Linux) and a Windows equivalent (build.ps1 / build.bat, MSVC or clang-cl, whatever the README already documents):
- checks prerequisites (cmake, a compiler, Vulkan headers; the SDK path has include/nvsdk_ngx_vk.h and the platform's NGX lib) with clear messages;
- configures + builds the shim in a temp build dir (release);
- copies libslipstream_ngx.so / slipstream_ngx.dll and the user's own runtime libraries from their SDK clone (libnvidia-ngx-dlss.so.* + libnvidia-ngx-dlssd.so.* / nvngx_dlss.dll + nvngx_dlssd.dll, from the SDK's rel folder) into the output folder (default: a dlss folder in the viewer's data dir, e.g. ~/.slipstreamviewer/dlss, %APPDATA%\SlipstreamViewer\dlss);
- installs with temp file + rename (never overwrites a library a running viewer has loaded in place);
- prints the exact RenderVKDlssShimPath value to set (or sets a default the viewer also looks in, see below).
Viewer: if RenderVKDlssShimPath is empty, also look in that default dlss folder, so after running the script DLSS just shows up in the upscaler list.
Never in CI, never shipped: the scripts only run on the user's machine against their own SDK clone (option B rules: no NVIDIA SDK files, headers or binaries in the repo or our builds).
Flatpak: document the path the sandboxed viewer can see (or skip Flatpak with a clear message).
Wiki page dlss-rr updated to: clone the SDK, run one command, restart.

Test

Fresh Linux box with the SDK cloned: build.sh ~/DLSS builds, installs, prints the setting; the viewer finds DLSS without setting the path.
Running the script while the viewer is open does not crash it (temp + rename).
Missing SDK / wrong path / no compiler: clear error, nothing half-installed.

Follow-up to #870 / #962. The shim (`contrib/ngxshim`, MIT) statically links NVIDIA's NGX loader from the SDK, so we cannot ship built shims; users build it from their own clone of the NVIDIA DLSS SDK (option B). Make that nearly effortless. ## Wanted - `contrib/ngxshim/build.sh /path/to/DLSS [OUTPUT_DIR]` (Linux) and a Windows equivalent (`build.ps1` / `build.bat`, MSVC or clang-cl, whatever the README already documents): - checks prerequisites (cmake, a compiler, Vulkan headers; the SDK path has `include/nvsdk_ngx_vk.h` and the platform's NGX lib) with clear messages; - configures + builds the shim in a temp build dir (release); - copies `libslipstream_ngx.so` / `slipstream_ngx.dll` and the user's own runtime libraries from their SDK clone (`libnvidia-ngx-dlss.so.*` + `libnvidia-ngx-dlssd.so.*` / `nvngx_dlss.dll` + `nvngx_dlssd.dll`, from the SDK's `rel` folder) into the output folder (default: a `dlss` folder in the viewer's data dir, e.g. `~/.slipstreamviewer/dlss`, `%APPDATA%\SlipstreamViewer\dlss`); - installs with temp file + rename (never overwrites a library a running viewer has loaded in place); - prints the exact `RenderVKDlssShimPath` value to set (or sets a default the viewer also looks in, see below). - Viewer: if `RenderVKDlssShimPath` is empty, also look in that default `dlss` folder, so after running the script DLSS just shows up in the upscaler list. - Never in CI, never shipped: the scripts only run on the user's machine against their own SDK clone (option B rules: no NVIDIA SDK files, headers or binaries in the repo or our builds). - Flatpak: document the path the sandboxed viewer can see (or skip Flatpak with a clear message). - Wiki page `dlss-rr` updated to: clone the SDK, run one command, restart. ## Test - Fresh Linux box with the SDK cloned: `build.sh ~/DLSS` builds, installs, prints the setting; the viewer finds DLSS without setting the path. - Running the script while the viewer is open does not crash it (temp + rename). - Missing SDK / wrong path / no compiler: clear error, nothing half-installed.

sky_line added the

feature

label

2026-10-23 08:02:06 +00:00

sky_line added this to the Slipstream project

2026-10-23 08:02:06 +00:00

sky_line referenced this issue from a commit

2026-10-23 08:40:34 +00:00

#967 DLSS shim: one-command build/install scripts + default dlss folder lookup

sky_line referenced this issue from a commit

2026-10-23 20:58:20 +00:00

#967: DLSS shim Windows script works with Visual Studio 2026