GOverlay

Graphical UI for MangoHud configuration.

Package 1.3k stars GitHub

Goverlay helps Linux gamers get the most out of their systems by providing an easy-to-use graphical interface to configure MangoHud, vkBasalt, and OptiScaler.

Whether you’re looking for performance monitoring, visual enhancements, or smarter upscaling, Goverlay makes everything accessible in just a few clicks.

This project exists thanks to the amazing work of the original maintainers and contributors behind the core tools.
I’m just a network engineer who loves Linux and gaming — this is my way of giving something back to the community.

Screenshots
Prerequisites
Installation
Credits
Donations

Screenshots

Click to view screenshots

Prerequisites

Required

mangohud — Performance overlay / monitoring
vkBasalt — Vulkan post-processing effects
mesa-demos — OpenGL demo tools
vulkan-tools — Vulkan demo tools
git — Used to clone repositories (e.g., ReShade)
qt6pas — Qt6 bindings for Free Pascal / Lazarus

Optional / Used by specific features

zenergy — Displays AMD CPU power metrics
pascube — Simple OpenGL spinning cube used for configuration previews

Installation

Universal Methods

Flatpak

You can download it from Flathub

# Add Flathub repository
flatpak remote-add --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo

# Install Goverlay
flatpak install flathub io.github.benjamimgois.goverlay

# Install required runtimes for MangoHud and vkBasalt support
flatpak --user install flathub org.freedesktop.Platform.VulkanLayer.MangoHud//25.08 \
org.freedesktop.Platform.VulkanLayer.vkBasalt//25.08 -y

AppImage

Download the AppImage from the and make it executable:

chmod +x Goverlay_1_3.AppImage
./Goverlay_1_3.AppImage

Distributions

Arch and derivatives

Option 1 – Official Repository

sudo pacman -S goverlay

Option 2 – AUR

yay -S goverlay-git

OpenSUSE

sudo zypper install goverlay

Solus

sudo eopkg it goverlay

[!IMPORTANT] Fedora / Debian / Ubuntu users: Official repositories for these distros often ship outdated versions. It is strongly recommended to use the Flatpak or AppImage instead.

Libqt6pas

The libqt6pas package is not available in some distributions official repositories.
You can get it from David Bannon’s repository:

Ubuntu example:

sudo apt-get update
wget https://github.com/davidbannon/libqt6pas/releases/download/v6.2.8/libqt6pas6_6.2.8-1_amd64.deb
sudo dpkg -i libqt6pas6_6.2.8-1_amd64.deb
tar -zxvf Goverlay*.tar.gz
./Goverlay

Tarball

Download the latest tarball from the Releases page.
Extract it:
```
tar -xvf Goverlay*.tar.xz
```
Run the binary:
```
./Goverlay
```

Note: Since version 0.6.4, MangoHud must be installed to run Goverlay.

Building from Source

Prerequisites

Lazarus IDE

Building

git clone https://github.com/benjamimgois/Goverlay.git
cd Goverlay
make

Running

./Goverlay

Installing

sudo make install

This installs the startup script to /usr/local/bin/Goverlay, allowing you to launch it directly via:

Goverlay

Credits

FlightlessMango

Huge thanks to FlightlessMango, creator and maintainer of MangoHud — the foundation that made Goverlay possible.

DadSchoorse

Special thanks to DadSchoorse, creator of vkBasalt, which adds post-processing effects to Vulkan.

https://github.com/DadSchoorse/vkBasalt

OptiScaler Team & Contributors

Goverlay integrates several components from the OptiScaler ecosystem and community-driven projects that enable upscaling, frame generation and NVIDIA APIs on Linux.

OptiScaler

Core upscaling and frame-generation project for Linux.

https://github.com/optiscaler/OptiScaler

fakenvapi

User-space implementation of NVAPI used by OptiScaler and other tools.

https://github.com/optiscaler/fakenvapi

Decky-Framegen (xXJSONDeruloXx)

Pioneer project that inspired much of the OptiScaler installation logic.

https://github.com/xXJSONDeruloXx/Decky-Framegen

fgmod (FakeMichau)

Another important reference implementation for frame-generation utilities on Linux.

https://github.com/FakeMichau/fgmod