---
name: "mangohud"
section: "1"
platform: "linux"
package: "mangohud"
version: "0.8.4-1"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/mangohud"
---

# mangohud(1)

enable MangoHud on any application

## NAME

mangohud - enable MangoHud on any application

## SYNOPSIS

**mangohud** \[--dlsym\] COMMAND

## DESCRIPTION

MangoHud is a Vulkan/OpenGL overlay for monitoring FPS, temperatures, CPU/GPU load and more.

## USAGE

MangoHud can be enabled for Vulkan applications by setting **MANGOHUD=1** as environment variable.\
 To load MangoHud for any application, including OpenGL applications, the **mangohud** executable can be used. It preloads a library via ld into the application.\
 Note: some OpenGL applications may also need dlsym hooking. This can be done by passing option **--dlsym** or by setting **MANGOHUD\_DLSYM=1** as environment variable.

## CONFIG

MangoHud comes with a config file which can be used to set configuration options globally or per application. The priorities of different config files are:

/path/to/application/MangoHud.conf\
 $XDG\_CONFIG\_HOME/MangoHud/{application\_name}.conf\
 $XDG\_CONFIG\_HOME/MangoHud/MangoHud.conf

An example config file is located in /usr/share/doc/mangohud/MangoHud.conf, containing all available options.

A custom config file location can also be specified with the **MANGOHUD\_CONFIGFILE** environment variable.\
 Config options can also be set with the **MANGOHUD\_CONFIG** environment variable. This takes priority over any config file.

## EXAMPLES

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*.\
 Benchmarks created with MangoHud can be uploaded to *https://flightlessmango.com*.