Automated Installation - optiscaler/OptiScaler GitHub Wiki

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

We're also currently testing new prereleases before a new major version (recommended if RDNA4 user) - Nightly builds

image

[!NOTE] Since 0.7.7-Pre8, forced debugging is disabled. If you want to send a log file, set LogLevel=0 and LogToFile=true and zip the log if it's too big.

Automated

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

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. Run the OptiScaler Setup.bat script for automating the renaming process. BAT install should work for the vast majority of cases.

[!TIP] 2a. For AMD/Intel, about using DLSS Inputs - it is necessary to select Yes if you intend to use Nukem mod, if you want Reflex->AL2 conversion (both require Fakenvapi), and especially if the game has only DLSS - (this step is equivalent to Step 3 from Manual install for AMD/Intel)

3. If the batch file wasn't successful, please check the Manual steps.

For AMD/Intel, it usually fails at locating the nvngx_dlss.dll (devs put it in an unexpected place). In that case, it's enough to follow Step 3 from Manual install.

[!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:

[!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.
  • If Opti overlay is instantly disappearing after trying Insert a few times, maybe try Alt + Insert (reported workaround for alternate keyboard layouts).

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

[!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