explaingit

flightlessmango/mangohud

★ 8,575CAudience · generalComplexity · 2/5Setup · easy

TLDR

MangoHud shows a live performance overlay on your screen while you play games on Linux, displaying metrics like frames per second, CPU and GPU usage, and temperatures, configurable per game, with built-in frame logging for benchmarking.

Mindmap

mindmap
  root((repo))
    What It Does
      Show game metrics
      Log frame data
      Compare benchmarks
    Metrics Available
      FPS and frame time
      CPU and GPU usage
      Temperatures
      Memory usage
    Setup Options
      Package manager
      Steam launch option
      Config file
    Audience
      Linux gamers
      PC benchmarkers
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Monitor frame rate and GPU temperature in real time during gameplay without alt-tabbing out of the game

USE CASE 2

Benchmark game performance before and after a driver update by logging frame data and comparing it on FlightlessMango.com

USE CASE 3

Set up per-game performance overlays in Steam using a launch option and toggle the display on and off mid-game

USE CASE 4

Record frame timing logs during a gaming session to diagnose stuttering or identify where performance drops occur

Tech stack

CVulkanOpenGLWaylandX11

Getting it running

Difficulty · easy Time to first run · 30min

Available via most major Linux package managers including Arch, Ubuntu, Fedora, and as a Flatpak, no unusual dependencies for install.

In plain English

MangoHud is a performance overlay for Linux games and applications that use Vulkan or OpenGL graphics. When you run a game with MangoHud active, it displays real-time information on screen: frames per second, frame times, CPU and GPU usage, temperatures, memory usage, and similar metrics. It works on both Wayland and X11 desktops. You activate it by prefixing a game launch command with "mangohud" or by setting an environment variable. For Steam games there is a launch option you can set per game. The overlay can also be toggled on and off while a game is running using a configurable keyboard shortcut. What gets shown in the overlay is controlled by a configuration file. You can pick which metrics to display, where the overlay appears on screen, what colors and font size to use, and whether to log data to a file. Preset configurations can be set up so you can switch between different display styles during a session without restarting. MangoHud also includes FPS logging: it can record frame timing data to a file during a game session, which you can then visualize. The project offers an online tool at FlightlessMango.com for uploading and comparing benchmark logs, and a local command-line tool called mangoplot. This makes it useful for comparing performance before and after a driver update or settings change. Installation is available through the package managers of most major Linux distributions, including Arch, Debian, Ubuntu, Fedora, Solus, and openSUSE, as well as via Flatpak. A build script is included for compiling from source. Both 64-bit and 32-bit library versions are provided to support older or 32-bit games running on a 64-bit system. The full README is longer than what was shown.

Copy-paste prompts

Prompt 1
Show me a MangoHud config file that displays only FPS, GPU temperature, and VRAM usage in the top-right corner with a small font
Prompt 2
How do I add MangoHud to a Steam game's launch options and bind a keyboard shortcut to toggle the overlay on and off?
Prompt 3
Write a MangoHud config that logs frame data to a file during gameplay so I can upload it to FlightlessMango.com for a benchmark comparison
Prompt 4
How do I install MangoHud on Ubuntu from a package manager and verify it works with a Vulkan game?
Prompt 5
What MangoHud config options let me switch between different preset display styles during a gaming session without restarting the game?
Open on GitHub → Explain another repo

← flightlessmango on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.