2020-02-12 09:56:29 +00:00
### MangoHud configuration file
### Uncomment any options you wish to enable. Default options are left uncommented
### Use some_parameter=0 to disable a parameter (only works with on/off parameters)
### Everything below can be used / overridden with the environment variable MANGOHUD_CONFIG instead
################ PERFORMANCE #################
2021-06-13 01:37:56 +00:00
### Limit the application FPS. Comma-separated list of one or more FPS values (e.g. 0,30,60). 0 means unlimited (unless VSynced)
2020-02-12 09:56:29 +00:00
# fps_limit=
2023-03-16 01:57:10 +00:00
### early = wait before present, late = wait after present
# fps_limit_method=
2020-11-29 17:15:56 +00:00
### VSync [0-3] 0 = adaptive; 1 = off; 2 = mailbox; 3 = on
2020-02-12 09:56:29 +00:00
# vsync=
2020-11-29 17:15:56 +00:00
### OpenGL VSync [0-N] 0 = off; >=1 = wait for N v-blanks, N > 1 acts as a FPS limiter (FPS = display refresh rate / N)
2020-03-13 08:38:53 +00:00
# gl_vsync=
2023-04-16 16:46:55 +00:00
### Mip-map LoD bias. Negative values will increase texture sharpness (and aliasing)
## Positive values will increase texture blurriness (-16 to 16)
# picmip=
### Anisotropic filtering level. Improves sharpness of textures viewed at an angle (0 to 16)
# af=
### Force bicubic filtering
# bicubic
### Force trilinear filtering
# trilinear
2023-04-16 17:21:16 +00:00
### Disable linear texture filtering. Makes textures look blocky
2023-04-16 16:46:55 +00:00
# retro
2020-02-12 09:56:29 +00:00
################### VISUAL ###################
2020-11-29 17:15:56 +00:00
### Legacy layout
2023-04-16 17:28:14 +00:00
# legacy_layout=0
2020-11-27 22:12:11 +00:00
2023-05-29 10:33:37 +00:00
### pre defined presets
# -1 = default
# 0 = no display
# 1 = fps only
2023-05-29 10:58:19 +00:00
# 2 = horizontal view
2023-05-29 10:33:37 +00:00
# 3 = extended
# 4 = high detailed information
# preset=-1
2021-06-13 01:37:56 +00:00
### Display custom centered text, useful for a header
# custom_text_center=
### Display the current system time
# time
### Time formatting examples
# 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)
### Display MangoHud version
# version
2020-02-12 09:56:29 +00:00
### Display the current GPU information
2022-09-29 07:33:11 +00:00
## Note: gpu_mem_clock and gpu_mem_temp also need "vram" to be enabled
2020-02-12 09:56:29 +00:00
gpu_stats
# gpu_temp
2022-09-29 07:33:11 +00:00
# gpu_junction_temp
2020-03-29 13:47:31 +00:00
# gpu_core_clock
2022-09-29 07:33:11 +00:00
# gpu_mem_temp
2020-03-29 13:47:31 +00:00
# gpu_mem_clock
2020-06-11 13:40:17 +00:00
# gpu_power
2021-06-13 01:37:56 +00:00
# gpu_text=GPU
2020-11-13 21:22:01 +00:00
# gpu_load_change
2021-06-13 01:37:56 +00:00
# gpu_load_value=60,90
# gpu_load_color=39F900,FDFD09,B22222
### Display the current CPU information
cpu_stats
# cpu_temp
# cpu_power
# cpu_text=CPU
# cpu_mhz
# cpu_load_change
# cpu_load_value=60,90
# cpu_load_color=39F900,FDFD09,B22222
### Display the current CPU load & frequency for each core
# core_load
# core_load_change
### Display IO read and write for the app (not system)
# io_read
# io_write
### Display system vram / ram / swap space usage
# vram
# ram
# swap
### Display per process memory usage
## Show resident memory and other types, if enabled
# procmem
# procmem_shared
# procmem_virt
### Display battery information
# battery
# battery_icon
2022-02-20 05:52:52 +00:00
# gamepad_battery
# gamepad_battery_icon
2020-03-29 13:47:31 +00:00
2020-11-16 23:37:03 +00:00
### Display FPS and frametime
fps
2021-06-13 01:37:56 +00:00
# fps_sampling_period=500
# fps_color_change
# fps_value=30,60
# fps_color=B22222,FDFD09,39F900
2020-11-16 23:37:03 +00:00
frametime
2022-05-04 04:14:46 +00:00
# frame_count
2020-03-29 13:47:31 +00:00
2023-04-16 16:46:55 +00:00
### Display GPU throttling status based on Power, current, temp or "other"
## Only shows if throttling is currently happening
throttling_status
2021-12-06 01:41:11 +00:00
### Display miscellaneous information
2021-06-13 01:37:56 +00:00
# engine_version
# gpu_name
# vulkan_driver
# wine
2023-04-16 16:46:55 +00:00
# exec_name
2021-06-13 01:37:56 +00:00
2020-03-29 13:47:31 +00:00
### Display loaded MangoHud architecture
# arch
2020-02-12 09:56:29 +00:00
### Display the frametime line graph
frame_timing
2021-06-13 01:37:56 +00:00
# histogram
2020-02-12 09:56:29 +00:00
2021-06-13 01:37:56 +00:00
### Display GameMode / vkBasalt running status
# gamemode
# vkbasalt
### Display current FPS limit
# show_fps_limit
2020-02-13 00:08:10 +00:00
2020-11-30 20:11:38 +00:00
### Display the current resolution
# resolution
2020-12-09 01:02:50 +00:00
### Display custom text
2021-06-13 01:37:56 +00:00
# custom_text=
### Display output of Bash command in next column
# exec=
2020-12-01 02:36:20 +00:00
2021-06-13 01:37:56 +00:00
### Display media player metadata
# media_player
# media_player_name=spotify
2021-09-09 17:52:52 +00:00
## Format metadata, lines are delimited by ; (wip)
# media_player_format={title};{artist};{album}
# media_player_format=Track:;{title};By:;{artist};From:;{album}
2020-03-02 09:46:46 +00:00
2021-06-13 01:37:56 +00:00
### Change the hud font size
# font_size=24
2020-06-29 14:15:50 +00:00
# font_scale=1.0
# font_size_text=24
2021-06-13 01:37:56 +00:00
# font_scale_media_player=0.55
2020-09-23 11:02:27 +00:00
# no_small_font
2020-02-12 09:56:29 +00:00
2021-06-13 01:37:56 +00:00
### Change default font (set location to TTF/OTF file)
2020-06-29 14:15:50 +00:00
## Set font for the whole hud
# font_file=
## Set font only for text like media player metadata
# font_file_text=
2021-06-13 01:37:56 +00:00
## Set font glyph ranges. Defaults to Latin-only. Don't forget to set font_file/font_file_text to font that supports these
## Probably don't enable all at once because of memory usage and hardware limits concerns
## If you experience crashes or text is just squares, reduce glyph range or reduce font size
# font_glyph_ranges=korean,chinese,chinese_simplified,japanese,cyrillic,thai,vietnamese,latin_ext_a,latin_ext_b
2020-02-12 09:56:29 +00:00
2023-05-27 06:30:07 +00:00
### Outline text
text_outline
# text_outline_color = 000000
# text_outline_thickness = 1.5
2021-06-13 01:37:56 +00:00
### Change the hud position
# position=top-left
2021-08-07 12:55:04 +00:00
2021-06-13 01:37:56 +00:00
### Change the corner roundness
# round_corners=
2020-07-18 19:18:27 +00:00
2023-04-16 16:46:55 +00:00
### Remove margins around MangoHud
# hud_no_margin
### Display compact version of MangoHud
# hud_compact
2023-04-16 17:57:09 +00:00
### Display MangoHud in a horizontal position
2023-04-16 16:46:55 +00:00
# horizontal
2021-02-03 01:33:03 +00:00
### Disable / hide the hud by default
2020-02-12 09:56:29 +00:00
# no_display
### Hud position offset
# offset_x=
# offset_y=
### Hud dimensions
# width=
# height=
2020-11-27 22:12:11 +00:00
# table_columns=
# cellpadding_y=
2020-02-12 09:56:29 +00:00
### Hud transparency / alpha
2021-06-13 01:37:56 +00:00
# background_alpha=0.5
2020-03-29 13:47:31 +00:00
# alpha=
2022-04-19 17:37:29 +00:00
### FCAT overlay
### This enables an FCAT overlay to perform frametime analysis on the final image stream.
### Enable the overlay
# fcat
### Set the width of the FCAT overlay.
### 24 is a performance optimization on AMD GPUs that should not have adverse effects on nVidia GPUs.
### A minimum of 20 pixels is recommended by nVidia.
# fcat_overlay_width=24
### Set the screen edge, this can be useful for special displays that don't update from top edge to bottom. This goes from 0 (left side) to 3 (top edge), counter-clockwise.
# fcat_screen_edge=0
2020-03-29 13:47:31 +00:00
### Color customization
# 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
2020-05-11 19:01:40 +00:00
# media_player_color=FFFFFF
2021-06-13 01:37:56 +00:00
# wine_color=EB5B5B
# battery_color=FF9078
2020-04-04 21:14:58 +00:00
2021-06-13 01:37:56 +00:00
### Specify GPU with PCI bus ID for AMDGPU and NVML stats
2020-05-02 14:40:05 +00:00
### Set to 'domain:bus:slot.function'
2021-06-13 01:37:56 +00:00
# pci_dev=0:0a:0.0
2020-05-02 14:40:05 +00:00
2020-11-15 05:58:01 +00:00
### Blacklist
2021-06-13 01:37:56 +00:00
# blacklist=
2020-11-15 05:58:01 +00:00
2022-04-07 08:28:48 +00:00
### Control over socket
### Enable and set socket name, '%p' is replaced with process id
# control = mangohud
# control = mangohud-%p
2021-06-13 01:37:56 +00:00
################ WORKAROUNDS #################
### Options starting with "gl_*" are for OpenGL
### Specify what to use for getting display size. Options are "viewport", "scissorbox" or disabled. Defaults to using glXQueryDrawable
# gl_size_query=viewport
2021-03-30 01:56:38 +00:00
2021-06-13 01:37:56 +00:00
### (Re)bind given framebuffer before MangoHud gets drawn. Helps with Crusader Kings III
# gl_bind_framebuffer=0
2021-03-30 01:56:38 +00:00
2021-06-13 01:37:56 +00:00
### Don't swap origin if using GL_UPPER_LEFT. Helps with Ryujinx
# gl_dont_flip=1
2021-03-30 01:56:38 +00:00
2021-06-13 01:37:56 +00:00
################ INTERACTION #################
2020-02-12 09:56:29 +00:00
### Change toggle keybinds for the hud & logging
2020-11-29 17:15:56 +00:00
# toggle_hud=Shift_R+F12
2023-04-16 16:46:55 +00:00
# toggle_hud_position=Shift_R+F11
2020-11-29 17:15:56 +00:00
# toggle_fps_limit=Shift_L+F1
# toggle_logging=Shift_L+F2
# reload_cfg=Shift_L+F4
# upload_log=Shift_L+F3
2020-03-29 13:47:31 +00:00
2021-06-13 01:37:56 +00:00
#################### LOG #####################
2020-11-27 13:17:43 +00:00
### Automatically start the log after X seconds
2021-06-13 01:37:56 +00:00
# autostart_log=1
2020-11-29 17:15:56 +00:00
### Set amount of time in seconds that the logging will run for
2021-06-13 01:37:56 +00:00
# log_duration=
### Change the default log interval, 100 is default
# log_interval=100
2020-11-29 17:15:56 +00:00
### Set location of the output files (required for logging)
2021-06-13 01:37:56 +00:00
# output_folder=/home/<USERNAME>/mangologs
2020-11-29 17:15:56 +00:00
### Permit uploading logs directly to FlightlessMango.com
2020-06-18 22:42:25 +00:00
# permit_upload=1
2021-06-13 01:37:56 +00:00
### Define a '+'-separated list of percentiles shown in the benchmark results
2020-06-18 22:42:25 +00:00
### Use "AVG" to get a mean average. Default percentiles are 97+AVG+1+0.1
2023-04-16 17:21:16 +00:00
# benchmark_percentiles=97,AVG,1,0.1