Skip to content

Debugging ProtonUp‐Qt ‐ reporting Issues

Jump to bottom
DavidoTek edited this page May 24, 2024 · 2 revisions

It sometimes can happen that there is an issue with ProtonUp-Qt. If that is the case, you should search if there is already a similar issue reported at the GitHub Issues. If there is no similar issue yet, create a new one.

If the issue is not related to ProtonUp-Qt itself, but rather one of its supported compatibility tools like GE-Proton, take a look here: https://github.com/DavidoTek/ProtonUp-Qt/wiki/Issues-with-individual-compatibility-tools

For issues related to ProtonUp-Qt, create a new issue and provide a precise description of how to produce that issue. Tell us which operating system you are using, what you tried to accomplish, what buttons you clicked, and what exactly happened.

Capturing the Terminal output

You are asked to run ProtonUp-Qt from the Terminal and copy the output to the issue. This will help us with your issue as the output contains important information about the fault.

If you have never started a program from Terminal before, here are the steps you need to follow:

  1. Start the Terminal (Called Terminal on GNOME, Konsole on KDE)
  2. Verify whether you are using the Flatpak or AppImage version of ProtonUp-Qt. If you downloaded ProtonUp-Qt using your operating system's app store, you are likely using the Flatpak version. If you downloaded it from GitHub, you are using the AppImage version.
  3. Run ProtonUp-Qt from the Terminal by typing one of the following commands (highlighted):
    • If you use the AppImage version: ./ProtonUp-Qt-*.AppImage
    • If you use the Flatpak version: flatpak run net.davidotek.pupgui2
    • If you use the AUR/Pacstall version: protonup-qt

If the output looks similar to this, you did everything right:

ProtonUp-Qt 2.9.2 by DavidoTek. Build Info: Official AppImage by DavidoTek.
Python 3.10.4 (main, Apr  2 2022, 09:04:19) [GCC 11.2.0], PySide 6.7.0
Platform: Fedora Linux 40 (Workstation Edition) Linux-6.8.9-300.fc40.x86_64-x86_64-with-glibc2.39
Loading locale de / de_DE
Loaded ctmod GE-Proton
Loaded ctmod Wine-GE
Loaded ctmod Boxtron
Loaded ctmod D8VK (nightly)
Loaded ctmod Kron4ek Wine-Builds Vanilla
Loaded ctmod Lutris-Wine
Loaded ctmod Luxtorpeda

You can now copy the output to the GitHub issue. If you also want to add that highlighting, you can add ``` before the first and after the last line.

Clone this wiki locally