MangoHud Version 0.2.0

New Major Features

• Configuration files
  • You can now use a config file to set your MANGOHUD_CONFIG options globally or per application. Automatically copied with the install script to $HOME/.config/MangoHud/MangoHud.conf which then will not be overwritten. An up to date default version can always be found at $HOME/.local/share/MangoHud/MangoHud.conf or within this repo.
  • The priorities for application/global config files are as follows:
    • 1: /path/to/application/dir/MangoHud.conf
    • 2: $HOME/.config/MangoHud/{wine-}{application_name}.conf
    • 3: $HOME/.config/MangoHud/MangoHud.conf
    • 4: $HOME/.local/share/MangoHud/MangoHud.conf
  • However, the MANGOHUD_CONFIG environment variable overrides any config file.
• FPS limiting
  • You can now limit the fps of an application with fps_limit. See the table below for usage.
• VSync options
  • It is now possible to force VSync on or off for an application. This includes four different VSync states:
    • 0 = Adaptive VSync
    • 1 = Off
    • 2 = Mailbox (VSync with uncapped FPS)
    • 3 = On
  • See VkPresentModeKHR(3) for details.

New Hud Features

Options	Usage in MANGOHUD_CONFIG=
Ability to display RAM & VRAM usage	ram vram
Application FPS limiter	fps_limit=x
Vsync (Options 0-3) - 0 = Adaptive - 1 = Off - 2 = Mailbox (VSync with uncapped FPS) - 3 = On	vsync=x
Display the system time	time
Crosshair overlay (Yes, this is semi-controversial)	crosshair crosshair_size=x crosshair_color=RRGGBB
Modifiable hud / logging toggle keybinds	toggle_hud=F1 toggle_logging=F3
Hud position offset	offset_x=x offset_y=x
Enable all hud options except for crosshair	full
Disable / hide the hud by default	no_display
Hud background transparency (0.0-1.0)	background_alpha=x
Disable CPU / GPU usage indicators	gpu_stats cpu_stats

Other Changes / Fixes

• Fixed a bug preventing GPU stats from showing in Feral ports / Feral3D titles.
• Removed unneeded git submodules
• Added "Frametime" label next to graph
• Fixed some potential application crashes
• Fixed varous ImGui styling issues
• Added support for "Zorin OS" and "Pop!_OS" within the build script
• General code formatting
• Fixed an issue with the previous release package not working on some Ubuntu 18.04 systems

Credits

@flightlessmango, @jackun, @telans, @guihkx, @DadSchoorse, @danyspin97

MangoHud Version 0.1.0

This is the first release of MangoHud!

MangoHud is a Vulkan overlay layer intending to be an alternative to the Mesa Vulkan overlay layer, and the DXVK hud. MangoHud works with any GPU capable of running Vulkan.

---

Features

• FPS and Frametime display.
• GPU and CPU utilization - per core or just the average.
• GPU and CPU temperature reporting.
• Vulkan engine reporting (DXVK, Feral, etc)
• Logging capabilities
  • Records FPS, CPU & GPU utilization.
  • Outputs to a log file of your choosing with the environment variable MANGOHUD_OUTPUT (required)
  • Use F2 to start and stop logging.
• Ability to change the font to your liking with MANGOHUD_FONT. Must point to a TTF or OTF file.
• Moveable & resizeable hud - see MANGOHUD_CONFIG in the README.
• Ability to disable/enable the hud with the F12 key.
• Now standalone from Mesa! Read below for details.

Recently Changed

As of a few days ago, MangoHud was a fork from Mesa with the overlay files modified to produce the hud. We have managed to serperate the hud from Mesa to give it it's own repository here.

This cuts compile times significantly, which is great if you wish to compile the hud yourself.

Installation

You can download the attached release and simply run the included ./install.sh.

Run MangoHud by using the environment variable MANGOHUD=1.

Alternatively, you can build this yourself to stay on top of all changes by cloning the repository and running ./build.sh install. Instructions are in the README here.

Suggestions / Contributions

Any suggestions or changes for features you might have are greatly appreciated, we will try our best to incorporate them. If anyone runs into any issues, please file a bug report.

Credits

Special thanks to @telans and @jackun . Without their help this release would not have been possible.