Beta: July 23rd, 2025

Important

We need testers, especially those using Linux or macOS!
Please let us know about any issues you run into!

Warning

This is BETA software!
Please only use this version if you're willing to help us test it.
Your GMod install may break if things go wrong!

Since the Last Beta Release

• Patch: Add --disable-cache, which force redownloads patch files every tool run, and clears the cache on exit (#181)
• Patch: Add --no-sourcescheme (don't apply VGUI theme changes)
• Patch: Clear ChromiumCache/ChromiumCacheMultirun once all patches have been applied
  • Should address some issues with stale lockfiles, corrupt cache, etc
  • You can disable this with --skip-clear-chromiumcache
• Patch: Case-insensitive ALL VDF/ACF fields (fixes #182)
• Patch: Add path to error when deserializing Vdf files by @JohnPeel (#183)
• Patch: Fix issues with Steam app deserialization by only parsing GMod (fixes #184)
• Patch: Add more checks to GMod readiness state (FullValidateBeforeNextUpdate, BytesToDownload, BytesToStage)
• Patch: Write out how many MiB were downloaded for each patch file
• Patch: Use the correct type for ScheduledAutoUpdate
• Patch: Use a pid lockfile to prevent multiple instances running at once (script executor)
• Patch: Version check now pulls from new files branch, so we can update GModPatchTool's remote version separately from old GModCEFCodecFix
• GUI: Fix internal terminal size sometimes being wrong with a hack
• GUI: Add padding around terminal
• GUI: More reasonable window size
• Cargo: Update to Rust 2024 edition
• Cargo: Update dependencies
• Add ASCII Art :)

   ________  ___          ______        __       __  ______            __
  / ____/  |/  /___  ____/ / __ \____ _/ /______/ /_/_  __/___  ____  / /
 / / __/ /|_/ / __ \/ __  / /_/ / __ `/ __/ ___/ __ \/ / / __ \/ __ \/ / 
/ /_/ / /  / / /_/ / /_/ / ____/ /_/ / /_/ /__/ / / / / / /_/ / /_/ / /  
\____/_/  /_/\____/\__,_/_/    \__,_/\__/\___/_/ /_/_/  \____/\____/_/   
GModPatchTool (formerly GModCEFCodecFix)

🐸 Special thanks to Swamp Servers for sponsoring part of this release!

Beta: July 5th, 2025

Important

We need testers, especially those using Linux or macOS!
Please let us know about any issues you run into!

Warning

This is BETA software!
Please only use this version if you're willing to help us test it.
Your GMod install may break if things go wrong!

Since the Last Beta Release

• Patch: Replace --auto-mode with --launch-gmod and --skip-exit-prompt (and finish implementation)
• Patch: Migrate from keyvalues-parser to keyvalues-serde and properly deserialize VDF/ACF files
• Patch: Fix case-sensitivity for Software/Valve/Steam/Apps/ paths in VDFs
  • This should fix various config/path lookup errors like #177
• Patch: Add connect/stall timeouts for HTTP requests
• Fix issues with not calling exit handler in some error cases (#176)
• Fix trying to use gui with generate feature
• Generate: Copy compressed versions of symbols to an output destination
• Generate: Rename args to make more sense
• Migrate from HashMap to IndexMap for Manifest type
• Generate: Sort manifest at the end so the output manifest.json is consistent with the same input files
• Build: Check if LFS files have been checked out (#175)
• Cargo: Update dependencies

🐸 Special thanks to Swamp Servers for sponsoring part of this release!

❤️ Special thanks to @JohnPeel and @AkikoKumagara for helping with both code and testing for this release!

Beta: June 29th, 2025

Important

We need testers, especially those using Linux or macOS!
Please let us know about any issues you run into!

Warning

This is BETA software!
Please only use this version if you're willing to help us test it.
Your GMod install may break if things go wrong!

Initial Beta for GModPatchTool

• Complete rewrite of GModCEFCodecFix in Rust 🦀
• SIGNIFICANT performance improvements for both downloading and patching
• Better handling of upstream GMod updates (no more constant "failed to match the Original Checksum"!)
• Fixes the tool needing to be launched inside of an existing Terminal on Linux (#135)
• Fallback web server support (should help users unable to connect to GitHub to download patches, #139)
• Fixes issues with patched executable permissions on macOS/Linux (#161)
• Fixes running the tool as root/admin with no warning (#147)
• Fixes issues with GMod install path detection in some scenarios (#144)

🐸 Special thanks to Swamp Servers for sponsoring part of this release!

❤️ Special thanks to @JohnPeel and @AkikoKumagara for helping with both code and testing for this release!

September 26th, 2024

NOTE: We've changed the Windows release to be a ZIP file you have to extract first. This was necessary to address antivirus false-positives caused by it extracting itself (dumb, I know). If you have concerns, please see #126.

Since the Last Release

• Use PyInstaller's onedir instead of onefile for Windows release builds (since the latter keeps making AV flip out; should help #126)
• Update PyInstaller to v6.10.0 (and disable bootloader building, to see if it helps with AV false-positives)
• Update/pin upstream steam/vdf packages (fixes UnicodeDecodeError with appinfo.vdf sometimes)
• Fix not resolving symlinks for Steam install paths on Linux (fixes #122)
• Add support for Pop_OS!'s new "Cosmic Terminal" (#121)
• Fix potential duplicate Steam install paths on Linux
• Steam Library Folders Config is no longer loaded twice
• Local version is now hardcoded inside of the script

🐸 Special thanks to Swamp Servers for directly sponsoring part of this release!

💖 If you like what we're doing here, consider throwing a few dollars our way! This work is 100% funded by users of this tool!

July 15th, 2024

Since the Last Release

• Fixed "Invalid magic" error caused by new Steam Client Beta appinfo.vdf format (fixes #117)
  • Special thanks to @sonic2kk and @Matoking who submitted pull requests to fix it in the upstream repos!
  • Those PRs still haven't been merged upstream, but their efforts enabled us to fix it in our forks of ValvePython's vdf and steam
• Added -steam_path argument (fixes #113)
  • Add this to your GModCEFCodecFix command line to override Steam path detection with a path of your choosing
  • Example: ./GModCEFCodecFix-Linux -steam_path "/opt/customsteamdir"
  • Useful if you must have multiple Steam installs for some reason (not recommended!), or installed Steam somewhere non-standard
• solsticegamestudios/gmod-html@333505b: Flatpak/Snap/AppImage are now ACTUALLY supported on Linux
  • Special thanks to @Davilarek for reverse-engineering the gmod executable on Linux and patching it!
  • If you want to know more about the efforts that went into this, check out this comment
• Fixed the Join Discord button on the main menu "CEF failed to load" warning
• Updated the app icon
• Updated to PyInstaller 6.9.0 for our app builds

If you like what we're doing here, consider throwing a few dollars our way! This work is 100% funded by users of this tool! 💖

May 30th, 2024

Since the Last Release

• Fixed crashing issues caused by CEF 124.3.0-124.3.4 (by updating to 124.3.5)
• Downloading patch files no longer times out, ever (fixes #108)
• Added multi-Steam install detection for Linux
• Updated Proton warning for Linux to say what version is needed for GMod/CEF to work with it

If you like what we're doing here, consider throwing a few dollars our way! This work is 100% funded by users of this tool! 💖

May 2nd, 2024

Since the Last Release

• Updated to CEF 124.3.5 (Chromium 124.0.6367.119)
  • Note: CEF updates happen independently of CEFCodecFix releases, with updates to the manifest. This is just an FYI!
• We've made a new guide for installing/using GModCEFCodecFix
  • We think it's more user friendly than the old forum posts. Let us know if you have any suggestions for improving it!
• Steam installed through Snap is now supported on Linux (#105, fixes #102)
• solsticegamestudios/gmod-html@f25e088: chromium.log is now rotated so log files don't stay on disk and grow forever
• solsticegamestudios/gmod-html@92ebc22: GMod's -multirun launch option now works again
• solsticegamestudios/gmod-html@3e7d15f: Flatpak/Snap/AppImage are now supported on Linux and disable CEF sandboxing which prevented it from working before (fixes #64)

If you like what we're doing here, consider throwing a few dollars our way! This work is 100% funded by users of this tool! 💖

Hotfix: March 17th, 2024

Since the Last Release

• Replaced the libraryfolders.vdf approach for locating GMod installs (because it wasn't very reliable) with one that looks for the GMod appmanifest instead

If you like what we're doing here, consider throwing a few dollars our way! This work is 100% funded by users of this tool! 💖

March 13th, 2024

Since the Last Release

• Updated to CEF 120.2.7 (Chromium 120.0.6099.234)
  • Note: CEF updates happen independently of CEFCodecFix releases, with updates to the manifest. This is just an FYI!
• The requests library has been replaced with httpx
  • This should improve patch download speeds (with brotli) and solve a couple of edge cases with HTTP proxies
• Changed how we locate GMod installs by leveraging libraryfolders.vdf
• Patching for Windows 32-bit is enabled again, but isn't stable and probably won't work
  • This is pretty much just so devs can use -tools with GMod patched. We continue to recommend using 64-bit for all other scenarios
• Updated to Python 3.12 and PyInstaller 6.5.0
• Updated relevant SGS website links

If you like what we're doing here, consider throwing a few dollars our way! This work is 100% funded by users of this tool! 💖

September 29th, 2023

Since the Last Release

• Updated to CEF 116.0.27 (Chromium 116.0.5845.190) CEF 120.2.7 (Chromium 120.0.6099.234)
  • Note: CEF updates happen independently of CEFCodecFix releases. This is just an FYI!
  • This includes the fix for CVE-2023-4863
• The tool now uses a temporary directory for patch files (solves certain scenarios with read/write issues)
• Fixed Steam path detection for Flatpak

If you like what we're doing here, consider throwing a few dollars our way! This work is 100% funded by users of this tool! 💖