2.2 KiB
| obj | repo | arch-wiki |
|---|---|---|
| application | https://github.com/flightlessmango/MangoHud | 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 overlayRShift+F11– Change overlay positionRShift+F10– Toggle presetLShift+F2– Toggle loggingLShift+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