Skip to content

Latest commit

Β 

History

History
75 lines (59 loc) Β· 3.34 KB

File metadata and controls

75 lines (59 loc) Β· 3.34 KB

πŸš€ gpupatch

Github All Releases Latest Release Workflow Status Rust

A highly optimized, dependency-free native engine for hot-patching Windows executables to force high-performance discrete GPU utilization.


πŸ“₯ Direct Download (Fastest)

For standard users, bypass the command line entirely:

  1. Click the green Download Latest Release button above.
  2. Under Assets, download gpupatch-windows-amd64.exe.
  3. Put it on your desktop and you're ready to go!

Features

  • ⚑ Blazing Fast: Native Rust implementation with no external dependencies.
  • πŸ’‰ Safe Injection: Seamlessly injects NvOptimusEnablement and AmdPowerXpressRequestHighPerformance symbols.
  • πŸ”₯ In-Place Patching: Intelligently toggles symbols on previously patched binaries.
  • πŸ–₯️ Built-in GUI: Includes a native graphical interface for easy management.

πŸ’‘ Key Improvements Over nvpatch

This tool is a from-scratch rewrite built to address edge-cases in the original nvpatch tool:

  • βœ… Strict PE Compliance: Correctly implements Binary Ordinal Sorting and header alignment.
  • βœ… Stand-Alone Binary: Entirely bypasses the heavy .NET runtime install requirement.
  • βœ… Antivirus Safe: Cleanses corrupt digital signatures to avoid heuristic malware traps.
  • βœ… Neophyte-Friendly: Adds graphical drag-and-drop support with persistent lock-screens.

Installation

Option 1: Direct Install via Cargo (Recommended)

If you have Rust installed, you can compile and install globally with a single command:

cargo install --git https://github.com/CynToolkit/gpupatch.git

Option 2: Building from Source

git clone https://github.com/CynToolkit/gpupatch.git
cd gpupatch
cargo build --release

The compiled binary will be available at ./target/release/gpupatch (or gpupatch.exe on Windows).

Usage

πŸ”₯ For Standard Users (Easy Mode)

The application includes an interactive mode designed for ease of use:

  1. Double-click the downloaded gpupatch.exe binary to launch the console window.
  2. Drag and drop your target game or application executable directly onto the window.
  3. Hit Enter. That's it! πŸŽ‰ (Alternatively, you can simply drag and drop an executable file directly onto the gpupatch.exe icon in Windows Explorer).

πŸ’» For Power Users (CLI Mode)

To force an executable to utilize the dedicated high-performance GPU:

gpupatch <input.exe> [<output.exe>]

To undo the patch:

gpupatch <input.exe> --disable

Testing

The test suite includes unit test verification and deterministic parity simulation:

cargo test