MangoHud Version 0.7.0

Parameters

• gpu_fan displays the gpu fan RPM, only works on AMD.
• gpu_junction_temp displays the junction temperature on AMD GPUs
• removed io_stats, just use io_read and io_write instead
• engine_short_names shortens the names of engines, e.g VULKAN becomes VK
• text_outline adds a colored outline around all text
• text_outline_color sets the color of the outline, default: 000000
• text_outline_thickness sets the thickness of the outline, default: 1.5
• temp_fahrenheit changes all temps to fahrenheit from celsius
• dynamic_frame_timing dynamically changes the range of the frametime graph
• duration displays the time since mangohud initialized
• gpu_voltage shows the current gpu voltage, only works on AMD
• fps_text override fps text
• horizontal_stretch sets the background to stretch across width of application (enabled by default)
• core_bars turns core_load into a histogram
• device_battery Shows battery level of wireless devices, accepts gamepad mouse
• device_battery_icon shows battery icon instead of percent

preset

This parameter allows you to choose from a number of config presets.
By default there are 5.

• 0: no display
• 1: only fps
• 2: horizontal
• 3: more detailed default layout
• 4: full
  These presets correspond with the steam deck performance overlay levels.
  You can create your own preset levels or overwrite the current ones by creating a config file in ~/.config/MangoHud/preset.conf
  To create or overwrite preset 3 you could add the follow to preset.conf

[preset 3]
vram
ram
battery

If you enter preset as a list e.g: preset=1,2,3 you can use the default keybind Shift_R + F10 to toggle throught presets (this only works on X11)
toggle_preset param allows you to change the default keybind

Changes

• Removed MANGOHUD_DLSYM because it's redundant
• Fixed core mhz when Cool'n'Quiet and similar is disabled in bios
• Added /etc/MangoHud.conf as a possible config location
• Add CPU architecture to vulkan manifest name
• mangoplot is a python script that graphs one or more mangohud csv logs
• mangoapp: resolved issue where different sized displays caused rendering issues
• mangohud script: guard so we don't add mangohud lib to LD_PRELOAD multiple times
• split mangohud into two shared libraries, one for vulkan and one for opengl. This should resolve issues where mangohud would init vulkan and opengl at the same time
• statically link stdc++. This fixed a lot of crashing issues when MANGOHUD=1 was set before starting steam.
• added support for zenergy kernel driver
• fixed alpha param that stopped working at some point
• added --version to mangohud script
• When using horizontal layout set table_columns param to current count of table_columns instead of manually
• Intel GPU: use fdinfo for GPU load
• logging: calculate fps data using frametime
• AMDGPU: get core clock from hwmon instead of gpu_metrics
• gamepad_battery is now deprecated use device_battery= mouse or gamepad
• Fixed a memory leak when resizing vulkan windows.
• logging: added process RSS and swap usage

Blacklist

• blacklist: if blacklisted application is hardcoded, don't proceed to load config blacklists
• blacklist: only print blacklist info message once
• blacklist: added more hardcoded entries:
• • tabtip.exe
• • steam.exe
• • wine64-preloader
• • explorer.exe
• • wine-preloader
• • iexplore.exe
• • rundll32.exe

0.7.0-rc1

Parameters

• gpu_fan displays the gpu fan RPM, only works on AMD.
• gpu_junction_temp displays the junction temperature on AMD GPUs
• removed io_stats, just use io_read and io_write instead
• engine_short_names shortens the names of engines, e.g VULKAN becomes VK
• text_outline adds a colored outline around all text
• text_outline_color sets the color of the outline, default: 000000
• text_outline_thickness sets the thickness of the outline, default: 1.5
• temp_fahrenheit changes all temps to fahrenheit from celsius
• dynamic_frame_timing dynamically changes the range of the frametime graph
• duration displays the time since mangohud initialized
• gpu_voltage shows the current gpu voltage, only works on AMD
• fps_text override fps text
• horizontal_stretch sets the background to stretch across width of application (enabled by default)
• core_bars turns core_load into a histogram

preset

