Performance Monitoring

This guide covers MangoHud installation, and basic configuration

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 a system 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

goverlay

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.

Installation

GOverlay is available in the Fedora repository. Installation can be done either by using Graphical Package Manager or using the terminal.

Graphical Installation

  1. Open your Graphical Package Manager (Gnome Software or KDE Discover)

  2. Search for the package "GOverlay"

  3. Click install.

  4. Once installation is finish, launch GOverlay from your Application Menu to start customizing MANGOHUD to your preference.

Terminal Installation

  1. Open your terminal

  2. Key in the command below and press enter.

    sudo dnf install goverlay -y
    bash

  3. Once installation finish, launch GOverlay from your Application Menu to start customizing MANGOHUD to your preference.

Configuring MANGOHUD Manually

By default, MangoHUD uses a preset configuration. For custom settings, create a custom config file using the following steps:

  1. Create a new config file under your user’s home directory:

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

  2. Edit the file with your preferred text editor:

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

  3. You can preview your configuration after each save by running the following command.

    mangohud glxgears

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 ›