Go to file
2020-04-01 11:28:16 +03:00
.github create FUNDING.yml 2020-03-18 15:46:06 +00:00
assets update overlay example 2020-02-14 20:06:44 +13:00
bin Add missing parameters to MangoHud.conf 2020-03-29 15:47:31 +02:00
include elfhacks: check UINTPTR_MAX size of architecture bitness instead 2020-03-19 18:10:25 +02:00
modules Keep own copy of imgui/tables for now 2020-03-14 23:15:06 +02:00
src [OpenGL] Move ImGui functions to separate file 2020-04-01 11:28:16 +03:00
.gitignore add PKGBUILD 2020-01-30 20:22:48 +13:00
.gitmodules Keep own copy of imgui/tables for now 2020-03-14 23:15:06 +02:00
build.sh [build.sh] Allow passing extra options to meson configure with CONFIGURE_OPTS env var 2020-03-30 22:50:38 +03:00
libmangohud.conf Make paths in libmangohud.conf lowercase 2020-03-12 12:12:21 +02:00
libmangohud.conf.in Libdirs: once more, with feeling 2020-03-11 18:11:35 +02:00
LICENSE Added LICENSE 2020-02-05 00:20:07 +01:00
meson_options.txt Add 'use_xnvctrl' feature to allow building without libXNVCtrl support 2020-03-30 22:48:56 +03:00
meson.build Use more general sizeof to get arch "bitness" 2020-03-23 23:22:22 +02:00
PKGBUILD PKGBUILD moved submodule fetching into prepare() 2020-02-01 00:00:06 +01:00
README.md [config] Add MANGOHUD_CONFIGFILE envvar for specific configuration file 2020-03-29 00:05:52 +02:00

MangoHud

A modification of the Mesa Vulkan overlay. Including GUI improvements, temperature reporting, and logging capabilities.

Example:

Installation

Build

If you wish to compile MangoHud to keep up to date with any changes - first clone this repository and cd into it:

git clone --recurse-submodules https://github.com/flightlessmango/MangoHud.git
cd MangoHud

To build it, execute:

./build.sh build
./build.sh package

NOTE: If you are running an Ubuntu-based, Arch-based, Fedora-based, or openSUSE-based distro, the build script will automatically detect and prompt you to install missing build dependencies. If you run into any issues with this please report them!

Once done, proceed to the installation.

Install

Source

If you have compiled MangoHud from source, to install it, execute:

./build.sh install

Pre-packaged binaries

GitHub releases

If you do not wish to compile anything, simply download the file under Releases, extract it, and run ./mangohud-setup.sh install from within the extracted folder.

Arch-based distributions

If you are using an Arch-based distribution, install mangohud and lib32-mangohud with your favourite AUR helper. mangohud-git and lib32-mangohud-git are also available on the AUR if you want the up-to-date version of MangoHud.

Fedora

If you are using Fedora, to install the MangoHud package, execute:

sudo dnf install mangohud

Flatpak

If you are using Flatpaks, you will have to add the Flathub repository for your specific distribution, and then, to install it, execute:

For Steam flatpak
flatpak install com.valvesoftware.Steam.VulkanLayer.MangoHud

To enable MangoHud for all Steam games:

flatpak override --user --env=MANGOHUD=1 com.valvesoftware.Steam

Normal usage

To enable the MangoHud overlay layer for 64bit Vulkan and OpenGL, run :

mangohud /path/to/app

Or

mangohud.x86 /path/to/app for 32bit OpenGL

For Steam games, you can add this as a launch option:

mangohud %command%

Or alternatively, add MANGOHUD=1 to your shell profile (Vulkan only).

Hud configuration

MangoHud comes with a config file which can be used to set configuration options globally or per application. The priorities of different config files are:

  1. /path/to/application/dir/MangoHud.conf
  2. $HOME/.config/MangoHud/{application_name}.conf
  3. $HOME/.config/MangoHud/MangoHud.conf

You can find an example config in /usr/share/doc/mangohud


MANGOHUD_CONFIG and MANGOHUD_CONFIGFILE environment variables

You can also customize the hud by using the MANGOHUD_CONFIG environment variable while separating different options with a comma. This takes priority over any config file.

You can also specify configuration file with MANGOHUD_CONFIGFILE=/path/to/config for applications whose names are hard to guess (java, python etc).

A partial list of parameters are below. See the config file for a complete list.

Variable Description
cpu_temp
gpu_temp
Displays current CPU/GPU temperature
core_load Displays load & frequency per core
ram
vram
Displays system RAM/VRAM usage
full Enables all of the above config options
crosshair Adds a crosshair overlay at the centre of the screen
font_size= Customizeable font size (default=24)
width=
height=
Customizeable hud dimensions (in pixels)
position= Location of the hud: top-left (default), top-right, bottom-left, bottom-right
no_display Hide the hud by default
toggle_hud=
toggle_logging=
Modifiable toggle hotkeys. Default are F12 and F2, respectively.
reload_cfg= Change keybind for reloading the config
time
time_format=%T
Displays local time. See std::put_time for formatting help.
gpu_color
gpu_color
vram_color
ram_color
io_color
engine_color
frametime_color
background_color
text_color
Change default colors: gpu_color=RRGGBB
alpha Set the opacity of all text and frametime graph 0.0-1.0
background_alpha Set the opacity of the background 0.0-1.0
read_cfg Add to MANGOHUD_CONFIG as first parameter to also load config file. Otherwise only MANGOHUD_CONFIG parameters are used.
output_file Define name and location of the output file (Required for logging)
font_file Change default font (set location to .TTF/.OTF file )
log_duration Set amount of time the logging will run for (in seconds)
vsync
gl_vsync
Set vsync for OpenGL or Vulkan

Example: MANGOHUD_CONFIG=cpu_temp,gpu_temp,position=top-right,height=500,font_size=32

Note: Width and Height are set automatically based on the font_size, but can be overridden.

Vsync

OpenGL Vsync

  • -1 = Adaptive sync
  • 0 = Off
  • 1 = On
  • n = Sync to refresh rate / n.

Vulkan Vsync

  • 0 = Adaptive VSync
  • 1 = Off
  • 2 = Mailbox (VSync with uncapped FPS)
  • 3 = On

Keybindings

  • F2 : Toggle Logging
  • F4 : Reload Config
  • F12: Toggle Hud

MangoHud FPS logging

When you toggle logging (using the keybind F2), a file is created with your chosen name (using MANGOHUD_OUTPUT) plus a date & timestamp.

This file can be uploaded to Flightlessmango.com to create graphs automatically. you can share the created page with others, just link it.

Multiple log files

It's possible to upload multiple files when using Flightlessmango.com. You can rename them to your preferred names and upload them in a batch. These filenames will be used as the legend in the graph.

Log uploading walkthrough