flightlessmango /MangoHud
A Vulkan and OpenGL overlay for monitoring FPS, temperatures, CPU/GPU load and more.
★ 9,243⑂ 452👁 53⑃ 659● 1,540▤ 43
+3
Daily
9,243
stars
452
forks
53
watchers
659
prs
1,540
issues
43
releases
README
MangoHud
A Vulkan and OpenGL overlay for monitoring FPS, temperatures, CPU/GPU load and more.
!Example gif showing a standard performance readout with frametimes
---
- MangoHud
- Installation - Build From Source
- Dependencies
- Building with build script
- Installation - Pre-packaged Binaries
- GitHub releases
- Arch-based distributions
- Debian, Ubuntu
- Fedora
- Solus
- openSUSE
- Flatpak
- Normal usage
- OpenGL
- Hud configuration
- Environment Variables: MANGOHUD_CONFIG, MANGOHUD_CONFIGFILE, and MANGOHUD_PRESETSFILE
- Vsync
- OpenGL Vsync
- Vulkan Vsync
- Keybindings
- Workarounds
- FPS logging
- Online visualization: FlightlessMango.com
- Local visualization: mangoplot
- Metrics support by GPU vendor/driver
Installation - Build From Source
---
If you wish to compile MangoHud to keep up to date with any changes - first clone this repository and cd into it:
git clone --recurse-submodules https://github.com/flightlessmango/MangoHud.git
cd MangoHud
Using meson to install "manually":
meson build
ninja -C build install
By default, meson should install MangoHud to /usr/local. Specify install prefix with --prefix=/usr if desired.
Add -Dappend_libdir_mangohud=false option to meson to not append mangohud to libdir if desired (e.g. /usr/local/lib/mangohud).
To install 32-bit build on 64-bit distro, specify proper libdir: lib32 for Arch, lib/i386-linux-gnu on Debian-based distros. RPM-based distros usually install 32-bit libraries to /usr/lib and 64-bit to /usr/lib64.
You may have to change PKG_CONFIG_PATH to point to correct folders for your distro.
CC="gcc -m32" \
CXX="g++ -m32" \
PKG_CONFIG_PATH="/usr/lib32/pkgconfig:/usr/lib/i386-linux-gnu/pkgconfig:/usr/lib/pkgconfig" \
meson build32 --libdir lib32
ninja -C build32 install
Dependencies
Install necessary development packages.
- gcc, g++
- or gcc-multilib, g++-multilib for 32-bit support
- meson =0.54
- ninja (ninja-build)
- glslang
- Vulkan loader (libvulkan-dev)
- libGL/libEGL (libglvnd, libgl-dev, libegl-dev, mesa-common-dev, mesa-libGL-devel etc)
- GBM (libgbm-dev)
- libdrm (libdrm-dev)
- libcap (libcap-dev)
- sd-bus (libsystemd-dev, or elogind on non-systemd distributions)
- yaml-cpp (libyaml-cpp-dev)
- X11 (libx11-dev)
- XNVCtrl (libxnvctrl-dev), optional, use -Dwith_xnvctrl=disabled option with meson to disable
- D-Bus (libdbus-1-dev), optional, use -Dwith_dbus=disabled option with meson to disable
- wayland-client
- xkbcommon
Python 3 libraries:
- Mako (python3-mako or install with pip)
If distro's packaged meson is too old and gives build errors, install newer version with pip (python3-pip).
Meson options
| Option | Default | Description
| -------- | ------- | -
| with_nvml | enabled |Required for NVIDIA GPU metrics on wayland
| with_xnvctrl | enabled |Required for NVIDIA GPU metrics on older GPUs
| with_x11 | enabled |Required for keybinds on x11
| with_wTop issues
#1516RTX 4060 Mobile GPU Power 0%54 comments · 2025-01-01#1190Add a config parameter to display Vulkan presentation mode46 comments · 2023-12-17#1649gpu_fan option to show percent for Nvidia cards24 comments · 2025-04-08#937Does not work with Factorio on wayland24 comments · 2023-03-04#1607GPU power draw shows wrong numbers with 32bit applications18 comments · 2025-03-10#1473[Crashing] Darktide crashes at 98% gpu load18 comments · 2024-10-27#1285Doesn't work with Prince of Persia: Warrior Within16 comments · 2024-04-07#1084Gentoo - stopped working on Vulkan titles after upgrade to Vulkan 1.3.25016 comments · 2023-07-27
Latest release
v0.8.4 v0.8.4 2026-05-27Fixes - fixed Steam Overlay coexistence due to Vulkan layer procaddr/trampolining issues - fixed dx_api always showing dx? for DX9/11, also added DX3-7 - fixed imgui static library being installed unexpectedly - vulkan: removed redundant instance dispatch table reload - vulkan: fixed loader procaddr forwarding - vulkan: exported Vulkan layer negotiation entrypoint Contributors - @Billli11