MCPcopy Index your code
hub / github.com/Recol/DLSS-Updater

github.com/Recol/DLSS-Updater @V4.2.2

Chat with this repo
repository ↗ · DeepWiki ↗ · release V4.2.2 ↗ · + Follow
1,576 symbols 4,972 edges 96 files 1,294 documented · 82% updated 2d agoV4.2.2 · 2026-07-05★ 9782 open issues
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

DLSS Updater

Update every DLSS / XeSS / FSR DLL across all the games on your system — from one place.

CodeQL CodSpeed Version Downloads Buy Me A Coffee

Python Flet Platform License

Recol%2FDLSS-Updater | Trendshift Recol%2FDLSS-Updater | Trendshift

dlss_updater

[!TIP] Quick start (Windows): winget install "DLSS Updater" — then launch and hit scan. Prefer Linux? Grab the Flatpak. Full options are in Installation.


Contents


Overview

DLSS Updater scans the games installed on your system, detects the upscaling and frame-generation DLLs they ship with, and replaces them with newer versions — with automatic backups so you can always roll back. It runs on Windows and Linux and understands games from every major launcher.

DLSS Updater - Games view

⭐ Star History

<img alt="Star History Chart" src="https://api.star-history.com/image?repos=Recol/DLSS-Updater&type=date&legend=top-left" />


Features

🖥️ Cross-Platform

Runs on Windows & Linux and detects games from every major launcher — Steam, Epic, GOG, Ubisoft, EA, Battle.net & Xbox.

🔄 Updates Everything

DLSS, Ray Reconstruction, Frame Generation, Streamline, XeSS, FSR & DirectStorage — all at once, or one binary at a time.

🎛️ DLSS Presets

Apply global or per-game SR / RR / FG preset overrides on Windows (NVIDIA), or per-title SR overrides with GPU recommendations on Linux.

🖼️ Smart Game Images

Optional Steam Web API matching for near-perfect banners, plus custom banner & name overrides that survive rescans.

💾 Safe by Default

Every binary is backed up before it's touched — restore any DLL in one click from the Backups tab.

🚫 Custom Blacklist

Skip (or force) any title with your own per-game blacklist, layered on top of the community list.

🖥️ Platform & Launcher Support

Cross-platform on Windows and Linux, with detection for the launchers below:

Launcher Windows Linux Notes
Steam Includes Proton games on Linux
Epic Games Launcher
GOG Galaxy
Ubisoft Connect
EA Play
Battle.net Keep the launcher open before updating (not required for custom folders)
Xbox Game Pass (PC) Windows only
Custom folders Point at any game location manually

Linux specifics

  • Scans Steam Proton prefixes (~/.steam/steam/steamapps/compatdata/)
  • Supports Wine prefixes (Lutris, standalone Wine)
  • Automatic Steam path detection
  • Enable the DLSS Debug Overlay

🔄 DLL Updating

  • DLSS Super Resolution, plus Ray Reconstruction, Frame Generation and Streamline (Reflex Low Latency, etc.)
  • XeSS / XeSS Frame Generation / XeLL
  • FSR
  • DirectStorage (Windows only)
  • Update everything at once, or update individual binaries for a specific game

🎛️ DLSS Preset Configuration

  • Global presets (Windows, experimental) — the DLSS Settings card on the home page applies preset overrides to every game via the NVIDIA driver base profile (the same mechanism as the NVIDIA App's global override). Shows the currently applied preset; takes effect at the next game launch.
  • Super Resolution (SR): Default / Latest / Preset J / K / L / M
  • Ray Reconstruction (RR): Default / Latest model
  • Frame Generation (FG): Default / Latest / Preset A / B
  • ⚠️ Per-game overrides set in the NVIDIA App take priority — set its DLSS override to Default/Off to let this global setting apply.
  • Per-game presets (Windows, NVIDIA only) — the DLSS Settings action on any game (right-click a card, or its menu) opens a per-game panel that overrides SR / RR / FG for just that title via its NVIDIA per-application driver profile — the same mechanism the NVIDIA App uses for per-game overrides. It takes priority over the global setting for that game and applies at the next launch. The action is hidden automatically on non-NVIDIA systems.
  • The game's executable is detected automatically (NVIDIA driver lookup → folder heuristic → Steam manifest); when it can't be determined, a Change executable file picker lets you point at the correct .exe. Your executable and preset choices are remembered between sessions.
  • The panel reads back the value the driver is actually applying and distinguishes NVIDIA's predefined value from your own override. Reset to default clears the override (reverting to the game's predefined value) in one click.
  • DLSS SR Preset Override (Linux only) — configure SR presets (K/L/M) with GPU-based recommendations, and generate Steam launch options with copy-to-clipboard. Preset L is heavier and may reduce performance.

🖼️ Game Images & Custom Display

  • Steam Web API integration (optional) — connect your free Steam API key for near-perfect game image matching.
  • Auto-detects your Steam ID from the local installation
  • Four-tier app ID resolution: Manifest → Steam API → Store Search → FTS5 fuzzy match
  • One-click re-resolution to fix images from previous scans
  • Custom display — override any game's banner image and display name via the pencil icon on its card.
  • Search the local Steam app list to find any game (no API key required; credentials improve results)
  • Overrides are stored separately from scanner data, so a rescan can't revert them
  • Reset to default at any time

