Skip to content

DLSS5.md

Latest commit

 

History

History
142 lines (95 loc) · 11.3 KB

DLSS5.md

File metadata and controls

142 lines (95 loc) · 11.3 KB
Raw

DLSS 5 optional runtime installation

Caution

Copyright, license, and security warning: this optional integration executes native Windows binaries with access to your GPU and files; several required runtime components are closed source. WanGP does not audit, authenticate, endorse, or redistribute NVIDIA, ReShade, RenoDX, or other third-party runtime binaries. The WanGP, Merserk, and DLSS5-Feeder MIT licenses do not grant rights to copy or redistribute those third-party components. Download only from sources you trust, verify signatures and hashes where available, scan every archive before use, and run it entirely at your own risk. You are responsible for complying with every component's license.

DLSS 5 support is optional and is not installed by the normal WanGP installer. It uses:

  • a WanGP depth-aware worker derived from the MIT-licensed DLSS5-Feeder;
  • a buildable WanGP Frame Generation worker;
  • the optional legacy no-depth worker from the MIT-licensed Merserk dlss5-visual-enhancer;
  • separately obtained NVIDIA DLSS runtimes, ReShade with full add-on support, and the RenoDX DLSS 5 add-on.

Automatic installation

Close WanGP, then double-click scripts\install_dlss5.bat. From a command prompt, the equivalent command is:

scripts\install_dlss5.bat

Read the warning and type I ACCEPT to continue. The script downloads all required workers and runtime components, verifies their pinned SHA-256 checksums, extracts them into the root dlss5 folder, and verifies the NVIDIA signatures on the standard DLSS and Frame Generation DLLs. It does not execute any downloaded installer or runtime during installation. The current worker also suppresses ReShade's unnecessary GitHub update check inside the worker process, so media processing does not need network access.

Existing matching files are kept. If different files already exist, the script changes nothing and asks you to stop WanGP and rerun scripts\install_dlss5.bat -Force; that mode backs up every replaced file first. Add -AcceptThirdPartyRisk only after reviewing the warning and this document if you need to skip the consent prompt.

The remaining sections document the same installation manually and provide integrity and troubleshooting information.

Install the worker bundle

Download WanGP-DLSS5-workers-v1.1.3.zip from the DeepBeepMeep dlss5-visual-enhancer fork release. The ZIP contains the two buildable WanGP workers, the optional legacy Merserk no-depth worker, attribution/license notices, and the required directory structure. It intentionally does not contain NVIDIA, ReShade, or RenoDX binaries.

Version 1.1.3 fixes x3 Neural Rendering for portrait outputs that exceed 4320 pixels in height while remaining inside the supported rotated 8K boundary.

Size:   132627 bytes
SHA256: EC470D8EB990CC04FE142C037B2F9E84C1D59A70B111DF51F110767897F5B0C2

Create WanGP/dlss5, then extract the contents of the ZIP into that folder. Do not extract it into postprocessing/dlss5, which contains Python source only. The archive entries begin with host/, dlss/, and dlssg/, so the result must look like this after the separately sourced dependencies are added:

WanGP/
|-- dlss5/
|   |-- host/
|   |   |-- nr-depth-worker.exe       # WanGP depth-aware worker
|   |   |-- nvngx.dll                 # legacy Merserk no-depth worker; optional
|   |   |-- dxgi.dll                  # ReShade full add-on build
|   |   |-- renodx-dlss5.addon64      # RenoDX DLSS 5 add-on
|   |   `-- nvngx_dlssnr.dll          # NVIDIA Neural Rendering runtime
|   |-- dlss/
|   |   `-- nvngx_dlss.dll            # NVIDIA DLSS Super Resolution runtime
|   `-- dlssg/
|       |-- dlssg-worker.exe           # WanGP open D3D12 Frame Generation worker
|       `-- nvngx_dlssg.dll            # NVIDIA Frame Generation runtime

Keep every runtime component in the indicated subfolder under the single root dlss5 folder.

Obtain the third-party dependencies separately

The worker ZIP is not a complete third-party runtime pack. Obtain and place these files yourself:

Warning

The two version-pinned RHI links below are community mirrors provided for convenience. They are not NVIDIA or RenoDX official releases. In particular, nvngx_dlssnr.dll 310.8.SF-v2 is a modified, unsigned NVIDIA-derived runtime; it is not included in the public NVIDIA DLSS SDK. Download and use it only if you accept the security, copyright, and licensing risks and its use is permitted in your jurisdiction. Otherwise, copy a genuine NVIDIA-signed nvngx_dlssnr.dll from licensed software you own that includes it. Never use random DLL download sites.

Destination Component Download or source
dlss5/host/dxgi.dll ReShade 64-bit with full add-on support reshade.me
dlss5/host/renodx-dlss5.addon64 RenoDX DLSS 5 add-on 4.70 Direct ZIP: renodx-dlss5_4.70.zip (community RHI mirror)
dlss5/host/nvngx_dlssnr.dll DLSS Neural Rendering 310.8.SF-v2 Direct ZIP: nvngx_dlssnr_310.8.SF-v2.zip (community-modified, unsigned)
dlss5/dlss/nvngx_dlss.dll NVIDIA DLSS Super Resolution NVIDIA DLSS SDK or another authorized NVIDIA distribution
dlss5/dlssg/nvngx_dlssg.dll NVIDIA DLSS Frame Generation NVIDIA DLSS SDK or another authorized NVIDIA distribution

For the tested Neural Rendering setup:

  1. Extract renodx-dlss5.addon64 from renodx-dlss5_4.70.zip into WanGP/dlss5/host.
  2. Extract nvngx_dlssnr.dll from nvngx_dlssnr_310.8.SF-v2.zip into the same folder.

The archive SHA-256 values are:

renodx-dlss5_4.70.zip:          D6E356D01B429AF6288F488A4926C44F1D779A7D4586EE8C79D04D3A09A536E6
nvngx_dlssnr_310.8.SF-v2.zip:  1DA35941894994EB087E017577829E492454E9BAE3A6A9397027069CEB74955C

The file names on the public RenoDX GitHub releases do not currently include this generic DLSS 5 add-on. Newer development builds are announced in the official RenoDX Discord; the links above stay pinned to the versions WanGP tested.

NVIDIA components are governed by the NVIDIA RTX SDK License. Review ReShade, RenoDX, and RHI licensing at their source before copying or redistributing their binaries.

Build the WanGP workers yourself

Install Visual Studio 2022 C++ build tools and a Windows SDK, then clone NVIDIA's official DLSS SDK repository. From the WanGP root, run:

git clone https://github.com/NVIDIA/DLSS C:\temp\NVIDIA-DLSS
powershell -ExecutionPolicy Bypass -File native\dlss5\build.ps1 -NgxSdk C:\temp\NVIDIA-DLSS

The script writes dlss5/host/nr-depth-worker.exe and dlss5/dlssg/dlssg-worker.exe. Pass -Target nr or -Target dlssg to build only one. See native/dlss5/LICENSE-DLSS5-Feeder for attribution.

Tested component integrity

These hashes identify the exact files tested with the v1.1.3 worker bundle. They do not establish safety or redistribution rights.

File SHA-256 Windows signature
dlss/nvngx_dlss.dll C85F971CE023C9F3492FC7455F0B01A24BA18EA39636407A846902C4360B0B7E Valid, NVIDIA Corporation
dlssg/nvngx_dlssg.dll 135EAF0733C1E37381A8C28ABCF7A862404A54132B81787C04E35D09EFC5E36F Valid, NVIDIA Corporation
host/nr-depth-worker.exe F8E2967912E5D596E8E36049370487B83620B0CB5845937B681CF835BAFC6D0B Unsigned, buildable from the fork source
dlssg/dlssg-worker.exe D93084633E0AAB4A08C43A5EE240176716EF73D87F06F35C2293509FBFC8BD00 Unsigned, buildable from the fork source
host/dxgi.dll 0CEE63F9C9F13F3AC909C5B4903F4DBB4B719A7AB3B4F13B0DEAF83C814B94F7 Unsigned
host/nvngx.dll 58191F4D38288C6BFBDA47EF56911D32052A9789E65714F4583F426E01464638 Unsigned
host/nvngx_dlssnr.dll 6EB209E764F39872625DEBD6ABAF45E2BB6322F6F270F781F70C059AE30B3927 Unsigned, community-modified SF-v2
host/renodx-dlss5.addon64 D5ADF82EB44B065F4C590AC91FE824BAB07AFEA0EB9F994BDE936710C8593952 Unsigned, RenoDX 4.70 community mirror

nr-depth-worker.exe is compiled from the included source and has a release-specific hash in the worker ZIP's SHA256SUMS.txt. Prefer rebuilding it yourself when you need source-to-binary assurance.

Before installation, scan the downloaded archives and the extracted directory with current security software. Microsoft Defender reported no detections for the development runtime on 3 September 2026; that result is informational, not a safety guarantee.

Hardware and diagnostics

Neural Rendering requires Windows 11 and GeForce RTX 30 or newer; RTX 30 is experimental, while RTX 40/50 are the primary targets. Frame Generation requires GeForce RTX 40 or newer, a compatible driver, and Hardware-accelerated GPU scheduling (HAGS). WanGP offers 2x through 4x on compatible RTX 40/50 GPUs and only offers 5x and 6x on RTX 50 GPUs when supported by the installed runtime.

Restart WanGP after installing or replacing the runtime. Unavailable modes are labelled with the missing requirement in their dropdown. WanGP respects an explicitly disabled HAGS setting; if Windows does not expose that setting reliably, the native DLSS capability probe decides availability instead of reporting a false HAGS disabled. For additional Frame Generation diagnostics, run dlss5/dlssg/dlssg-worker.exe --probe from the dlss5/dlssg directory. Neural Rendering writes diagnostic information to dlss5/host/ReShade.log.

nr-depth-worker.exe v1.1.2 or newer does not require network access while processing media and may safely be denied outbound access. Older workers appear to contact GitHub because ReShade performs an automatic version check inside the worker process; v1.1.2 disables that check.

Recorded-video depth and motion guides

Recorded videos do not contain the depth and motion information normally supplied by a game engine. WanGP estimates these guides automatically for DLSS 5 processing.

Open Config > Extensions > Spatial Upsamplers / Visual Refiners to configure both DLSS 5 paths:

  • DLSS 5 Depth Resolution Precision: Full Res, Half Res (default), or Quarter Res. Lower resolutions reduce depth-estimation time and memory use, at a possible cost to fine depth detail.
  • DLSS 5 Motion Vector: Original (default, faster) or RAFT (slower, generally better quality). This choice applies to both Neural Rendering and Frame Generation.

The Postprocessing, Late Postprocessing, and Media Flow controls expose DLSS 5 NR Intensity from 0.0 through 2.0, with a default of 1.0.

Because these guides are estimated from the video, results can differ from DLSS integrated directly into a game engine.

Applies to: Installation and diagnostics for the optional DLSS 5 runtime on supported Windows hardware. Available processors and generation options depend on the installed runtime.