mangohud

Use mangohud on top of an application

$ mangohud [command]

$ <RightShift F11>

$ <RightShift F10>

$ <RightShift F12>

mangohud [options] -- [command] [command options]

--version
    Prints the version of MangoHud.

-d, --dlsym
    Loads MangoHud using LD_PRELOAD instead of requiring a launcher. Primarily for debugging.

--no-config
    Ignores the configuration file.

--config
    Specifies a custom configuration file path.

--output
    Output telemetry data to a csv file. Useful for performance regression analysis

MangoHud is an open-source, Vulkan and OpenGL overlay that displays hardware performance metrics on the screen. It's commonly used in gaming to monitor framerate, CPU/GPU usage, temperatures, memory usage, and other system statistics in real-time. It can be configured via a config file or environment variables to customize the displayed information and appearance. MangoHud is particularly useful for debugging performance issues, optimizing game settings, and ensuring the system is running within safe thermal limits.

It's a popular choice among Linux gamers and developers for its versatility and ease of use. MangoHud integrates with various game launchers and compatibility layers like Steam, Lutris, and Wine/Proton, making it a powerful tool for monitoring game performance across different platforms.

MangoHud relies on specific libraries and driver support for correct operation. Issues can arise from outdated drivers, unsupported hardware, or conflicts with other overlays. Proper configuration is crucial to ensure accurate readings and avoid performance overhead.

While MangoHud's overhead is generally small, it can become noticeable on lower-end systems when displaying a large amount of information.

MangoHud can be configured via a configuration file (`MangoHud.conf` typically located in `~/.config/MangoHud/` or `/etc/MangoHud/`), or by setting environment variables. Configuration file options override environment variables.

Many settings, that can be configured in mangohud config file, can be configured through the system's environment variables.
For example: MANGOHUD_FRAME_TIMING=1 enables frame timing graph. MANGOHUD_CPU_TEMP=1 shows the CPU temperature.

MangoHud was created by flightlessmango and initially focused on providing a comprehensive overlay for monitoring system performance in games on Linux. It quickly gained popularity within the Linux gaming community due to its flexibility and rich feature set. The project is actively maintained and receives frequent updates with new features, bug fixes, and improvements to performance. The project has active community support which contributes with features and bug fixes.

gamemode(1), vkcube(1)