#31 Create a Guide on Performance Monitoring for Gamers on Fedora
Closed by judithetugbo. Opened by judithetugbo.

Description

We need to create a guide that explains how to use MangoHUD and Gamescope on Fedora. These tools help gamers monitor important performance details like FPS (frames per second), CPU (central processing unit) usage, and GPU (graphics processing unit) usage while playing games. The guide should show how to install, set up, and use these tools to find and fix performance issues, making gaming smoother and more enjoyable.

Goals

  • Provide clear instructions on installing and using MangoHUD and Gamescope.
  • Help Fedora gamers understand key performance metrics like FPS, CPU, and GPU usage.
  • Enable users to diagnose and solve common performance problems.
  • Improve the overall gaming experience on Fedora by giving players useful monitoring tools.

How you can help

  • Share your experience using MangoHUD or Gamescope on Fedora.
  • Suggest tips or tricks to make the guide easy to understand.
  • Report any difficulties or bugs you encounter with these tools.
  • Help write the guide
  • Review the guide draft and offer feedback to improve clarity and usefulness.

Why this matters

Performance problems can make gaming frustrating, but many users don’t know how to check what’s causing slowdowns or crashes. MangoHUD and Gamescope provide real-time information that helps players see how their system is handling games. A clear guide will empower Fedora gamers to fix issues and enjoy smoother gameplay.

Additional context

This guide fits into the Fedora Gaming documentation under Optimization & Tools category in the proposed IA. MangoHUD and Gamescope are popular, open-source tools widely used in the Linux gaming community, making them ideal choices for Fedora users. Clear instructions will help new and experienced gamers get the most out of their hardware.


Hi, first draft submitted, PR #34 , hoping that the documentation is on par with the team's expectations. Will continue to draft soon with more details and add additional useful tools within the monitoring app subject such as Goverlay.

With the recently merge PR #34 #35 #36 and soon #37 (once it have been reviewed), maybe this issue can be close to track progress. Unless there are things that still missing, please do list it here so I can try my best to contribute if can.

Overall, well done @kamiraimei. You did a great job. I love how everything is coming together. In between, I have some few suggestions.

  1. Add this line of sentence before the MangoHud heading: This guide covers MangoHud installation, and basic configuration
  2. Remove the both in this sentence to be clear You’ll see both a system version and a Flatpak version. Install both if you want MangoHUD support for system and Flatpak applications.

Corrected version
You’ll see a system and a Flatpak version. Install both if you want MangoHUD support for system and Flatpak applications.

  • Could you please annotate the image? for the user to know the MangoHud they are installing
    2025-05-17_14_25_57-.png

  • Also, annotate the images in the steam section

2025-05-17_14_31_31-.png

One this is done we can close close this issue

Hi.

The draft is ready here, if all is good I will proceed with the PR request.

https://pagure.io/fork/kamiraimei/gaming/documentation/c/3a74bef96e9950a2538572250bb30d20262ed941?branch=main

Hi.

The draft is ready here, if all is good I will proceed with the PR request.

https://pagure.io/fork/kamiraimei/gaming/documentation/c/3a74bef96e9950a2538572250bb30d20262ed941?branch=main

You can create a PR for it to be merged. Thank you

Hi Judith, hope all is well. PR #40 is ready for merge. Once reviewed, I will merge the PR to the main branch and I think we can close this issue and focus on others.

Hi Judith, hope all is well. PR #40 is ready for merge. Once reviewed, I will merge the PR to the main branch and I think we can close this issue and focus on others.
Hi Kami, so sorry for the delays. I have reviewed, but just kindly fix this, and then you can merge. After that, we close this issue. Thank you so much for working on this.

Configuring MangoHUD section can be fixed this way

Method 1: Using 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 Steps
GOverlay is available in the Fedora repository. Choose one of the following installation methods:

Option 1: Graphical Installation

  • Search for the package using your graphical package manager (such as GNOME Software or KDE Discover)

  • Start the installation

Option 2: Terminal Installation

  • Enter the following command

bashsudo dnf install goverlay -y

  • Launch GOverlay from your application menu to start customizing MangoHUD to your preference.

Method 2: Manual Configuration Files
By default, MangoHUD uses a preset configuration. For custom settings, follow these steps .

Step 1. Create a config file under your user's home directory:

mkdir -p ~/.config/MangoHud
bashtouch ~/.config/MangoHud/MangoHud.conf

Step 2. Edit the file with your preferred text editor:

vi ~/.config/MangoHud/MangoHud.conf

Add a tip callout here
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.

Note: You can use numerals 1, 2 for the steps. Pagure is not previewing them as intended, so I added the Steps.

Hi, I already added the mangohud sections as discussed on the latest commit and already included in the PR #40 . Will merge once all the commit have been reviewed and approve.

PR #40 have been successfully merged to the main branch. We can close this issue and move on with the next one. Great work all!

PR #40 have been successfully merged to the main branch. We can close this issue and move on with the next one. Great work all!

Yeee good job

Metadata Update from @judithetugbo:
- Issue status updated to: Closed (was: Open)

Metadata