Manual Installation - optiscaler/OptiScaler GitHub Wiki

[!CAUTION] 0a. Download the latest stable build of Optiscaler from here.

We also have the Rolling/Nightly releases which might have some newer bleeding edge things - Nightly builds

Example image
image

[!NOTE] If you want to send a log file, set LogLevel=0 and LogToFile=true, reproduce the issue and zip the log if it's too big.

[!NOTE]

  • Pressing Insert should open the Optiscaler Overlay in-game with all of the options (ShortcutKey= can be changed in the config file).
  • Pressing Page Up shows the performance stats overlay in the top left, and can be cycled between different modes with Page Down (keybinds customisable in the overlay).
  • If Opti overlay is instantly disappearing after trying Insert a few times, maybe try Alt + Insert (reported workaround for alternate keyboard layouts).
  • For some games (e.g. Dying Light 2), mouse doesn't work in the overlay, so keyboard navigation is required - Arrow keys, Tab and Space

For more info, please check Readme - How it works?

[!TIP] 0b. Please check the General Compatibility List first for already documented fixes and workarounds - same for FSR4 Compatibility List

Step-by-step installation:

1. Extract all of the Optiscaler files by the main game exe

[!IMPORTANT] (for Unreal Engine games, look for the win_shipping.exe in one of the subfolders, generally <path-to-game>\Game-or-Project-name\Binaries\Win64 or WinGDK\, ignore the Engine folder)

Example paths - Expedition 33\Sandfall\Binaries\Win64, Jedi Survivor\SwGame\Binaries\Win64, Cyberpunk 2077\bin\x64, HITMAN 3\Retail, Warhammer 40,000 DARKTIDE\binaries, The Witcher 3\bin\x64_dx12

2. Rename OptiScaler's OptiScaler.dll (for old versions, it's nvngx.dll) to one of the supported filenames (preferred dxgi.dll, but depends on the game)$^1$

[!NOTE] For FSR2/3-only games that don't have DLSS (e.g. The Callisto Protocol or The Outer Worlds: Spacer's Choice Edition), you have to provide the nvngx_dlss.dll in order to use DLSS in Optiscaler - download link e.g. TechPowerUp

/

Step-by-step installation:

1. Extract all of the Optiscaler files by the main game exe

[!IMPORTANT] (for Unreal Engine games, look for the win_shipping.exe in one of the subfolders, generally <path-to-game>\Game-or-Project-name\Binaries\Win64 or WinGDK\, ignore the Engine folder)

Example paths - Expedition 33\Sandfall\Binaries\Win64, Jedi Survivor\SwGame\Binaries\Win64, Cyberpunk 2077\bin\x64, HITMAN 3\Retail, Warhammer 40,000 DARKTIDE\binaries, The Witcher 3\bin\x64_dx12

2. Rename OptiScaler's OptiScaler.dll (for old versions, it's nvngx.dll) to one of the supported filenames (preferred dxgi.dll, but depends on the game)$^1$

  • Spoofing is always enabled by default. If you want to disable it, then set Dxgi=false in OptiScaler.ini.
  • Step 3 is no longer needed since 0.7.7-pre12/0.7.8 - only required in some rare edge case where Optiscaler can't automatically locate nvngx_dlss.dll when spoofing - in such cases, just notify us and we'll improve the locator
  • With the changes mentioned above, spoofing working properly means nvngx replacement: Exists will be mentioned in the Opti Overlay, and that's the important part, nvngx.dll: Doesn't Exist is irrelevant if nvngx replacement exists.

3a. Either locate the nvngx_dlss.dll file (for UE games, generally in one of the subfolders under Engine/Plugins), create a copy, rename the copy to nvngx.dll and put it beside Optiscaler

3b. OR download nvngx_dlss.dll from e.g. TechPowerUp or Streamline SDK repo if you don't want to search, rename it to nvngx.dll and put it beside Optiscaler

[!TIP] If AMD/Intel and DLSS inputs aren't visible even after selecting Yes during Install, game requires adding Fakenvapi

[!CAUTION]

If you need Nukem or Fakenvapi, now check their respective pages:

[!TIP] [1] Linux users should add renamed dll to overrides:

WINEDLLOVERRIDES=dxgi=n,b %COMMAND%

[!IMPORTANT] Please don't rename the ini file, it should stay as OptiScaler.ini.

[!NOTE]

OptiScaler supports these filenames:

  • dxgi.dll
  • winmm.dll
  • d3d12.dll (from 0.7.7 nightlies)
  • dbghelp.dll (from 0.7.7 nightlies)
  • version.dll
  • wininet.dll
  • winhttp.dll
  • OptiScaler.asi (needs Ultimate ASI Loader x64 or similar)

[!NOTE]

Example of correct AMD/Intel installation (with additional Fakenvapi and Nukem mod)

Installation