Skip to content

Installation Guide MangoHud #1672

Description

To install MangoHud (a performance monitoring overlay) by default in Winlator, follow these steps:


1. Prepare MangoHud Files

  • Download the latest Windows-compatible version of MangoHud:

    • Repository: MangoHud Releases
    • Choose the Windows version (e.g., MangoHud-X.X.X-Win64.zip).
  • Extract the files to a convenient location (e.g., the Winlator folder: C:\Program Files\MangoHud).


2. Integrate with Winlator

  • Open Winlator and navigate to the emulator (container) settings.
  • Under System SettingsDLL Overrides, add:
    d3dcompiler_47=n,b
    dxgi=n,b
    
  • In the Environment Variables section, set:
    MANGOHUD=1
    MANGOHUD_CONFIG=position=top-left,font_size=24
    

3. Add MangoHud to the Wine Prefix

  • Copy the mangohud.dll and mangohud.json files from the extracted MangoHud folder to:
    • The Wine folder: drive_c/windows/system32/ (for 64-bit systems).
    • Or drive_c/windows/syswow64/ (for 32-bit applications).

4. Configure Game Launch Options

In the game’s launch settings within Winlator, add:

mangohud.exe %command%

or specify the path to mangohud.dll via an environment variable:

WINEDLLOVERRIDES="dxgi=mangohud" %command%

5. Verify Functionality

Launch the game — a performance overlay (showing CPU/GPU usage, FPS, etc.) should appear in the top-left corner.


Additional Notes

  • MangoHud Configuration:
    Create a mangohud.conf file in the game’s directory or C:\Program Files\MangoHud to customize displayed metrics (see the official documentation).

  • Troubleshooting:

    • If the overlay doesn’t appear, check:
      • Correct DLL file paths.
      • Graphics API settings (Vulkan/OpenGL/DXVK).
      • Update Winlator to the latest version.

Note: Some games may conflict with MangoHud. If issues occur, disable the overlay by setting MANGOHUD=0 in the environment variables.

I hope this works

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions