Performance Monitoring

MANGOHUD

Introduction

800

MangoHUD is a highly customizable overlay for openGL and vulkan applications to monitor vital hardware information such as temperature, power draw and frequencies to name a few. This can be useful to keep an eye on hardware performance during gameplay as well as diagnostics tool to determine bottleneck.

Installation

Command Line Installation

MangoHUD is already in fedora repository and you can install mangoHUD with the following command using your favourite terminal. Detailed steps are as follows:

  1. Run the following command using your terminal of choice.

    sudo dnf install mangohud

  2. Key in your password (characters will not show when you type and that is normal) and press enter.

  3. A prompt will ask for your confirmation on the install package list information as well as the total install size. You should see both mangohud i686 and mangohud x86_64 listed.

  4. key in Y and press Enter and wait for the installation to finish.

  5. You’re done! MangoHUD is installed and ready for configuration.

Graphical Install

MangoHUD is searchable in your fedora graphical package manager such as Gnome Software and KDE Discover.

You will see two seperate version of mangoHUD when searching for it in the Graphical Package Manager, "Fedora (Linux)" as well as "Flatpak". To summarize the difference between both version, Fedora (Linux) version will install mangoHUD system wide (but not Flatpak application) while Flatpak version will only be able to be use on Flatpak applications.
KDE Discover
mangohud discover

On Fedora KDE Edition, you can open Discover and search for MangoHUD to install. Note that they will be two entries for MangoHUD, one for system install and another for Flatpak install. Install both if you’re planning on using MangoHUD on both system install and flatpak applications.

Using MangoHUD

Keyboard commands

Common keyboard combo to control MangoHUD ingame are as follows:

Key Combo Control

R-SHIFT+F12

Toggle overlay

R-SHIFT+F12

Change overlay position

R-SHIFT+F10

Toggle preset

L-SHIFT+F2

Toggle logging

L-SHIFT+F4

Reload configuration

Testing

You can test your MangoHUD installation by running glxgears, which should be pre-installed in fedora. Run the following command on your terminal.

mangohud glxgears

Steam

To use MangoHUD ingame, you will need to add mangohud to your game launch options as detailed below:

  1. Right click on the game that you want to enable MangoHUD overlay and click on "properties"

    steam game properties

  2. Under launch options, add the following line,

    800 
    mangohud %command%

  3. Click apply and launch the game.

By default MangoHUD overlay will not be enabled ingame, you will need to press the default key combo to enable it. The default combo key is R-SHIFT + F12 to toggle the overlay.

If you are using gamemode to run you games in steam, you can chain the launch option together. Here’s an example of launch option to use if using MangoHUD with gamemode

mangohud gamemoderun %command%

Configuring MangoHUD

Graphical Configuration Tool

You can configure and customize your MangoHUD overlay by using goverlay. It provides a graphical way to customize the look of the MangoHUD overlay with preview, you can even change the keyboard combo key if the defaults is not to your preference. Goverlay is included in fedora repository, so you can directly search the package using your Graphical Package Manager (Gnome Software, KDE Discover), or you can install goverlay using the terminal using the following command.

sudo dnf install goverlay

Then find "Goverlay" in your application launcher to start customizing MangoHUD overlay to your liking.

Config Files

By default, MangoHUD will use a preset configuration out of the box. To customize the file manually, you can create a configuration file per user under your ~/.config folder. Create the file using the following command

mkdir ~/.config/MangoHud
touch ~/.config/MangoHud/MangoHud.conf

You can then edit the file using you preferred text editor, for example

vi ~/.config/MangoHud/MangoHud.conf

You can refer to the example configuration to get you started located here.

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

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