Performance Monitoring

MANGOHUD

Introduction

800

MangoHUD is a highly customizable overlay for OpenGL and Vulkan applications that displays real-time hardware information such as temperatures, power draw, clock speeds, and more. This makes it useful for monitoring system performance during gameplay and for diagnosing potential hardware bottlenecks.

Installation

Command Line Installation

MangoHUD is available in the Fedora repositories. You can install it using your favorite terminal with the following steps:

  1. Run the following command:

    sudo dnf install mangohud
    bash

  2. Enter your password when prompted (note: no characters will be shown as you type).

  3. Review the list of packages to be installed. You should see both mangohud.i686 and mangohud.x86_64.

  4. Type Y and press Enter to confirm.

  5. Wait for the installation to complete — and you’re done! MangoHUD is ready to use.

Graphical Install

MangoHUD can also be found in Fedora’s graphical package managers such as GNOME Software and KDE Discover.

When searching for MangoHUD in a graphical package manager, you may see two versions:

  • Fedora (Linux): Installs MangoHUD system-wide, but does not support Flatpak apps.

  • Flatpak: Works only with Flatpak applications.

Install the one that matches your use case — or both if you want full compatibility.
KDE Discover
mangohud discover

On Fedora KDE Edition, open Discover and search for MangoHUD. You’ll see both a system version and a Flatpak version. Install both if you want MangoHUD support for system and Flatpak applications.

Using MangoHUD

Keyboard Commands

Here are some default keyboard combos to control MangoHUD while in-game:

Key Combo Function

R-SHIFT + F12

Toggle overlay

R-SHIFT + F11

Change overlay position

R-SHIFT + F10

Toggle preset

L-SHIFT + F2

Toggle logging

L-SHIFT + F4

Reload configuration

Testing

To confirm MangoHUD is working, you can test it with glxgears (usually preinstalled on Fedora). Run:

mangohud glxgears
bash

You should see a performance overlay at the top of the window.

Steam

To enable MangoHUD in your Steam games:

  1. Right-click the game in your Steam library and select Properties.

    steam game properties

  2. Under Launch Options, enter the following:

    800 
    mangohud %command%

  3. Close the properties window and launch the game.

MangoHUD does not automatically show up. Use the default key combo R-SHIFT + F12 to toggle the overlay in-game.

If you’re using gamemode in Steam, you can combine launch options like this:

mangohud gamemoderun %command%

Configuring MangoHUD

Graphical Configuration Tool

You can customize MangoHUD’s overlay using GOverlay, a graphical front-end for MangoHUD. It allows you to preview and tweak the layout, enable/disable metrics, and change keyboard shortcuts.

GOverlay is available in the Fedora repository. You can search the package using your graphical package manager such as Gnome Software or KDE Discover and install it from there, or if you prefer using the terminal, install it with this command:

sudo dnf install goverlay -y
bash

Then, launch "GOverlay" from your application menu to start customizing MangoHUD to your preference.

Config Files

By default, MangoHUD uses a preset configuration. For custom settings, create a config file under your user’s home directory:

mkdir -p ~/.config/MangoHud
touch ~/.config/MangoHud/MangoHud.conf
bash

Then edit the file with your preferred text editor:

vi ~/.config/MangoHud/MangoHud.conf
bash

You can reference the example configuration located at:

/usr/share/doc/mangohud/MangoHud.conf.example

This file includes various examples of toggles and values to help you fine-tune your overlay.

Want to help? Learn how to contribute to Fedora Docs ›