Skip to content

Randy420Marsh/goverlay

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

680 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Goverlay logo

Latest release AUR version License AppImage available


Goverlay is an open-source project that provides a graphical user interface (GUI) to manage Vulkan and OpenGL overlays.
It’s still under active development, so some features may be missing or incomplete.

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

image image image.png image.png image


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

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.

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 opensource project that aims to create a Graphical UI to help manage Linux overlays.

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors

Languages

  • Pascal 97.4%
  • Shell 1.4%
  • Other 1.2%