benchmarking hud linux monitoring opengl vulkan

You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

Go to file

flightlessmango 04de13987e Added LICENSE		4 years ago
assets	update overlay example	4 years ago
bin	install.sh: verbose	4 years ago
include	Basic nvml implementation	4 years ago
modules	Add Vulkan-Headers submodule	4 years ago
src	Check if engine name is set	4 years ago
.gitignore	add PKGBUILD	4 years ago
.gitmodules	Add Vulkan-Headers submodule	4 years ago
LICENSE	Added LICENSE	4 years ago
PKGBUILD	PKGBUILD moved submodule fetching into prepare()	4 years ago
README.md	Update README.md	4 years ago
build.sh	build.sh: fix VERSION with tags	4 years ago
meson.build	meson: option to add _GLIBCXX_ASSERTIONS define	4 years ago
meson_options.txt	meson: option to add _GLIBCXX_ASSERTIONS define	4 years ago

README.md

MangoHud

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

Example:

Installation

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

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

Then simply run the following command:

./build.sh install

This will build and copy libMangoHud.so & libMangoHud32.so to $HOME/.local/share/MangoHud, as well as copying the required Vulkan layer configuration files.

If you are running an Ubuntu-like distrobution, Fedora, or Arch, the build script will automatically detect and prompt you to install missing build dependencies. If you run in to any issues with this please report them!

Normal usage

To enable the MangoHud Vulkan overlay layer, run :

MANGOHUD=1 /path/to/my_vulkan_app

Or alternatively, add MANGOHUD=1 to your shell profile.

MANGOHUD_CONFIG parameters

You can customize the hud by using the MANGOHUD_CONFIG environment variable while separating different options with a comma. Add some_parameter=0 to hide said parameter.

cpu_temp : Displays current CPU temperature
gpu_temp : Displays current GPU temperature
core_load : Displays current CPU load per core
font_size : Changes the default font size (default is 24)
width : Set custom hud width
height : Set custom hud height
position=x: Available values for x include top-left, top-right, bottom-left, and bottom-right
frame_timing : Displays frame time line plot

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

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

Environment Variables

MANGOHUD_OUTPUT : Define name and location of the output file (Required for logging)
MANGOHUD_FONT: Change default font (set location to .TTF/.OTF file )

Keybindings

F2 : Toggle Logging
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.