Skip to content

Joshua-Ashton/protongdb

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

7 Commits
 
 
 
 
 
 

Repository files navigation

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

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages