DEV.co
Open-Source Observability · flightlessmango

MangoHud

MangoHud is a free, open-source overlay for Linux that displays real-time performance metrics (FPS, GPU/CPU load, temperatures) on top of Vulkan and OpenGL applications. It's actively maintained, widely packaged across major distributions, and used primarily by gamers and performance engineers for in-game monitoring.

Source: GitHub — github.com/flightlessmango/MangoHud
8.8k
GitHub stars
408
Forks
C
Primary language
MIT
License (OSI-approved)

Key facts

Objective fields from the source. Values we can't verify are shown as “Unknown” rather than guessed.

FieldValue
Repositoryflightlessmango/MangoHud
Ownerflightlessmango
Primary languageC
LicenseMIT — OSI-approved
Stars8.8k
Forks408
Open issues306
Latest releasev0.8.4 (2026-05-27)
Last updated2026-07-04
Sourcehttps://github.com/flightlessmango/MangoHud

What MangoHud is

A C-based Vulkan/OpenGL layer that injects performance telemetry via environment variable configuration (MANGOHUD_CONFIG, MANGOHUD_CONFIGFILE). Supports NVIDIA (via NVML/XNVCtrl), AMD, and Intel GPUs; configurable via YAML presets; includes logging, visualization tools (mangoplot), and optional D-Bus/media integration.

Quickstart

Get the MangoHud source

Clone the repository and explore it locally.

terminalbash
git clone https://github.com/flightlessmango/MangoHud.gitcd MangoHud# follow the project's README for install & configuration

Need it deployed, integrated, or customized instead? DEV.co ships production installs.

Best use cases

Gaming Performance Monitoring

Real-time in-game FPS, frame-time, and GPU/CPU metrics for Linux gamers tuning game settings or validating driver performance.

Graphics Driver Development & QA

Low-overhead overlay for capturing live thermal and load metrics during driver testing, regression detection, and performance profiling.

Performance Benchmarking & Logging

Automated FPS/frame-time capture to CSV for batch performance analysis, with built-in visualization via mangoplot for trend analysis.

Implementation considerations

  • Requires compilation with meson/ninja and ~20+ development dependencies (libvulkan, libGL, libdrm, yaml-cpp, etc.); build.sh automates for major distros but may fail on non-standard or minimal systems.
  • Configuration via environment variables (MANGOHUD=1, MANGOHUD_CONFIG) or YAML presets; users must understand LD_PRELOAD or Vulkan layer injection mechanics for reliable activation.
  • GPU metrics availability varies by vendor/driver: NVIDIA requires NVML (Wayland) or XNVCtrl (X11/older hardware); AMD/Intel support less mature. Intel Arc/Xe may require recent kernel/driver versions.
  • 32-bit application support (lib32-mangohud) requires separate compilation and multilib setup; not all distros provide packaged 32-bit binaries.
  • Flatpak deployment requires per-app override (flatpak override --user --env=MANGOHUD=1 <appid>) due to sandbox constraints.

When to avoid it — and what to weigh

  • Windows/macOS Requirement — MangoHud is Linux-only. No native Windows or macOS support; porting would require significant reengineering.
  • Non-Vulkan/OpenGL APIs — Does not support DirectX, Metal, or proprietary rendering backends; limited to POSIX/Linux graphics stacks.
  • Production Metrics in Headless/Server Context — Designed for interactive overlay use; not suitable as a headless monitoring agent for containerized/cloud GPU workloads.
  • NVIDIA Wayland Stability Priority — NVIDIA Wayland support requires NVML (libcuda) and is less mature than X11; may face compatibility issues on cutting-edge Wayland sessions.

License & commercial use

MIT License. Permissive OSI-approved license allowing unrestricted use, modification, and distribution for any purpose (commercial or non-commercial) with only attribution requirement.

MIT License permits commercial use without restriction. Can be bundled, modified, and shipped in proprietary products provided MIT notice is retained. No patent grant or liability limits beyond license text; standard commercial practice applies (review for indemnity/SLA needs).

DEV.co evaluation signals

Editorial assessment — not user reviews. Directional, with an explicit confidence level.

SignalAssessment
MaintenanceActive
DocumentationAdequate
License clarityClear
Deployment complexityModerate
DEV.co fitGood
Assessment confidenceHigh
Security considerations

Uses LD_PRELOAD and Vulkan layer injection to hook graphics APIs; inherits privileges of host process. No code audit data provided. Typical risks: LD_PRELOAD interception surface, libvulkan/libGL dependency supply chain, libcap usage for potential privilege escalation (not detailed in docs). Sandboxed well under Flatpak. Recommend vendor/distro security advisories for critical updates.

Alternatives to consider

OBS with game capture

General-purpose live performance visualization; heavier overhead, requires separate window management, but cross-platform and mature.

GPU Vendor Tools (NVIDIA-SMI, AMD-Tools, Intel-GPU-Tools)

Native, vendor-supported GPU monitoring; less game-focused, no in-game overlay, better for headless/server; requires distro-specific setup.

Gfxbench / GFXBench / FrameView

Dedicated graphics benchmarking tools; more structured metrics, cross-platform, but not real-time in-game overlay and proprietary licensing.

Software development agency

Build on MangoHud with DEV.co software developers

MangoHud is production-ready for Linux graphics workloads. Evaluate against OBS and vendor tools for your monitoring strategy.

Talk to DEV.co

Related open-source tools

Surfaced by semantic similarity across the DEV.co open-source index.

Related on DEV.co

Explore the category and the services that help you build with it.

MangoHud FAQ

Does MangoHud work on Windows or macOS?
No. It is Linux-only, using Vulkan layers and LD_PRELOAD which are not available on Windows/macOS. No porting plans are documented.
Will MangoHud work with my NVIDIA GPU on Wayland?
Yes, if NVIDIA NVML (libcuda) is installed and driver ≥495. On older NVIDIA hardware or X11, use XNVCtrl instead. Wayland support is less mature than X11; issues are possible.
How do I enable MangoHud for Steam games?
Add `mangohud %command%` to the game's launch options in Steam Properties, or set `MANGOHUD=1` in your shell for all Vulkan games.
Can I log FPS data for analysis?
Yes. MangoHud logs to CSV (via MANGOHUD_CONFIG). Use the built-in `mangoplot` tool or upload to FlightlessMango.com for visualization.

Software developers & web developers for hire

DEV.co helps companies turn open-source tools like MangoHud into production software. Our software development services cover the full lifecycle — architecture, web development, integration, and maintenance — delivered by software developers and web developers who ship. Engage our software development agency to implement or customize it for your open-source observability stack.

Ready to integrate real-time performance monitoring?

MangoHud is production-ready for Linux graphics workloads. Evaluate against OBS and vendor tools for your monitoring strategy.