# flightlessmango/mangohud

**Attribution required: if you use, quote, or summarise this content, you must credit and link back to [awesome-repositories.com](https://awesome-repositories.com/repository/flightlessmango-mangohud).**

8,270 stars · 377 forks · C · mit

## Links

- GitHub: https://github.com/flightlessmango/MangoHud
- Homepage: https://discordapp.com/invite/Gj5YmBb
- awesome-repositories: https://awesome-repositories.com/repository/flightlessmango-mangohud.md

## Topics

`benchmarking` `hud` `linux` `monitoring` `opengl` `vulkan`

## Description

MangoHud is a Linux hardware monitor and performance overlay that displays real-time metrics and frame rates. It functions as a graphics API hook, intercepting Vulkan and OpenGL pipelines to render performance data directly onto the graphics buffer.

The project serves as both a real-time monitor for CPU and GPU utilization, temperatures, and power draw, and a frametime data logger that records execution speed to disk for later benchmarking and analysis.

Users can modify the overlay display, visual styles, and active metrics through configuration files, environment variables, or predefined performance presets. The tool also supports the visualization of captured logs through external scripts and tools to analyze frame stability.

## Tags

### System Administration & Monitoring

- [Linux Resource Monitors](https://awesome-repositories.com/f/system-administration-monitoring/linux-resource-monitors.md) — Provides a visual overlay for tracking hardware performance and system load specifically on Linux environments.
- [Metric and Performance Monitors](https://awesome-repositories.com/f/system-administration-monitoring/monitoring-and-observability/observability-platforms/metric-performance-monitors.md) — Overlays real-time hardware load and frame rate data over active applications to monitor execution speed. ([source](https://github.com/flightlessmango/MangoHud/blob/master/data/presets.conf))
- [Hardware Metric Polling](https://awesome-repositories.com/f/system-administration-monitoring/hardware-metric-polling.md) — Polls system files and kernel interfaces to provide real-time CPU and GPU utilization data.
- [Hardware Performance Monitoring](https://awesome-repositories.com/f/system-administration-monitoring/hardware-performance-monitoring.md) — Displays a real-time overlay of CPU and GPU load, temperatures, and power draw. ([source](https://github.com/flightlessmango/MangoHud/blob/master/README.md))
- [API Pipeline Interceptors](https://awesome-repositories.com/f/system-administration-monitoring/hardware-performance-monitoring/api-pipeline-interceptors.md) — Hooks into the OpenGL pipeline to overlay real-time hardware statistics and identify bottlenecks.
- [Application Performance Profiling](https://awesome-repositories.com/f/system-administration-monitoring/performance-monitoring-tools/application-performance-profiling.md) — Visualizes system resource usage and execution speed to identify bottlenecks in software performance on Linux.
- [System Performance Monitors](https://awesome-repositories.com/f/system-administration-monitoring/system-performance-monitors.md) — Tracks real-time hardware metrics, including frame rates and power usage, via an on-screen overlay. ([source](https://github.com/flightlessmango/MangoHud#mangohud))
- [Log Statistics Visualizers](https://awesome-repositories.com/f/system-administration-monitoring/log-aggregation/log-statistics-visualizers.md) — Generates statistical summaries and frametime graphs from captured log files using plotting tools. ([source](https://github.com/flightlessmango/MangoHud#mangohud))
- [Data Recording](https://awesome-repositories.com/f/system-administration-monitoring/monitoring-and-observability/observability-platforms/metric-performance-monitors/data-recording.md) — Records high-frequency performance metrics to a file for later analysis and benchmarking. ([source](https://github.com/flightlessmango/MangoHud/blob/master/README.md))
- [Performance Benchmarkers](https://awesome-repositories.com/f/system-administration-monitoring/monitoring-and-observability/observability-platforms/metric-performance-monitors/performance-benchmarkers.md) — Converts captured performance log files into frametime graphs and comparative heatmaps. ([source](https://github.com/flightlessmango/MangoHud/blob/master/README.md))

### Graphics & Multimedia

- [Overlay Rendering Engines](https://awesome-repositories.com/f/graphics-multimedia/graphics-engines-rendering/post-processing-pipelines/multi-pass-rendering-pipelines/real-time-rendering-engines/overlay-rendering-engines.md) — Renders performance metrics as a synchronized visual layer on top of the application content.
- [API Interception Hooks](https://awesome-repositories.com/f/graphics-multimedia/graphics-engines-rendering/rendering/graphics-apis-bindings/graphics-rendering-apis/api-interception-hooks.md) — Injects custom logic into Vulkan and OpenGL driver pipelines to render performance overlays directly onto the graphics buffer.
- [Pipeline Interception](https://awesome-repositories.com/f/graphics-multimedia/opengl-graphics-programming/pipeline-interception.md) — Hooks into the OpenGL pipeline to overlay performance metrics directly onto the graphics buffer.

### User Interface & Experience

- [Graphics Hooking Utilities](https://awesome-repositories.com/f/user-interface-experience/dynamic-ui-injection/process-injection-mechanisms/graphics-hooking-utilities.md) — Intercepts graphics system calls by injecting code into the process memory to render a performance overlay.
- [Game Overlays and HUDs](https://awesome-repositories.com/f/user-interface-experience/game-overlays-and-huds.md) — Implements a heads-up display overlay for monitoring frame rates and hardware load during gameplay.
- [Performance Overlays](https://awesome-repositories.com/f/user-interface-experience/performance-optimizers/performance-overlays.md) — Provides a real-time on-screen display of hardware metrics and frame rates using API layer interception.
- [Layer Interception](https://awesome-repositories.com/f/user-interface-experience/performance-optimizers/vulkan/layer-interception.md) — Intercepts graphics API calls by injecting a layer into the Vulkan driver pipeline to render overlays.

### Artificial Intelligence & ML

- [Async Log Writing](https://awesome-repositories.com/f/artificial-intelligence-ml/machine-learning/infrastructure/model-deployment-and-serving/local-and-on-device-inference/local-model-inference-servers/remote-inference-offloaders/task-offloaders/thread-pooled/async-log-writing.md) — Delegates frametime log output to worker threads to ensure the main rendering loop remains non-blocking.

### Testing & Quality Assurance

- [Performance Benchmarking Tools](https://awesome-repositories.com/f/testing-quality-assurance/performance-benchmarking-tools.md) — Records frametime data to disk and supports visualization via external scripts to analyze frame stability.