Skip to content

GOverlay 1.8.5

Latest
Latest

Choose a tag to compare

View all tags
@github-actions github-actions released this 05 Jul 02:16
1.8.5
593a89a

How to Solve OptiScaler Update and Uninstall Issues in GOverlay

If you are experiencing issues where OptiScaler cannot be uninstalled, keeps reappearing, or fails to update properly, follow this guide to clean up your installation and prevent these problems from happening again.

🛠️ Step-by-Step Guide

Step 1: Clear GOverlay Configuration

  1. Open GOverlay (version 1.8.5 or newer).
  2. Navigate to Settings > Status > click Clear configuration.
  3. Close GOverlay.
Clear configuration screenshot

Step 2: Restore Original Game Files (Choose Option A or B)

Because the old bug corrupted your local backups, you must restore the original, unmodified game files to clear the loop.

  • Option A (Recommended & Much Faster): Verify Game Files
    1. Open Steam.
    2. Right-click your game and select Properties > Installed Files.
    3. Click Verify integrity of game files. Steam will automatically scan, delete leftover OptiScaler DLLs, and download the original game files.
  • Option B (Full Reinstall):
    1. Uninstall the game from Steam.
    2. Open the game's installation folder in your file manager and manually delete any leftover files (such as OptiScaler.dll, .ini files, or .dll.b backups) to ensure a completely clean directory.
    3. Reinstall the game.

Step 3: Re-enable OptiScaler

  1. Start GOverlay.
  2. Recreate your OptiScaler configuration for the game.
  3. Copy the new launch command (the bgmod command) to your game's Steam launch options.
  4. Start the game.
    Everything is now clean. Future updates, channel swaps, and uninstalls will now work correctly.

🔍 How it Works & Why the Bug Occurred

The Normal Flow

To work, OptiScaler needs to place its wrapper files (like dxgi.dll or winmm.dll) inside the game's folder.

  1. When you first install OptiScaler, GOverlay makes a backup of the original game files.
  2. It then replaces or wraps them with OptiScaler's custom DLLs.
  3. When you click Uninstall changes, GOverlay deletes the OptiScaler DLLs and restores the original files from the backup.

The Bug

In older GOverlay versions, when you updated OptiScaler or swapped release channels (e.g., from Stable to Bleeding-Edge), the program would overwrite the backup file with the already modified OptiScaler DLLs instead of preserving the original game files.
As a result:

  • The original game files were lost.
  • The backup file became corrupted (containing a copy of the older OptiScaler DLL).
  • Clicking Uninstall simply restored the older OptiScaler files, causing OptiScaler to keep reappearing.

The Fix

In modern versions of GOverlay, backups are stored in a safe, isolated directory outside the game's folder:
~/.local/share/goverlay/gameconfig/<game-name>/backups/
This isolated folder is never touched when updating OptiScaler or swapping release channels. GOverlay only updates the active DLLs in the game folder. The original game backups remain safe and untouched until you explicitly click Uninstall changes, ensuring a clean restore every time.

Changelog 1.8.5

OptiScaler & DLL Management

  • ** new implementation ** Rewrote update and uninstall logic. No more github slow downs
  • Isolated Backups: Moved DLL backups to gameconfig/<game>/backups/ to avoid corruption.
  • Update Fixes: Resolved FSR version selection and OptiPatcher channel persistence.
  • ** Automate builds: ** Optiscaler, optipatcher, fakenvapi now have automatic builds
  • ** Bleeding-edge channel: ** Bleeding-edge channel now downloads the latest git code.

General

  • New Toggle: Added OBS_VKCAPTURE to the environment variables tab.
  • Cover Fallbacks: Added multi-CDN and web search fallbacks for Steam cover art.
  • Pascube data: Added more information to pascube benchmark + nickname support.
  • ** Updated Benchmarks:** Synchronized hardware comparison scores from pascube database
  • Safety Fallback: Implemented dynamic GPU 360p fallback for very low framerates.
  • **Clean Uninstalls: ** Improved uninstall cleanup to remove wrapper DLLs and config files
  • ** MangoHud Fixes: ** Made the engine_color configuration write unconditional.
  • ** EnvVar Preservation: ** Fixed a bug where saving or disabling tweaks would erase active tool variables
  • ** Streamlined Badges: ** Simplified the multi-badge list on game cards into a single transparent GOverlay icon badge.

UI & UX

  • Modern Scrollbars: Added thin semitransparent scrollbars across all tabs.
  • Quick Actions: Added a floating action button (FAB) on game cards for options.
  • What's New: Added a frameless release notes popup dialog.
Assets 7
Loading