Skip to content

benjamimgois/goverlay

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

image

Latest release Flatpak beta AUR version AppImage available License


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.


Table of Contents


Screenshots

Click to view screenshots Screenshot 1 Screenshot 2 Screenshot 3 Screenshot 4 Screenshot 5 Screenshot 6 Screenshot 7

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 (Beta)

Since the flatpak file isn't in flathub yet, you can Download the file from the Releases page and install it.

flatpak install goverlay_1.6.4_stable.flatpak   

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

Fedora / Debian / Ubuntu

These distributions currently ship very old versions of Goverlay in their repositories, so it is strongly recommended to use one of the universal installation methods instead.


Libqt6pas

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

Ubuntu example:

bash
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

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.

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.

Laz-banner


Donations

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

Buy Me a Coffee at ko-fi.com

paypal

About

Goverlay is an easy graphical interface to configure MangoHud, vkBasalt, and OptiScaler

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages