MangoHud-Konfiguration,
die zum Spiel passt.

Der Link zeigt auf eine Datei, die es nicht gibt. Fast immer so entstanden:

# falsch, wenn im Home-Verzeichnis ausgeführt:
sudo ln -s "$PWD/pgc" /usr/local/bin/pgc
# -> Link zeigt auf ~/pgc

Richtig – ohne sudo, weil ~/.local/bin schon im PATH liegt:

mkdir -p ~/.local/bin
ln -sf /pfad/zu/PerGameMangoConfig/pgc ~/.local/bin/pgc
pgc --check

Warum im Log steht, was zu tun ist: Die App prüft beim Start den Zustand und gibt den fertigen Befehl aus.

Der Prozessname ist gbr3, nicht PerGameMangoConfig. pgc prüft pgrep -x gbr3 und liest dann die Kommandozeile. Ein pgrep -f PerGameMangoConfig wäre unbrauchbar, weil es den eigenen Aufruf mitmatcht.

Drei mögliche Gründe:

• Die App war beim Schreiben nicht gestartet – Befehle vor dem Start werden absichtlich verworfen.
• Die Zeile war leer oder enthielt Tippfehler. Der Befehlsname muss in Großbuchstaben, Pfade dürfen Leerzeichen enthalten, wenn der ganze Befehl in Anführungszeichen steht.
• Etwas anderes als ; oder | wurde als Trenner verwendet – jedes Zeilenende ist ein eigener Befehl.

Im Log-Tab steht jede Zeile als [INFO] Externer Befehl: …. Damit lässt sich genau sehen, was angekommen ist.

MangoHud muss in Steam unter den Launch-Optionen stehen: mangohud %command%. Wird die Steam-Automatik benutzt, ist nach einer Änderung an der VDF ein Neustart von Steam nötig – die Steam-Sitzung hält die Library im Speicher.

Nach dem Speichern erinnert die App im Log daran, dass MangoHud manuell zu aktivieren ist – Taste Shift+F4.

Bei Wine/Proton ist der Prozessname gekürzt – /proc/PID/comm erlaubt nur 15 Zeichen. Die App liest deshalb /proc/PID/exe und /proc/PID/cmdline aus. Trotzdem kann die Zuordnung scheitern, wenn:

• das Spiel zu schnell beendet wurde,
• die SteamAppId in keinem Elternprozess steht,
• der Prozessname dem Spiel in keiner der Listen entspricht.

Abhilfe: pgc LOOKUP oder den Namen von Hand in die Liste übernehmen.

Beim Speichern wird eine Sicherung mit Zeitstempel neben die Datei gelegt: datei.conf.20260927_142530. Vorhandene Dateien werden nie gelöscht.

Damit gar nichts erst überschrieben wird, Config merken aktivieren – dann wird der bestätigte Pfad verwendet und nicht neu gesucht.

Die Cover kommen von SteamGridDB und Heroic. Es braucht eine Internetverbindung und ein installiertes curl. Die Bilder werden unter ~/.cache/heroic-covers/ zwischengespeichert.

KDE skaliert X11- und Proton-Fenster dann selbst, was zu Auflösungsproblemen führen kann. Die App warnt beim Start. Lösung: unter Systemeinstellungen → Anzeige → Skalierung auf „Anwendung skalieren" umstellen, oder Wayland-Support des Spiels nutzen.

Der Bau mit gbc3 -a erzeugt kein ausführbares Programm. Nötig ist:

cd PerGameMangoConfig
rm -rf .gambas && gbc3 -a
gambas3 --make "$PWD"

Danach PerGameMangoConfig.gambas neu starten. Prüfen, ob die Datei aktuell ist: ls -la PerGameMangoConfig.gambas – der Zeitstempel muss gerade sein.

In ~/mymangopergames/profiles.ini einen neuen Abschnitt anlegen, z. B. [ULTRA], darunter die MangoHud-Parameter als schlüssel=wert. Die vollständige Liste aller 49 Parameter steht im Reiter Profiles/Info und in mango.csv.

Danach pgc PROFILE ULTRA.

Ja – das ist der Hauptzweck. Alles, was eine Zeile in ~/mymangopergames/pgc_commands.log schreiben kann:

#!/bin/bash
# Profil beim Spielstart automatisch setzen
pgc "PROFILE MINI;CONF ~/.config/MangoHud/mini.conf;SAVE"

Unter Wayland funktioniert das ohne Fenster-Fokus, im Gegensatz zu Tastenkürzeln.

Sie bezieht sich nur auf den externen Helper pgc:

Die App selbst läuft auch ohne pgc – die Meldung betrifft nur die Bequemlichkeit, Befehle ohne Pfad aufzurufen.