MangoHud Version 0.3.1

Fixed installer

Minor Changes

Config now auto reloads when modified
Displaying Vulkan and OpenGL version

Bug Fixes

Fixed a bug where it would incorrectly state that the engine was OpenGL
Fixed Supertuxkart crashing on startup
Fixed Minecraft crashing on startup
Fixed a bug that would cause a crash when no cpu temp sensor was found
Don't use glibc private api __libc_dlsym
Try to guess display size with OpenGL (GL_VIEWPORT or GL_SCISSOR_BOX). Resize window if HUD is still in wrong position.

MangoHud Version 0.3.0

Fixed installer

New Major Features

• OpenGL Support
  MangoHud can now be used with OpenGL apps, native and wined3d.
• Running MangoHud
  You can now use the command mangohud to load either the OpenGL or Vulkan hud
  mangohud.x86 for 32bit OpenGL
• mangohud vkcube
• mangohud glxgears
  You can still load just the vulkan hud with MANGOHUD=1

New Hud Features

Options	Usage in MANGOHUD_CONFIG=
IO read and write for the app, not system.	io_read io_write
Vsync for OpenGL	gl_vsync
GPU Core and Memory clock	gpu_core_clock gpu_mem_clock
Alpha of all text and frametime graph	alpha=1.0
Change the time format	time_format=
Read config together with MANGOHUD_CONFIG	read_cfg as first parameter
Change keybind for refreshing config	reload_cfg=F4
Set amount of time in second that the logging will run for	log_duration

OpenGL Vsync

• -1 Adaptive sync
• 0 Off
• 1 On

Environment Variables

MANGOHUD_OUTPUT and MANGOHUD_FONT are now config params instead

output_file font_file

Added params to change colors of hud elements

MANGOHUD_CONFIG=gpu_color=RRGGBB

Options	Default color
text_color	#ffffff
gpu_color	#2e9762
cpu_color	#2e97cb
vram_color	#ad64c1
ram_color	#c26693
engine_color	#eb5b5b
io_color	#a491d3
frametime_color	#00ff00
background_color	#020202

Time Formatting

time_format = %H:%M
time_format = [ %T %F ]
time_format = %X # locally formatted time, because of limited glyph range, missing characters may show as '?' (e.g. japanese)

Keybinds

F4 Reload the config file

Bug Fixes

• Fixed bug that caused crashing on Nvidia with the full param
• Fixed mpv crashing when used with vulkan
• Fixed issue where the install script would bork the .json file
• offset_x and offset_y can now be negative values

Credits

@flightlessmango @jackun @telans

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.