1mangohud(1) mangohud mangohud(1)
2
6 mangohud - enable MangoHud on any application
7
10 mangohud [--dlsym] COMMAND
11
14 MangoHud is a Vulkan/OpenGL overlay for monitoring FPS, temperatures,
15 CPU/GPU load and more.
16
19 MangoHud can be enabled for Vulkan applications by setting MANGOHUD=1
20 as environment variable.
21 To load MangoHud for any application, including OpenGL applications,
22 the mangohud executable can be used. It preloads a library via ld into
23 the application.
24 Note: some OpenGL applications may also need dlsym hooking. This can be
25 done by passing option --dlsym or by setting MANGOHUD_DLSYM=1 as envi‐
26 ronment variable.
27
30 MangoHud comes with a config file which can be used to set configura‐
31 tion options globally or per application. The priorities of different
32 config files are:
33 /path/to/application/MangoHud.conf
35 $XDG_CONFIG_HOME/MangoHud/{application_name}.conf
36 $XDG_CONFIG_HOME/MangoHud/MangoHud.conf
37 An example config file is located in /usr/share/doc/mangohud/Mango‐
39 Hud.conf, containing all available options.
40 A custom config file location can also be specified with the MANGO‐
42 HUD_CONFIGFILE environment variable.
43 Config options can also be set with the MANGOHUD_CONFIG environment
44 variable. This takes priority over any config file.
45
48 OpenGL: mangohud glxgears
49 Vulkan: MANGOHUD=1 vkcube
50 Steam: set your launch option to mangohud %command%
51 Lutris: add mangohud to the Command prefix setting
52 OpenGL with dlsym: MANGOHUD_DLSYM=1 mangohud glxgears
53 Custom config options: MANGOHUD_CONFIG="gpu_stats=0,font_size=12" man‐
54 gohud glxgears
55
58 MangoHud development takes place at https://github.com/flightless‐
59 mango/MangoHud.
60 Benchmarks created with MangoHud can be uploaded to https://flightless‐
61 mango.com.
62 mangohud(1)