flightlessmango /MangoHud

A Vulkan and OpenGL overlay for monitoring FPS, temperatures, CPU/GPU load and more.

★ 9,243⑂ 452👁 53⑃ 659● 1,540▤ 43
CMITCreated 2020-01-28discordapp.com/invite/Gj5YmBb
下载:v0.8.4v0.8.4 ↓0.8.42026-05-27
+3
日增长
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_w

Top issues

Latest release

v0.8.4 v0.8.4 2026-05-27
Fixes
- 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

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON