mangohud(1)

💖 mangohud — the manual page, but make it cute 💖

okay bestie, sit down, hydrate, and let me tell you about mangohud(1) — the section 1 manual page for MangoHud. yes, the overlay. yes, the one everyone screenshots. it's iconic, it's giving main character energy, and it's about to be explained to you like we're in the group chat at 2am. 🦋

---

✨ NAME ✨

mangohud — enable MangoHud on any application 💅

---

✨ SYNOPSIS ✨

mangohud [--dlsym] COMMAND

---

✨ DESCRIPTION ✨

so basically, MangoHud is a Vulkan/OpenGL overlay that monitors your FPS, temperatures, CPU/GPU load, and more. that's it. that's the whole vibe check. 👑

---

✨ USAGE ✨

for Vulkan applications, you can turn MangoHud on just by setting MANGOHUD=1 as an environment variable. easy. lowkey effortless. ✨

but if you wanna load MangoHud for any application — OpenGL girlies included — you use the mangohud executable itself. what it does is preload a library via ld into the application. sneaky? a little. effective? absolutely. 💅

note: some OpenGL applications may also need dlsym hooking. you can do that by passing the option --dlsym, or by setting MANGOHUD_DLSYM=1 as an environment variable. don't skip this if your app is being weird, bestie, it's literally the fix. 🫶

---

✨ CONFIG ✨

MangoHud ships with a config file, and you can use it to set config options globally or per application. here's the priority order — the higher one wins, no cap:

1. /path/to/application/MangoHud.conf
2. $XDG_CONFIG_HOME/MangoHud/{application_name}.conf
3. $XDG_CONFIG_HOME/MangoHud/MangoHud.conf

there's an example config file chilling at /usr/share/doc/mangohud/MangoHud.conf, and it contains all available options. go look at it, it's basically a cheat sheet. 🌈

you can also point at a custom config file location with the MANGOHUD_CONFIGFILE environment variable. 🎀

and plot twist — config options can also be set with the MANGOHUD_CONFIG environment variable, and that one takes priority over any config file. periodt. 👑

---

✨ EXAMPLES ✨

here's the good stuff, the stuff you actually came for:

• OpenGL: mangohud glxgears
• Vulkan: MANGOHUD=1 vkcube
• Steam: set your launch option to mangohud %command%
• Lutris: add mangohud to the Command prefix setting
• OpenGL with dlsym: mangohud --dlsym glxgears
• Custom config options:

MANGOHUD_CONFIG="gpu_stats=0,font_size=12" mangohud glxgears

---

✨ ABOUT ✨

MangoHud development takes place at https://github.com/flightlessmango/MangoHud. 🧚

and benchmarks created with MangoHud can be uploaded to https://flightlessmango.com. 🍓

---

and that's the whole page, bestie!! 💜 this was mangohud(1) — section 1 of the manual, the one and only MangoHud, as documented on the mangohud manual page. stay hydrated, read your man pages, and go get those frames. 🎀✨💖