From 16fc862ddba22e869ecc998768383a6ae5b96835 Mon Sep 17 00:00:00 2001
From: JMARyA <jmarya@hydrar.de>
Date: Wed, 4 Jun 2025 21:41:59 +0200
Subject: [PATCH] add mangohud

---
 technology/applications/gaming/MangoHUD.md | 79 ++++++++++++++++++++++
 1 file changed, 79 insertions(+)
 create mode 100644 technology/applications/gaming/MangoHUD.md

diff --git a/technology/applications/gaming/MangoHUD.md b/technology/applications/gaming/MangoHUD.md
new file mode 100644
index 0000000..2a6a7f4
--- /dev/null
+++ b/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
+```