Skip to content

Agustinm28/Optiscaler-Client

Folders and files

NameName
Last commit message
Last commit date

Latest commit

ย 

History

157 Commits
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 
ย 

Repository files navigation

โœฆ OptiScaler Client

GitHub Release License: GPL-3.0-or-later Platform: Windows Platform: Linux

โš ๏ธ 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.


Screenshots

  • Main window
1 0 4_A
  • Game management
oc_01
  • Game management after installation
oc_02

๐Ÿš€ Key Features

Game Discovery

  • Multi-Platform Auto-Scanner โ€” Scans Steam, Epic Games, GOG, EA, Ubisoft, Battle.net, and Xbox/Microsoft Store libraries in parallel. On Linux, only Steam is 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 and beta 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 INT8 Extras โ€” INT8 shader injection for non-RDNA 4 GPUs.
  • OptiPatcher โ€” ASI plugin loader, automatically configured with LoadAsiPlugins=true in OptiScaler.ini.

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.

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 โ€” Configure default OptiScaler, Extras, and OptiPatcher versions for Quick Install.
  • Beta Channel Toggle โ€” Show or hide beta 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 and Extras versions to free storage.
  • 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.

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 libraries.
  • Manual add/install flows currently target executable files (.exe) for game selection.

๐Ÿ›ก๏ธ 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 Feature Branch (git checkout -b feature/AmazingFeature).
  3. Commit your changes (git commit -m 'Add some AmazingFeature').
  4. Push to the branch (git push origin feature/AmazingFeature).
  5. Open a Pull Request.

๐Ÿ“„ License & Acknowledgments

License

OptiScaler Client is free software: you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.

This program is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License for more details.

Copyright (C) 2026 Agustรญn Montaรฑa (Agustinm28)

Acknowledgments & Third-Party Software

  • Special thanks and deep respect to the OptiScaler development team for creating and maintaining this incredible software that enhances gaming experiences for countless users worldwide.
  • OptiScaler: The core upscaling technology that makes this possible.
  • fakenvapi: Essential compatibility layer developed by the OptiScaler team.
  • OptiPatcher: ASI plugin loader by the OptiScaler team.
  • NukemFG (DLSSG-to-FSR3): Frame Generation bridge by Nukem.

This client application is merely a frontend interface to help users more easily manage and install the amazing work done by the OptiScaler team and other contributors. While OptiScaler Client itself is licensed under GPL-3.0-or-later, the third-party components it downloads and manages may be subject to their own respective licenses.


Developed with โค๏ธ

About

A modern manager for OptiScaler

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages