Optiscaler-Client

✦ OptiScaler Client

⚠️ Disclaimer: This is not an official OptiScaler project. I am not affiliated with the OptiScaler team. This is a personal project developed without any commercial purpose. Anyone is free to try and use this software at their own risk.

OptiScaler Client is a modern, high-performance desktop utility designed to simplify the installation, management, and update of the OptiScaler mod across your entire game library. Built with C# and Avalonia UI.

If this project saved you some time, consider buying me a coffee ☕ — totally optional, no strings attached.

---

Screenshots

• Main window

• Game management

• Game management after installation

---

Key Features

Game Discovery

• Multi-Platform Auto-Scanner — Scans Steam, Epic Games, GOG, EA, Ubisoft, Battle.net, Heroic, and Xbox/Microsoft Store libraries in parallel. On Linux, only Steam and Heroic (Epic Games, GOG) are scanned automatically.
• Custom Folder Scanning — Add any folder as a scan source for DRM-free or standalone games.
• Manual Game Addition — Add games by selecting the executable directly.
• Drive Root Filtering — Limit scanning to specific drives.
• Smart Exclusions — Pre-configured exclusions for non-game entries (e.g., Wallpaper Engine, Steamworks Redistributables).
• Cover Art Fetching — Automatically fetches game cover art from Steam API and SteamGridDB with local caching.

Installation & Uninstallation

• Quick Install / Uninstall — One-click toggle per game directly from the main view. Automatically downloads components if not cached.
• Auto Install — Detects game directory structure automatically, including UE5/Phoenix game layouts.
• Manual Install — Select the target executable manually for non-standard game structures.
• Bulk Install — Install OptiScaler across multiple games at once with platform filtering, component selection, and profile application.
• Injection Method Selection — Choose the DLL injection method: dxgi.dll, winmm.dll, d3d12.dll, dbghelp.dll, version.dll, wininet.dll, winhttp.dll.
• Backup & Restore — Original game files are backed up before installation and restored on uninstall.

Component Management

• OptiScaler — Core upscaling mod with stable, beta, and nightly version channels.
• Fakenvapi — Compatibility layer for AMD/Intel GPUs, installed alongside OptiScaler when needed.
• Nukem's DLSSG-to-FSR3 — Frame generation bridge that converts DLSS Frame Gen to FSR3.
• FSR 4 DLL (Swap) — Switch between INT8 and FP8 FSR 4 builds, or just swap the game's FSR 4 files directly without installing OptiScaler. Supports importing custom FSR 4 DLL versions.
• OptiPatcher — ASI plugin loader, automatically configured with LoadAsiPlugins=true in OptiScaler.ini.
• DLSS Enabler — Optional Frame Generation / Multi Frame Generation support, downloaded from an unofficial mirror since official builds are Nexus Mods-only.

Game Management Shortcuts

• Output Upscaler Selector — Override a game's upscaling technology (Default, FSR 2/3/4, XeSS, DLSS) directly from the Manage window, without opening Profiles.
• Upscaling Quality Selector — Override the upscaler's input resolution (Game controlled, Native AA, Ultra Quality, Quality, Balanced, Performance, Ultra Performance, or a custom scale factor) directly from the Manage window.
• Frame Generation & Multi Frame Generation — Pick a Frame Generation technology and multiplier (x3–x6 for DLSS-G output) with automatic path/nvngx/Streamline setup, or use Advanced Options for manual control. Includes DLSS Enabler support for Multi Frame Generation.
• Spoofing Toggle — Enable or disable vendor spoofing per game, with an Auto default.

Experimental Features

Optional integrations, enabled from Settings → Experimental:

• RenoDx Addons — Automatically fetches the per-game RenoDx addon for use with ReShade.
• Nvidia Neural Rendering Mod for AMD — Runs danielblnc's unofficial DLSS Neural Rendering mod on AMD GPUs, optionally combined with MatheusGViana's community OptiScaler wrapper so Neural Rendering and OptiScaler (including Multi Frame Generation) can run together.

Profiles

• OptiScaler Profiles — Create, edit, clone, and manage INI-based configuration profiles.
• Easy Mode Editor — Simple toggle-based interface for common settings.
• Advanced Mode Editor — Full section-based settings editor with search and sidebar navigation.
• Default Profile — Set a default profile that is applied automatically during Quick Install and Bulk Install.
• Built-in Default — "OptiScaler Standard" profile ships out-of-the-box with sensible defaults.
• Recommended Configuration — Per-game recommended settings pulled from the OptiScaler compatibility page and the Luma Unreal Engine list, with automatic injection method selection based on community data.
• Update Without Reinstalling — Changing a single simple setting offers a lightweight config update instead of a full reinstall.

Network & Proxy

• Supports system proxy settings and HTTP_PROXY / HTTPS_PROXY environment variables.
• Also supports explicit proxy configuration from app settings (including auth when required).
• Network settings are persisted in app configuration.

Settings & Customization

