add mangohud

technology/applications/gaming/MangoHUD.md

@@ -0,0 +1,79 @@
+---
+obj: application
+repo: https://github.com/flightlessmango/MangoHud
+arch-wiki: https://wiki.archlinux.org/title/MangoHud
+---
+
+# MangoHUD
+MangoHud is a Vulkan and OpenGL overlay for monitoring system performance while inside applications and to record metrics for benchmarking.
+
+## Configuration
+MangoHud is configured via the following files, which are read in the following order:
+
+- `$XDG_CONFIG_HOME/MangoHud/MangoHud.conf`
+- `$XDG_CONFIG_HOME/MangoHud/APPLICATION-NAME.conf` (case-sensitive)
+- `$XDG_CONFIG_HOME/MangoHud/wine-APPLICATION-NAME.conf` (for Wine applications, case-sensitive, without the .exe extension)
+- `./MangoHud.conf`
+- `$MANGOHUD_CONFIGFILE` (via environment variables)
+
+> Tip: An example configuration file with comments can be found in the project's repository.
+
+## Usage
+### Keyboard commands
+- `RShift+F12` – Toggle overlay
+- `RShift+F11` – Change overlay position
+- `RShift+F10` – Toggle preset
+- `LShift+F2` – Toggle logging
+- `LShift+F4` – Reload config
+
+### Test configuration
+Verify if the program has been setup correctly:
+
+```
+$ mangohud glxgears
+$ mangohud vkcube
+```
+
+### Run a single game
+To run a game with MangoHud start it like this:
+
+```
+$ mangohud game
+```
+
+### Dynamic hooking
+Certain applications may require a special type of hooking, which can be specified via the `--dlsym` parameter or the `MANGOHUD_DLSYM` environment variable:
+
+```
+$ mangohud --dlsym game
+```
+
+### Use with GameMode
+To launch a game with both MangoHud and GameMode, chain the two commands into a single one, like this:
+
+```
+$ mangohud gamemoderun game
+```
+
+### Run a single steam game
+To make Steam start a game with MangoHud, right click the game in the Library, select Properties..., then in the Launch Options text box enter:
+
+```
+mangohud %command%
+```
+
+### Run Steam with MangoHud
+To avoid having to change launch options for all games, you may launch Steam directly with MangoHud:
+
+```
+$ mangohud steam-runtime
+```
+
+MangoHud will detect Steam and will avoid loading itself until a game is launched.
+
+### Enable for all Vulkan games
+To make MangoHud automatically launch with all Vulkan games, it is possible to set the following environment variable:
+
+```
+MANGOHUD=1
+```