roman/OptiScaler
Watch
1
0
Fork
You've already forked OptiScaler
 0
mirror of https://github.com/optiscaler/OptiScaler.git synced 2026-10-19 00:31:16 +00:00
Code Issues Projects Releases Packages Wiki Activity
Page: Manual Installation
Pages
Automated Installation Compatibility List Compatibility with other mods (Reshade, SpecialK) FSR4 Compatibility List Fakenvapi Frame Generation Options Home Hudfix incompatible Installation Known Issues Legacy Installation Manual Installation Nukem's dlssg‐to‐fsr3 OptiFG Simple Install Uninstallation Unreal Engine Tweaks Update OptiScaler when using DLSS Enabler Updating Optiscaler
28 Manual Installation
Michał Lewandowski edited this page 2026-05-12 13:38:16 +02:00
Table of contents

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

OptiScaler 0.9+ now comes bundled with latest Fakenvapi and Nukems dlssg-to-fsr3!

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

  • Added enable/disable FG shortcut key - default is End (customisable, Keybinds in Overlay, FGShortcutKey in INI)

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

  • If DLSS is still crashing, try using OptiScaler as d3d12.dll

/

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

  • Spoofing is always enabled by default. If you want to disable it, then set Dxgi=false in OptiScaler.ini.

Tip

RTSS

  • If you are using RTSS (MSI Afterburner, CapFrameX), please enable Use MS Detours API hooking in RTSS Setup/Settings (and try updating RTSS also if possible).
  • XeFG usually requires disabling Inject Reflex Markers to work properly.

image

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
  • dbghelp.dll
  • version.dll
  • wininet.dll
  • winhttp.dll
  • OptiScaler.asi (needs Ultimate ASI Loader x64 or similar)

Note

Example of correct installation

Installed

ARCHIVE

  • 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:

Note

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

Installation