• Default Versions & Quick Install Settings — Configure the default OptiScaler, FSR 4, Fakenvapi, OptiPatcher, injection method, upscaler, and frame generation settings applied by Quick Install and when opening Manage.
• Beta & Nightly Channel Toggles — Show or hide beta and nightly OptiScaler versions in all version selectors.
• GPU Detection — Automatically detects installed GPUs with platform-specific providers and discrete GPU preference logic.
• Preferred GPU Selection — Choose which GPU is used for installation decisions.
• Scan Source Management — Enable/disable per-platform scanners and configure custom folders.
• Cache Management — View and delete cached OptiScaler, FSR 4, Fakenvapi, NukemFG, OptiPatcher, and RenoDX versions, and see total disk usage per component.
• SteamGridDB Integration — Optional API key for improved cover art fetching.
• Clear Application Cache — Full reset: delete all stored data (games, covers, config, analysis cache).

UI & UX

• List & Grid Views — Switch between compact list and card-based grid layouts (preference saved).
• Real-Time Search — Filter games by name as you type.
• Edit Mode — Reorder games via drag-and-drop or arrow buttons; hide/show games.
• Technology Badges — Visual indicators showing detected DLSS, FSR, XeSS, DLSS Frame Gen versions.
• Platform Badges — Icons for each supported game platform.
• Toast Notifications — Non-blocking notifications with progress bars for downloads and operations.
• Status Bar — Footer with real-time operation feedback and GPU info.
• Loading Overlays — Animated indicators during scanning and startup checks.
• Window State Persistence — Window size, position, and maximized state are saved across sessions.
• Configurable Animations — UI transitions can be disabled in Settings for performance.
• Collapsible Recommended Config Sidebar — Collapse the per-game recommended configuration sidebar in Manage to reclaim space.

Localization

Full interface translation in 14 languages:

Language	Language
English	Japanese
Spanish	Korean
German	Dutch
French	Polish
Italian	Russian
Portuguese (Brazil)	Turkish
Chinese (Simplified)	Chinese (Traditional)

---

Usage Guide

Getting Started

1. Find your games — Click "Scan Games" to automatically detect installed titles from all supported platforms. You can manage scan sources or add custom folders in Settings. For standalone games, use "Add Manually".
2. Select a Game — Click "Manage" next to any game, or use Quick Install for a one-click experience.
3. Install OptiScaler — From the Manage window, choose version, injection method, components, and profile, then click "Auto Install". Or just hit Quick Install from the main view to install with your configured defaults.
4. Bulk Install — Use the "Bulk Install" button to install OptiScaler on multiple games simultaneously.
5. Launch & Tweak — Start your game normally. Press Insert to open the OptiScaler in-game menu and adjust upscaling settings in real-time.

Profiles

1. Navigate to the Profiles tab in the sidebar.
2. Click "New Profile" to create a custom configuration.
3. Use Easy Mode for quick toggles or Advanced Mode for full INI control.
4. Set a default profile in Settings → Manage Default Versions so it's applied automatically during Quick Install.

Uninstalling

• Quick Uninstall — Click the Quick Install button on any game that already has OptiScaler installed.
• Manage → Uninstall — Open the game management window and click Uninstall.
• Both methods will restore original game files from backup and clean up all OptiScaler artifacts.

---

️ Installation & Requirements

Platform Support

• Windows
• Linux

Instructions

1. Download the latest release asset from Releases.
2. Extract the package.
3. Run OptiscalerClient.exe.

Notes

• The app is self-contained, so no external .NET runtime installation is required.
• On Linux, automatic scanner sources are focused on Steam and Heroic libraries.
• Manual add/install flows currently target executable files (.exe) for game selection.
• Nix/NixOS: A flake.nix is provided for building via Nix. Before the first build, regenerate the lock file by running nix flake update in the project root.
• Arch Linux (AUR): Available as optiscaler-client-bin, maintained by the community (yay -S optiscaler-client-bin). See packaging/aur/README.md for details.

---

️ Security & Antivirus False Positives

Is this software safe?

Yes, OptiScaler Client is completely safe and open-source. However, some antivirus programs may flag it as suspicious due to false positive detections.

Why does this happen?

• File Downloads: The app downloads .zip and .dll files from GitHub (OptiScaler, Fakenvapi, NukemFG)
• Heuristic Detection: Antivirus software may flag download behavior as "potentially unwanted"
• Unsigned Binary: The executable is not digitally signed (code signing certificates cost $100-300/year)

Common False Positives

• Zillya: Downloader.MLoki.Win64.10 — Known for aggressive heuristics
• Other AVs: May show generic "downloader" or "trojan" warnings

What you can do

1. Verify the Source: Download only from official GitHub Releases
2. Check VirusTotal: Upload the file to VirusTotal.com — most reputable AVs will show clean
3. Review the Code: This is open-source — you can inspect all code before running
4. Add Exception: Whitelist OptiscalerClient.exe in your antivirus settings

Transparency

All downloads are from official sources:

• OptiScaler: github.com/optiscaler/OptiScaler
• Fakenvapi: github.com/optiscaler/fakenvapi
• NukemFG: github.com/Nukem9/dlssg-to-fsr3

The application never collects personal data, connects to third-party servers, or performs any malicious actions. All source code is available for audit.

---

Contributing

We welcome contributions! If you'd like to improve OptiScaler Client:

1. Fork the project.
2. Create your **Feat