Where Is the MangoHud Config File?
MangoHud reads its overlay layout from one MangoHud.conf in the standard config directory.
Last updated
MangoHud keeps its entire overlay definition in a single config file. Metrics, colors, position, and hotkeys all read from MangoHud.conf at game launch, with presets commented inside the default file.
Per game customization layers through environment variables and application profiles rather than extra files. The config path follows XDG convention, so dotfiles repos absorb it naturally. Missing file means sensible defaults, never an error.
Where MangoHud stores this, by platform
~/.config/MangoHud/MangoHud.conf
Overlay layout, metrics, and hotkeys live here. Per game tweaks layer through env vars and app profiles without touching this file.
Frequently asked questions
How do I share my overlay setup?
Copy MangoHud.conf to the new machine's config path. Presets travel as plain text, so diffs show exactly what changed. Per game overrides live in application profiles beside the main file.
Can I tweak per game without editing?
Launch options like MANGOHUD=1 plus MANGOHUD_CONFIG for inline tweaks override the file per game. Steam launch options are the usual vehicle. The file remains the base that overrides modify.
Notice an outdated path? Let us know.