💾 Backups & Safety

  • Built-in backup system that snapshots game binaries before modifying them
  • Restore any modified DLL from the Backups tab
  • Build your own per-game blacklist to skip titles for any reason

Bundled DLL Versions

Technology Included version
DLSS Super Resolution 4.5 (3.10.6.0)
DLSS FG / RR 4.5 (3.10.5)
FSR 4 (4.0.2.0)
XeSS 2.0.2
XeSS Frame Generation 1.3.1
XeLL 1.3.0.5

See the Intel XeSS releases for per-game XeSS support details.


Installation

Windows

The MSI installer is the recommended way to install on Windows — it installs to Program Files with a proper Add/Remove Programs entry.

Winget (recommended)

winget install "DLSS Updater"

Chocolatey — install from the Chocolatey package page.

Direct download — grab DLSS.Updater.X.Y.Z.msi from the Releases page and run it.

Linux

The Flatpak is the recommended way to install on Linux.

Install Flatpak (if you don't have it)

# Ubuntu/Debian
sudo apt install flatpak
flatpak remote-add --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo

# Fedora — pre-installed

# Arch
sudo pacman -S flatpak
flatpak remote-add --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo

Install DLSS Updater

# Download DLSS_Updater-X.Y.Z.flatpak from the Releases page, then:
flatpak install --user DLSS_Updater-X.Y.Z.flatpak
flatpak run io.github.recol.dlss-updater

Uninstall

flatpak uninstall io.github.recol.dlss-updater

Custom game directories

The Flatpak has read-only access to common game locations by default: ~/, /mnt/, /media/, and /run/media/.

To grant access to additional directories:

flatpak override --user --filesystem=/path/to/games io.github.recol.dlss-updater

Or use Flatseal for a graphical permissions manager.

Linux notes

  • Steam Proton games: auto-detected at ~/.steam/steam/steamapps/compatdata/.
  • Wine games: scans ~/.wine/ and Lutris games at ~/Games/.
  • Custom paths: use flatpak override or the in-app dialog to grant access outside the sandbox.
  • Windows-only features: DLSS Debug Overlay and DirectStorage updates are disabled on Linux (grayed out with tooltips).
  • Logs: stored at ~/.local/share/dlss-updater/dlss_updater.log.
  • libmpv issue: if you hit a libmpv error, your distro likely doesn't bundle the library — see issue #125 for guidance.

Building from Source

Prerequisites & build steps

Prerequisites - Python 3.14 or higher (free-threaded build recommended) - Git - uv (Python package installer)

Windows

git clone https://github.com/Recol/DLSS-Updater.git
cd DLSS-Updater
uv sync --frozen

# Build the executable
uv run pyinstaller DLSS_Updater.spec

# …or build the MSI installer
pwsh build_msi.ps1

# Run it
.\dist\DLSS_Updater.exe

Linux

git clone https://github.com/Recol/DLSS-Updater.git
cd DLSS-Updater
uv sync --frozen

# Build the executable…
uv run pyinstaller DLSS_Updater_Linux.spec
# …or build the Flatpak
./build_flatpak.sh

# Run it
./dist/DLSS_Updater

Blacklisted Games

The list of unsupported (blacklisted) games is maintained as a CSV in a separate repository, so it can be updated independently of the application:

➡️ DLSS-Updater-Blacklist

Games are blacklisted when they:

  • Use their own version of DLSS for testing (e.g., 3DMark)
  • Replace the DLL on launch (e.g., Warframe)
  • Ship a DLSS version below 2.0 (non-updatable)
  • Have known compatibility issues with updated DLSS versions

You can override the blacklist via the Manage Blacklist button in the GUI to skip (or force) games for any reason.


Anti-Cheat

The tool does not globally block anti-cheat games, since some allow DLL replacement. Individual titles will be blacklisted as they're reported not to function.


Troubleshooting

Check the Issues section to see if your problem has already been reported. If not, open a new issue with as much detail as possible. Each release also ships detailed notes in release_notes.txt and on the Releases page.


Roadmap

  • Automation support with external software
  • Community-requested features — open an issue to suggest one

License & Credits

Licensed under the GNU Affero General Public License. See the LICENSE file for details.

This project uses NVIDIA's DLSS (Deep Learning Super Sampling) — see NVIDIA's DLSS page for more — and Intel's XeSS (Xe Super Sampling) — see Inte

Core symbols most depended-on inside this repo

Shape

Method 1,095
Function 324
Class 157

Languages

Python100%

Modules by API surface

dlss_updater/database.py157 symbols
dlss_updater/config.py70 symbols
dlss_updater/ui_flet/views/games_view.py64 symbols
dlss_updater/ui_flet/views/main_view.py63 symbols
dlss_updater/high_performance_updater.py55 symbols
dlss_updater/models.py50 symbols
dlss_updater/ui_flet/components/game_card.py44 symbols
dlss_updater/scanner.py44 symbols
dlss_updater/ui_flet/components/search_bar.py41 symbols
dlss_updater/search_service.py40 symbols
dlss_updater/ui_flet/theme/colors.py34 symbols
dlss_updater/ui_flet/views/backups_view.py32 symbols

For agents

$ claude mcp add DLSS-Updater \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact

Ask about this repo answers extend the page