This parameter allows you to choose from a number of config presets.
By default there are 5.

• 0: no display
• 1: only fps
• 2: horizontal
• 3: more detailed default layout
• 4: full
  These presets correspond with the steam deck performance overlay levels.
  You can create your own preset levels or overwrite the current ones by creating a config file in ~/.config/MangoHud/preset.conf
  To create or overwrite preset 3 you could add the follow to preset.conf

[preset 3]
vram
ram
battery

If you enter preset as a list e.g: preset=1,2,3 you can use the default keybind Shift_R + F10 to toggle throught presets (this only works on X11)
toggle_preset param allows you to change the default keybind

Changes

• Removed MANGOHUD_DLSYM because it's redundant
• Fixed core mhz when Cool'n'Quiet and similar is disabled in bios
• Added /etc/MangoHud.conf as a possible config location
• Add CPU architecture to vulkan manifest name
• mangoplot is a python script that graphs one or more mangohud csv logs
• mangoapp: resolved issue where different sized displays caused rendering issues
• mangohud script: guard so we don't add mangohud lib to LD_PRELOAD multiple times
• split mangohud into two shared libraries, one for vulkan and one for opengl. This should resolve issues where mangohud would init vulkan and opengl at the same time
• statically link stdc++. This fixed a lot of crashing issues when MANGOHUD=1 was set before starting steam.
• added support for zenergy kernel driver
• fixed alpha param that stopped working at some point
• added --version to mangohud script
• When using horizontal layout set table_columns param to current count of table_columns instead of manually
• Intel GPU: use fdinfo for GPU load
• logging: calculate fps data using frametime
• AMDGPU: get core clock from hwmon instead of gpu_metrics

Blacklist

• blacklist: if blacklisted application is hardcoded, don't proceed to load config blacklists
• blacklist: only print blacklist info message once
• blacklist: added more hardcoded entries:
• • tabtip.exe
• • steam.exe
• • wine64-preloader
• • explorer.exe
• • wine-preloader
• • iexplore.exe
• • rundll32.exe

MangoHud Version 0.6.9-1

Hotfixes

Fixed issue that applied picmip without option being set
Reverted x11 poller that was causing segfaults 06edee4
Fixed issues with horizontal and legacy_layout
Fixed amdgpu APU power and temperature reading
Fixed certain hud elements displaying incorrectly in horizontal
Fixed an issue causing segfault when using MANGOHUD_CONFIG

Contributors

@flightlessmango @jackun @gort818 @NoXPhasma @Atemu @kira-bruneau @Faalagorn

v0.6.9

MANGOHUD

Changes

• Added support for it8603 sensor
• Conform to VUID-VkDeviceCreateInfo-pNext-00373
• Add GalaxyClient, RedLauncher, Amazon Games and gamesope to blacklist
• Add Artix and Nobara to build.sh

Bug fixes

• Fixed a crash when using zink, and certain games using DXVK e.g. FarCry 3/4
• Fixed reporting amdgpu clock speed
• Fixed an issue with exec causing certain games to crash
• Fixed incorrect metrics for ryzen 7000 series iGPUs
• Fixed discovery of wine binary when using wine64 build

Parameters

• exec_name - Display current exec name.
• hud_compact - Display compact version of MangoHud.
• hud_no_margin - Remove margins around MangoHud.
• horizontal - Display Mangohud in a horizontal position.
• toggle_hud_position Toggle MangoHud postion. Default is R_Shift + F11
• fps_limit_method If FPS limiter should wait before or after presenting a frame. Choose late (default) for the lowest latency or early for the smoothest frametimes.
• picmip Mip-map LoD bias. Negative values will increase texture sharpness (and aliasing). Positive values will increase texture blurriness (-16 to 16)
• af Anisotropic filtering level. Improves sharpness of textures viewed at an angle (0 to 16)
• bicubic Force bicubic filtering
• trilinear Force trilinear filtering
• retro Disables linear texture filtering. Makes textures look blocky
• position new option: bottom_center

Contributors

