https://github.com/benjamimgois/goverlay
Goverlay is an easy graphical interface to configure MangoHud, vkBasalt, and OptiScaler
https://github.com/benjamimgois/goverlay
Last synced: 3 days ago
JSON representation
Goverlay is an easy graphical interface to configure MangoHud, vkBasalt, and OptiScaler
- Host: GitHub
- URL: https://github.com/benjamimgois/goverlay
- Owner: benjamimgois
- License: gpl-3.0
- Created: 2022-04-26T14:20:58.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2026-01-28T02:50:02.000Z (13 days ago)
- Last Synced: 2026-01-28T16:36:47.709Z (12 days ago)
- Language: Pascal
- Homepage:
- Size: 222 MB
- Stars: 1,101
- Watchers: 11
- Forks: 51
- Open Issues: 71
-
Metadata Files:
- Readme: README.md
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
Awesome Lists containing this project
- fucking-Awesome-Linux-Software -  (Utilities / Overlays)
- Awesome-Linux-Software - 
---
**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](#screenshots)
- [Prerequisites](#prerequisites)
- [Installation](#installation)
- [Universal Methods](#universal-methods)
- [Flatpak](#flatpak)
- [AppImage](#appimage)
- [Distributions](#distributions)
- [Arch and derivatives](#arch-and-derivatives)
- [OpenSUSE](#opensuse)
- [Solus](#solus)
- [Fedora / Debian / Ubuntu](#fedora--debian--ubuntu)
- [Tarball](#tarball)
- [Building from Source](#building-from-source)
- [Credits](#credits)
- [Donations](#donations)
---
## Screenshots
Click to view screenshots
---
## Prerequisites
### Required
- [**`mangohud`**](https://github.com/flightlessmango/MangoHud) — Performance overlay / monitoring
- [**`vkBasalt`**](https://github.com/DadSchoorse/vkBasalt) — Vulkan post-processing effects
- [**`mesa-demos`**](https://gitlab.freedesktop.org/mesa/demos) — OpenGL demo tools
- [**`vulkan-tools`**](https://github.com/LunarG/VulkanTools) — Vulkan demo tools
- [**`git`**](https://github.com/git/git) — Used to clone repositories (e.g., ReShade)
- [**`qt6pas`**](https://gitlab.com/freepascal.org/lazarus/lazarus/-/tree/main/lcl/interfaces/qt6/cbindings) — Qt6 bindings for Free Pascal / Lazarus
### Optional / Used by specific features
- [**`zenergy`**](https://github.com/BoukeHaarsma23/zenergy) — Displays AMD CPU power metrics
- [**`pascube`**](https://github.com/benjamimgois/pascube) — Simple OpenGL spinning cube used for configuration previews
---
## Installation
## Universal Methods
### Flatpak
You can download it from [**`Flathub`**](https://flathub.org/en/apps/io.github.benjamimgois.goverlay)
```bash
#Add Flathub repositorie
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:
```bash
chmod +x Goverlay_1_3.AppImage
./Goverlay_1_3.AppImage
```
## Distributions
### Arch and derivatives
**Option 1 – Official Repository**
```bash
sudo pacman -S goverlay
```
**Option 2 – AUR**
```
yay -S goverlay-git
```
### OpenSUSE
```bash
sudo zypper install goverlay
```
### Solus
```bash
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](#flatpak) or [AppImage](#appimage) instead.
---
#### Libqt6pas
The `libqt6pas` package is not available in some distributions official repositories.
You can get it from [David Bannon’s repository](https://github.com/davidbannon/libqt6pas/releases):
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](https://github.com/benjamimgois/Goverlay/releases).
2. Extract it:
```bash
tar -xvf Goverlay*.tar.xz
```
3. Run the binary:
```bash
./Goverlay
```
> **Note:** Since version 0.6.4, MangoHud must be installed to run Goverlay.
## Building from Source
### Prerequisites
- [Lazarus IDE](https://gitlab.com/freepascal.org/lazarus/lazarus)
### Building
```bash
git clone https://github.com/benjamimgois/Goverlay.git
cd Goverlay
make
```
### Running
```bash
./Goverlay
```
### Installing
```bash
sudo make install
```
This installs the startup script to `/usr/local/bin/Goverlay`, allowing you to launch it directly via:
```bash
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](https://www.lazarus-ide.org/).
---
## Donations
If this project has been useful to you, consider supporting its development ❤️
[](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick&hosted_button_id=Q5EYYEJ5NSJAU&source=url)