https://github.com/misyltoad/protongdb
Little helper to run Steam apps under Proton with a GDB debugger
https://github.com/misyltoad/protongdb
Last synced: about 1 year ago
JSON representation
Little helper to run Steam apps under Proton with a GDB debugger
- Host: GitHub
- URL: https://github.com/misyltoad/protongdb
- Owner: misyltoad
- License: gpl-3.0
- Created: 2021-07-13T00:53:18.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2022-01-09T06:04:49.000Z (over 4 years ago)
- Last Synced: 2024-09-21T17:17:30.110Z (over 1 year ago)
- Language: Python
- Homepage:
- Size: 22.5 KB
- Stars: 24
- Watchers: 5
- Forks: 4
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# protongdb
## A small little helper for running games with Proton and debugging with GDB
## Requirements
- At least Python 3.5
- [protontricks](https://github.com/Matoking/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 [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](https://github.com/Matoking/protontricks) as it had a lot of useful helper functions to make this work, and [Rémi Bernon](https://github.com/rbernon) for the WineReload code.