whatisgithub

What is mangohud?

flightlessmango/mangohud — explained in plain English

Analysis updated 2026-06-24

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

In one sentence

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

What do people build with it?

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

What is it built with?

CVulkanOpenGLWaylandX11

How does it compare?

flightlessmango/mangohudwinfsp/winfspn64decomp/sm64
Stars8,5758,5798,582
LanguageCCC
Setup difficultyeasymoderatehard
Complexity2/54/54/5
Audiencegeneraldeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get 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.

So what is it?

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?

Frequently asked questions

What is mangohud?

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.

What language is mangohud written in?

Mainly C. The stack also includes C, Vulkan, OpenGL.

How hard is mangohud to set up?

Setup difficulty is rated easy, with roughly 30min to a first successful run.

Who is mangohud for?

Mainly general.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.