@flightlessmango @jackun @gort818 @evelikov @Billli11 @sfrcorne @hannesmann @NoXPhasma @RPINerd @stephanlachnit @tim77 @Bitwolfies @Calchan @TheComputerGuy96 @FluffyFoxUwU @Gustash @0xC0ncord @KingKrouch @kkartaltepe @Leopard1907 @MasterDevX @oliverchang @virchau13 @baryluk @azn1999 @apprehensions

MangoHud Version 0.6.8

MangoHud

• Bumped layer api version to 1.3.0
  This fixes MangoHud not loading with latest DXVK
• Bumped meson to 0.60
• Only install data files if include_doc option is set
• Allow use of system nlohmann_json dependency
• Added metainfo file
• Fixed table_columns not working as expected
• Minor adjustments to hud elements and imgui
• Convert from printf's to SPDLOG
• Added MANGOHUD_LOG_LEVEL env variable
  it takes off, info, err, warn
• Added StarCitizen_Launcher.exe and InsurgencyEAC.exe to blacklist
• Added FCAT support
• Disabled gamepad_battery_icon by default
• Generalize control over socket so it works with OpenGL as well
• AMDGPU: fixed gfx and cpu power metrics being parsed incorrectly
• fps_only disables legacy_layout by default

MangoApp

• Added man page
• Install MangoApp layer to libdir_mangohud
• Prevent resizing of the MangoApp window when using fps_only.
  This prevents the hud from flickering when number of digits increase or decrease
• Fixed issues caused by us not releasing the XAtom.
  Namely preventing other apps from using the gamescope overlay and sometimes causing a black box to be drawn
• Disabled vulkan layer
  It was not working properly so we disabled it until fixed as to not cause confusion.

Contributors

@flightlessmango @jackun @gort818 @stephanlachnit @trigg @PMunkes

MangoHud Version 0.6.7-1

Hotfixes

• amdgpu: Prefer sysfs temp over gpu_metrics
• amdgpu: Fix incorrect gpu load for some GPUs
• amdgpu: If gpu_metrics is from v1_0, ignore it and use sysfs instead
• Fixed on screen benchmark not matching summary file
• Fixed zink detection
• disabled throttling_status by default for nvidia as it causes lag on 3000 series

MangoHud Version 0.6.7

Changes

Show highest cpu freq instead of the cumulative average
Using sysfs scaling_cur_freq instead of /proc/cpuinfo for cpu core frequencies
Added EADesktop.exe and EALauncher.exe to blacklist
Logger writes a summary by default
Using gpu_metrics sysfs binary for amdgpu metrics
Showing min and max frametime for the period
Battery param shows a plug icon when plugged in
Improved amdgpu metrics accuracy by polling 100times per period

Bug fixes

Fixed splitgate crashing on amd gpu's
Fixed not reporting amd cpu power when using the zenpower module
Fixed regression in hardware info updater
Fixed bug where setting cpu cores to offline would crash mangohud/mangoapp

Parameters

• fps_only - Allows you to only display FPS (requires legacy_layout=0)
• gamepad_battery - Shows battery and connection status for supported gamepads
• gamepad_battery_icon - Replaces the percent amount with a battery icon
• frame_count - Shows the number of frames since start
• throttling_status - Shows if GPU is throttling based on Power, current, temp or "other" (Only shows if throttling is currently happening)

MangoHud Version 0.6.6-1

fix mangoapp building without xnvctrl

MangoHud Version 0.6.6

Changes and Improvements

• Fixed logging crashing in some games (cyberpunk etc)
• Limit keybind check to about 10hz (improves perf in high fps scenarios, like vkcube)
• Added spdlog
• Changed media_player_order to media_player_format={title};{artist};{album}. Semi-colon adds a new line.

Mangoapp

This an application that is designed to be run together with gamescope and rendered on top of gamescope

MangoHud Version 0.6.5

Changes and Improvements

• Fixed more issues where incorrect engine name would be shown
• ToGL detection
• middle-left and middle-right are now options in the position param
• Fixed issue where vulkan driver version would be incorrect