K0bin / protongdb

Little helper to run Steam apps under Proton with a GDB debugger

Geek Repo:Geek Repo

Github PK Tool:Github PK Tool

protongdb

A small little helper for running games with Proton and debugging with GDB

Requirements

  • At least Python 3.5
  • protontricks pip package and its dependencies (pip install --user protontricks)

Usage

The basic usage is as follows:

On any Steam app that you have a prefix for (ie. started the game at least once) you can use

protongdb <appid> [args...]

to start it with a debugger.

You can find the appid for the game using the Properties > Updates tab of the game.

If the game crashes or you hit a breakpoint, you can run wine-reload to resolve any symbols, etc.

You can then get a backtrace or step-through the code like a native app.

Unlike Steam, environment variables are inherited from your environment, so specify them before protongdb (no need for %command% stuff).

Special Thanks

Thanks to the creators of protontricks as it had a lot of useful helper functions to make this work, and Rémi Bernon for the WineReload code.

About

Little helper to run Steam apps under Proton with a GDB debugger

License:GNU General Public License v3.0


Languages

Language:Python 100.0%