Changes

• time now has a label (you can remove this label with no_time_label)
• Wayland keybinds have been added
• rewritten exec function to have a persistent shell. Should reduce frametime spikes when using exec
• exec is now right aligned to conform with every other item
• meson options with_x11 and with_wayland actually have a purpose now
• added Pop!_OS and SteamOS to build script
• added a mutex for config to prevent some crashes when accessing config at the same time as reloading
• winesync and refresh_rate have been changed to small font

Fixes

• frametime color wasn't being correctly inherited, the user was not able to change it's color
• fixed a crash when pressing Shift_R + F9
• config options now correctly override preset options
• fixed RPM and % being incorrectly assigned for GPU fan speeds
• graphs had incorrect padding at start of graphs
• fixed a crash when reloading the config while logging
• check that cpu input gives a non-zero value
• fixed minecraft-launcher crashing
• graphs had incorrect padding leading to a smaller graph
• fixed a build issue where some meson options would exclude opengl files incorrectly

Parameters

• no_time_label removes the label before time
• network shows the throughput in kb/s for all interfaces or a specified list of interfaces e.g network=eth0,wlo1

Changes

• time now has a label (you can remove this label with no_time_label)
• Wayland keybinds have been added
• rewritten exec function to have a persistent shell. Should reduce frametime spikes when using exec

Fixes

• frametime color wasn't being correctly inherited, the user was not able to change it's color
• fixed a crash when pressing Shift_R + F9
• config options now correctly override preset options
• fixed RPM and % being incorrectly assigned for GPU fan speeds
• graphs had incorrect padding at start of graphs

Parameters

• no_time_label removes the label before time
• network shows the throughput in kb/s for all interfaces or a specified list of interfaces e.g network=eth0,wlo1

Changes

• time now has a label (you can remove this label with no_time_label)
• Wayland keybinds have been added

Fixes

• frametime color wasn't being correctly inherited, the user was not able to change it's color
• fixed a crash when pressing Shift_R + F9
• config options now correctly override preset options
• fixed RPM and % being incorrectly assigned for GPU fan speeds

Parameters

• no_time_label removes the label before time
• network shows the throughput in kb/s for all interfaces or a specified list of interfaces e.g network=eth0,wlo1

Parameters

• gamepad_battery has been reworked to device_battery. This parameter current supports the values gamepad and mouse
• time now has a title
• fps_metrics takes a decimal value or "avg". e.g avg,0.001 and displays the metrics
• winesync shows the current implementation of synchronization primitives. E.g ESYNC/FSYNC etc
• present_mode shows the current vulkan present mode or vsync status in opengl

Changes

• added support for gpu load on Adreno GPUs
• added cpu temp for zenpower3 module
• meson option: mangoplot

Fixes

• xnvctrl: fix an issue that could cause crashing when accessing gpu fan speed
• fixed an issue where no config present wouldn't use default mangohud presets
• fixed a crashing issue with CS2
• reworked intel code. Should resolve some issues where mangohud didn't shutting down properly when using intel gpu
• fix opengl runtime on musl libc systems #1133
• fixed text_outline_color incorrectly using BGR instead of RGB

• gamepad_battery has been reworked to device_battery. This parameter current supports the values gamepad and mouse
• xnvctrl: fix an issue that could cause crashing when accessing gpu fan speed
• fixed an issue where no config present wouldn't use default mangohud presets
• Fixed a crashing issue with CS2
• Reworked intel code. Should resolve some issues where mangohud didn't shutting down properly when using intel gpu
• time now has a title
• added cpu temp for zenpower3 module
• fixed text_outline_color incorrectly using BGR instead of RGB
• fps_metrics is a new parameter that takes a decimal value or "avg". e.g avg,0.001
• Added support for gpu load on Adreno GPUs
• winesync shows the current implementation of synchronization primitives. E.g ESYNC/FSYNC etc
• Fix opengl runtime on musl libc systems #1133

• gamepad_battery has been reworked to device_battery. This parameter current supports the values gamepad and mouse
• xnvctrl: fix an issue that could cause crashing when accessing gpu fan speed
• fixed an issue where no config present wouldn't use default mangohud presets
• Fixed a crashing issue with CS2
• Reworked intel code. Should resolve some issues where mangohud didn't shutting down properly when using intel gpu
• time now has a title
• added cpu temp for zenpower3 module
• fixed text_outline_color incorrectly using BGR instead of RGB
• fps_metrics is a new parameter that takes a decimal value or "avg". e.g avg,0.001

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

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

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

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