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

Joshie

Last update: Nov 27, 2022

Related tags

Debugging Tools protongdb

Overview

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.

Full featured multi arch/os debugger built on top of PyQt5 and frida

1.1k Dec 26, 2022

Arghonaut is an interactive interpreter, visualizer, and debugger for Argh! and Aargh!

Arghonaut Arghonaut is an interactive interpreter, visualizer, and debugger for Argh! and Aargh!, which are Befunge-like esoteric programming language

2 Dec 10, 2021

A simple rubber duck debugger

Rubber Duck Debugger I found myself many times asking a question on StackOverflow or to one of my colleagues just for finding the solution simply by d

1 Nov 10, 2021

Visual Interaction with Code - A portable visual debugger for python

VIC Visual Interaction with Code A simple tool for debugging and interacting with running python code. This tool is designed to make it easy to inspec

1 Nov 16, 2021

Hdbg - Historical Debugger

hdbg - Historical Debugger This is in no way a finished product. Do not use this

2 Jan 2, 2022

Trashdbg - TrashDBG the world's worse debugger

The world's worse debugger Over the course of multiple OALABS Twitch streams we

21 Jun 17, 2022

The official code of LM-Debugger, an interactive tool for inspection and intervention in transformer-based language models.

LM-Debugger is an open-source interactive tool for inspection and intervention in transformer-based language models. This repository includes the code

110 Dec 28, 2022

Run-time type checker for Python

This library provides run-time type checking for functions defined with PEP 484 argument (and return) type annotations. Four principal ways to do type

1.1k Jan 5, 2023

GEP (GDB Enhanced Prompt) - a GDB plug-in for GDB command prompt with fzf history search, fish-like autosuggestions, auto-completion with floating window, partial string matching in history, and more!

GEP (GDB Enhanced Prompt) GEP (GDB Enhanced Prompt) is a GDB plug-in which make your GDB command prompt more convenient and flexibility. Why I need th

23 Dec 21, 2022

PINCE is a front-end/reverse engineering tool for the GNU Project Debugger (GDB), focused on games.

PINCE is a front-end/reverse engineering tool for the GNU Project Debugger (GDB), focused on games. However, it can be used for any reverse-engi

1.5k Jan 1, 2023

Fully Automated YouTube Channel ▶️with Added Extra Features.

Fully Automated Youtube Channel ▒█▀▀█ █▀▀█ ▀▀█▀▀ ▀▀█▀▀ █░░█ █▀▀▄ █▀▀ █▀▀█ ▒█▀▀▄ █░░█ ░░█░░ ░▒█░░ █░░█ █▀▀▄ █▀▀ █▄▄▀ ▒█▄▄█ ▀▀▀▀ ░░▀░░ ░▒█░░ ░▀▀▀ ▀▀▀░

249 Jan 2, 2023

This is a python helper package for Telebirr H5 Web payment integration helper.

Telebirr This is a python helper package for Telebirr H5 Web payment integration helper. The use case for this interface is payment via web. Third par

24 Dec 13, 2022

Qt-creator-boost-debugging-helper - Qt Creator Debugging Helper for Boost Library

Go to Tools Options Debugger Locals & Expressions. Paste the script path t

2 Apr 22, 2022

A little Python library for making simple Electron-like HTML/JS GUI apps

Eel Eel is a little Python library for making simple Electron-like offline HTML/JS GUI apps, with full access to Python capabilities and libraries. Ee

5.4k Jan 7, 2023

PyPacker: a dumb little script for turning Python apps into standalone executable packages on Windows

PyPacker: a dumb little script for turning Python apps into standalone executable packages on Windows PyPacker is my attempt at creating a way to make

9 Mar 15, 2022

GDB plugin for streaming defmt messages over RTT from e.g. JLinkGDBServer

Defmt RTT plugin from GDB This small plugin runs defmt-print on the RTT stream produced by JLinkGDBServer, so that you can see the defmt logs in the G

1 Dec 30, 2021

A little script and trick to make your heroku app run forever without being concerned about dyno hours.

152 Dec 25, 2022

Width-customizer-for-streamlit-apps - Width customizer for Streamlit Apps

🎈 Width customizer for Streamlit Apps As of now, you can only change your Strea

5 Aug 9, 2022

Python script to extract all Humble Bundle keys and redeem them on Steam automagically.

humble-steam-key-redeemer Python script to extract all Humble keys and redeem them on Steam automagically. This is primarily designed to be a set-it-a

74 Jan 8, 2023

Comments

fix reference before assignment error

Fixes

Traceback (most recent call last):
  File "./protongdb-master/protongdb.py", line 226, in <module>
    main()
  File "./protongdb-master/protongdb.py", line 141, in main
    print(f"[{x}] {description} ({launch_executable}{list_to_space_str_prefix(app_config_args, ' ')}){beta_str}")
UnboundLocalError: local variable 'beta_str' referenced before assignment

opened by Riesi 0

Owner

Joshie

🐸✨

GitHub

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

Related tags

Overview

protongdb

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

Requirements

Usage

Special Thanks

You might also like...

Full featured multi arch/os debugger built on top of PyQt5 and frida

Arghonaut is an interactive interpreter, visualizer, and debugger for Argh! and Aargh!

A simple rubber duck debugger

Visual Interaction with Code - A portable visual debugger for python

Hdbg - Historical Debugger

Trashdbg - TrashDBG the world's worse debugger

The official code of LM-Debugger, an interactive tool for inspection and intervention in transformer-based language models.

Run-time type checker for Python

GEP (GDB Enhanced Prompt) - a GDB plug-in for GDB command prompt with fzf history search, fish-like autosuggestions, auto-completion with floating window, partial string matching in history, and more!

PINCE is a front-end/reverse engineering tool for the GNU Project Debugger (GDB), focused on games.

Fully Automated YouTube Channel ▶️with Added Extra Features.

This is a python helper package for Telebirr H5 Web payment integration helper.

Qt-creator-boost-debugging-helper - Qt Creator Debugging Helper for Boost Library

A little Python library for making simple Electron-like HTML/JS GUI apps

PyPacker: a dumb little script for turning Python apps into standalone executable packages on Windows

GDB plugin for streaming defmt messages over RTT from e.g. JLinkGDBServer

A little script and trick to make your heroku app run forever without being concerned about dyno hours.

Width-customizer-for-streamlit-apps - Width customizer for Streamlit Apps

Python script to extract all Humble Bundle keys and redeem them on Steam automagically.

Comments

fix reference before assignment error

Owner

Joshie

GDB plugin for streaming defmt messages over RTT from e.g. JLinkGDBServer

pdb++, a drop-in replacement for pdb (the Python debugger)

Full-screen console debugger for Python

An improbable web debugger through WebSockets

Debugger capable of attaching to and injecting code into python processes.

pdb++, a drop-in replacement for pdb (the Python debugger)

Graphical Python debugger which lets you easily view the values of all evaluated expressions

Voltron is an extensible debugger UI toolkit written in Python.

NoPdb: Non-interactive Python Debugger

Tracing instruction in lldb debugger.Just a python-script for lldb.