---

Goverlay helps Linux gamers get the most out of their system by offering an easy graphical interface to configure MangoHud, vkBasalt, and OptiScaler. Whether you want 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.

---

Table of Contents

• Screenshots
• Prerequisites
• Installation
  • Distributions
    • Arch / Manjaro / Other Arch-based distributions
    • Fedora
    • Solus
    • Ubuntu
    • OpenSUSE
  • Tarball
  • Building from Source
    • Prerequisites
    • Building
    • Running
• Credits
• Donations

---

Screenshots

---

Prerequisites

Dependencies required to run Goverlay:

• mangohud — Configure MangoHud
• mesa-demos — OpenGL demo tools
• vulkan-tools — Vulkan demo tools
• vkBasalt — Configure vkBasalt
• git — Used to clone repositories (e.g., ReShade)
• qt6pas — Qt6 bindings for Free Pascal / Lazarus
• zenergy — Displays AMD CPU power metrics
• pascube — A simple OpenGL spinning cube used for configuration previews

---

Installation

Distributions

Universal Method — AppImage

Download the AppImage from the Releases page and make it executable:

chmod +x Goverlay_1_3.AppImage
./Goverlay_1_3.AppImage

Arch / Manjaro / Other Arch-based Distributions

Option 1 – Official Repository

sudo pacman -S goverlay

Option 2 – Arch User Repository (AUR)

yay -S goverlay

Fedora

sudo dnf install goverlay

OpenSUSE

Tumbleweed

sudo zypper install goverlay

Leap 15.2

Add the games:tools repository and install:

sudo zypper addrepo https://download.opensuse.org/repositories/games:tools/openSUSE_Leap_15.2/games:tools.repo
sudo zypper refresh
sudo zypper install goverlay

Solus

sudo eopkg it goverlay

Debian (Sid)

sudo apt install goverlay

Ubuntu (20.04 and newer)

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

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

1. Download the latest tarball from the Releases page.
2. Extract it:

   tar -xvf Goverlay*.tar.xz

3. 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.

• https://flightlessmango.com
• https://github.com/flightlessmango/MangoHud
• https://discord.com/invite/Gj5YmBb"

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

DLSS-Enabler (Artur Graniszewski)

Tooling that expands compatibility layers for DLSS and NVAPI-based features.

https://github.com/artur-graniszewski/DLSS-Enabler

Lazarus IDE

This project was built using the Lazarus IDE.

---

Donations

If this project has been useful to you, consider supporting its development ❤️