{"id":13560820,"url":"https://github.com/benjamimgois/goverlay","last_synced_at":"2026-07-01T05:01:07.162Z","repository":{"id":38355502,"uuid":"485818631","full_name":"benjamimgois/goverlay","owner":"benjamimgois","description":"Goverlay is an easy graphical interface to configure linux gaming applications","archived":false,"fork":false,"pushed_at":"2026-06-25T03:08:03.000Z","size":510211,"stargazers_count":1351,"open_issues_count":79,"forks_count":61,"subscribers_count":11,"default_branch":"main","last_synced_at":"2026-06-25T04:11:00.325Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"","language":"Pascal","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":"akien-mga/goverlay","license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/benjamimgois.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":"CONTRIBUTING.md","funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null},"funding":{"custom":"https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick\u0026hosted_button_id=Q5EYYEJ5NSJAU\u0026source=url"}},"created_at":"2022-04-26T14:20:58.000Z","updated_at":"2026-06-25T02:20:40.000Z","dependencies_parsed_at":"2024-01-11T01:19:56.266Z","dependency_job_id":"25f4128f-dfe3-4ef6-82d7-52c4999b096b","html_url":"https://github.com/benjamimgois/goverlay","commit_stats":null,"previous_names":[],"tags_count":76,"template":false,"template_full_name":null,"purl":"pkg:github/benjamimgois/goverlay","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/benjamimgois%2Fgoverlay","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/benjamimgois%2Fgoverlay/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/benjamimgois%2Fgoverlay/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/benjamimgois%2Fgoverlay/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/benjamimgois","download_url":"https://codeload.github.com/benjamimgois/goverlay/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/benjamimgois%2Fgoverlay/sbom","scorecard":{"id":232710,"data":{"date":"2025-08-11","repo":{"name":"github.com/benjamimgois/goverlay","commit":"1da5b558928fae791ee94234c31cf7c96a6ca945"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":4.2,"checks":[{"name":"Code-Review","score":2,"reason":"Found 5/22 approved changesets -- score normalized to 2","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Dangerous-Workflow","score":10,"reason":"no dangerous workflow patterns detected","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Maintained","score":10,"reason":"27 commit(s) and 8 issue activity found in the last 90 days -- score normalized to 10","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"Token-Permissions","score":0,"reason":"detected GitHub workflow tokens with excessive permissions","details":["Info: jobLevel 'actions' permission set to 'read': .github/workflows/appimage.yml:63","Warn: jobLevel 'security-events' permission set to 'write': .github/workflows/appimage.yml:64","Warn: jobLevel 'contents' permission set to 'write': .github/workflows/appimage.yml:65","Warn: no topLevel permission defined: .github/workflows/appimage.yml:1"],"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}},{"name":"License","score":10,"reason":"license file detected","details":["Info: project has a license file: LICENSE:0","Info: FSF or OSI recognized license: GNU General Public License v3.0: LICENSE:0"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Pinned-Dependencies","score":0,"reason":"dependency not pinned by hash detected -- score normalized to 0","details":["Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/appimage.yml:28: update your workflow using https://app.stepsecurity.io/secureworkflow/benjamimgois/goverlay/appimage.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/appimage.yml:54: update your workflow using https://app.stepsecurity.io/secureworkflow/benjamimgois/goverlay/appimage.yml/main?enable=pin","Warn: GitHub-owned GitHubAction not pinned by hash: .github/workflows/appimage.yml:68: update your workflow using https://app.stepsecurity.io/secureworkflow/benjamimgois/goverlay/appimage.yml/main?enable=pin","Warn: third-party GitHubAction not pinned by hash: .github/workflows/appimage.yml:86: update your workflow using https://app.stepsecurity.io/secureworkflow/benjamimgois/goverlay/appimage.yml/main?enable=pin","Warn: downloadThenRun not pinned by hash: appimage/goverlay-appimage.sh:63","Warn: downloadThenRun not pinned by hash: appimage/goverlay-appimage.sh:66","Info:   0 out of   3 GitHub-owned GitHubAction dependencies pinned","Info:   0 out of   1 third-party GitHubAction dependencies pinned","Info:   0 out of   2 downloadThenRun dependencies pinned"],"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'main'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}},{"name":"Signed-Releases","score":0,"reason":"Project has not signed or included provenance with any releases.","details":["Warn: release artifact 1.4.1 not signed: https://api.github.com/repos/benjamimgois/goverlay/releases/239489666","Warn: release artifact nightly not signed: https://api.github.com/repos/benjamimgois/goverlay/releases/239478027","Warn: release artifact 1.4.0 not signed: https://api.github.com/repos/benjamimgois/goverlay/releases/237081217","Warn: release artifact 1.3-3 not signed: https://api.github.com/repos/benjamimgois/goverlay/releases/206031971","Warn: release artifact 1.3-2 not signed: https://api.github.com/repos/benjamimgois/goverlay/releases/204252340","Warn: release artifact 1.4.1 does not have provenance: https://api.github.com/repos/benjamimgois/goverlay/releases/239489666","Warn: release artifact nightly does not have provenance: https://api.github.com/repos/benjamimgois/goverlay/releases/239478027","Warn: release artifact 1.4.0 does not have provenance: https://api.github.com/repos/benjamimgois/goverlay/releases/237081217","Warn: release artifact 1.3-3 does not have provenance: https://api.github.com/repos/benjamimgois/goverlay/releases/206031971","Warn: release artifact 1.3-2 does not have provenance: https://api.github.com/repos/benjamimgois/goverlay/releases/204252340"],"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"SAST","score":0,"reason":"SAST tool is not run on all commits -- score normalized to 0","details":["Warn: 0 commits out of 13 are checked with a SAST tool"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}}]},"last_synced_at":"2025-08-17T05:07:23.585Z","repository_id":38355502,"created_at":"2025-08-17T05:07:23.585Z","updated_at":"2025-08-17T05:07:23.585Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34993438,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-07-01T02:00:05.325Z","response_time":130,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-08-01T13:00:49.827Z","updated_at":"2026-07-01T05:01:07.155Z","avatar_url":"https://github.com/benjamimgois.png","language":"Pascal","funding_links":["https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick\u0026hosted_button_id=Q5EYYEJ5NSJAU\u0026source=url","https://ko-fi.com/T6T8ERJJ7'"],"categories":["Linux Performance","Applications","Hardware Performance(CPU, GPU, Gaming Peripherals)","Utilities","Steam Deck Development","Linux","Pascal","Software"],"sub_categories":["rFactor","Games","Gaming Peripherals","Overlays","Unreal Engine 5 Books","Other"],"readme":"\u003cp align=\"center\"\u003e\n \u003cimg width=\"320\" height=\"225\" alt=\"image\" src=\"/data/goverlay_header.webp\" /\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\"\u003e\n  \u003ca href=\"https://github.com/benjamimgois/Goverlay/releases\"\u003e\n    \u003cimg\n      src=\"https://img.shields.io/github/v/release/benjamimgois/Goverlay?color=4CAF50\u0026label=Latest%20release\u0026style=for-the-badge\"\n      alt=\"Latest release\"\u003e\n  \u003c/a\u003e\n\n  \u003ca href=\"https://flathub.org/apps/io.github.benjamimgois.goverlay\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/Flathub-Stable-blue?style=for-the-badge\u0026logo=flathub\" alt=\"Flathub status\"\u003e\n  \u003c/a\u003e\n\n  \u003ca href=\"https://aur.archlinux.org/packages/goverlay-git\"\u003e\n    \u003cimg\n      src=\"https://img.shields.io/aur/version/goverlay-git?color=1793d1\u0026label=AUR\u0026style=for-the-badge\"\n      alt=\"AUR version\"\u003e\n  \u003c/a\u003e\n\n\u003ca href=\"https://github.com/benjamimgois/Goverlay/releases\"\u003e\n  \u003cimg\n    src=\"https://img.shields.io/badge/AppImage-Stable-orange?style=for-the-badge\u0026logo=linux\"\n    alt=\"AppImage stable\"\u003e\n\u003c/a\u003e\n\n  \u003ca href=\"https://github.com/benjamimgois/Goverlay/blob/main/LICENSE\"\u003e\n    \u003cimg\n      src=\"https://img.shields.io/github/license/benjamimgois/Goverlay?color=2196f3\u0026label=License\u0026style=for-the-badge\"\n      alt=\"License\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n---\n\n**Goverlay** is a modern Qt6 GUI application for Linux gamers that puts powerful performance and visual tools behind an easy-to-use interface. It configures **MangoHud**, **vkBasalt**, **vkSumi**, **OptiScaler**, and **Proton environment tweaks** through a visual, card-based layout — generating the config files and launch commands you drop into Steam or Lutris.\n\nWhether you want real-time performance monitoring, post-processing effects, smarter upscaling, DLSS/FSR frame generation, or per-game environment overrides, Goverlay handles it in a few clicks.\n\nThis project exists thanks to the amazing work of the original maintainers and contributors behind the core tools.  \nI’m just a network engineer who loves Linux and gaming — this is my way of giving something back to the community.\n\n\u003cimg width=\"1129\" height=\"843\" alt=\"Screenshot 1\" src=\"/data/screenshots/0.webp\" /\u003e\n\n---\n\n## Table of Contents\n\n- [Screenshots](#screenshots)\n- [Prerequisites](#prerequisites)\n- [Installation](#installation)\n  - [Universal Methods](#universal-methods)\n    - [Flatpak](#flatpak)\n    - [AppImage](#appimage)\n  - [Distributions](#distributions)\n    - [Arch and derivatives](#arch-and-derivatives)\n    - [OpenSUSE](#opensuse)\n    - [Solus](#solus)\n    - [Fedora / Debian / Ubuntu](#fedora--debian--ubuntu)\n  - [Tarball](#tarball)\n  - [Building from Source](#building-from-source)\n- [Architecture](#architecture)\n- [Keyboard Shortcuts](#keyboard-shortcuts)\n- [Credits](#credits)\n- [Donations](#donations)\n\n---\n\n### Integrated Vulkan Preview (PasCube)\nGoverlay ships with **PasCube**, a full Vulkan demo compiled from the PasVulkan engine. It launches automatically (or on demand) to preview your MangoHud, vkBasalt, and vkSumi settings in real time. The demo title bar and overlay display the current GOverlay version.\n\n### Per-Game Config Architecture\nWhen a game is selected, GOverlay switches to **Game Mode**. Each game gets its own XDG-compliant config directory containing:\n- `MangoHud.conf`\n- `vkBasalt.conf`\n- `vkSumi.conf`\n- `OptiScaler.ini`\n- `fakenvapi.ini`\n- `bgmod.conf`\n- `bgmod` wrapper binary\n\nThe bottom **launch command box** updates to show the game-specific `bgmod` command with `%command%` suffix, ready to paste into Steam.\n\n### bgmod Wrapper\n`bgmod` is a compiled Free Pascal binary (not a bash script) that replaces the legacy `fgmod` approach. It:\n- Intercepts game execution arguments.\n- Exports environment variables from `bgmod.conf`.\n- Sets up Wine DLL overrides.\n- Copies upscaler binaries/plugins into the game folder on launch.\n- Supports launcher EXE replacements and UE Shipping EXE auto-discovery.\n- Logs to `/tmp/bgmod.log`, the game directory, and `~/.local/share/goverlay/logs/[Game Name]/`.\n\nAn uninstaller binary (`bgmod-uninstaller`) cleanly removes wrapper files and restores original backups.\n\n---\n\n## Screenshots\n\n\u003cdetails\u003e\n\u003csummary\u003e\u003cstrong\u003eClick to view screenshots\u003c/strong\u003e\u003c/summary\u003e\n\n\u003cimg width=\"1129\" height=\"843\" alt=\"Screenshot 1\" src=\"/data/screenshots/1.webp\" /\u003e\n\u003cimg width=\"1129\" height=\"843\" alt=\"Screenshot 2\" src=\"/data/screenshots/2.webp\" /\u003e\n\u003cimg width=\"1129\" height=\"843\" alt=\"Screenshot 3\" src=\"/data/screenshots/3.webp\" /\u003e\n\u003cimg width=\"1129\" height=\"843\" alt=\"Screenshot 4\" src=\"/data/screenshots/4.webp\" /\u003e\n\u003cimg width=\"1129\" height=\"843\" alt=\"Screenshot 5\" src=\"/data/screenshots/5.webp\" /\u003e\n\u003cimg width=\"1129\" height=\"843\" alt=\"Screenshot 6\" src=\"/data/screenshots/6.webp\" /\u003e\n\u003cimg width=\"1129\" height=\"843\" alt=\"Screenshot 7\" src=\"/data/screenshots/7.webp\" /\u003e\n\u003cimg width=\"1129\" height=\"843\" alt=\"Screenshot 7\" src=\"/data/screenshots/7.webp\" /\u003e\n\u003cimg width=\"1129\" height=\"843\" alt=\"Screenshot 7\" src=\"/data/screenshots/8.webp\" /\u003e\n\u003cimg width=\"1129\" height=\"843\" alt=\"Screenshot 7\" src=\"/data/screenshots/9.webp\" /\u003e\n\u003cimg width=\"1129\" height=\"843\" alt=\"Screenshot 7\" src=\"/data/screenshots/10.webp\" /\u003e\n\n\n\u003c/details\u003e\n\n---\n\n## Prerequisites\n\n### Required\n\n- [**`mangohud`**](https://github.com/flightlessmango/MangoHud) — Performance overlay / monitoring\n- [**`git`**](https://github.com/git/git) — Used to clone repositories (e.g., ReShade shaders)\n- [**`qt6pas`**](https://gitlab.com/freepascal.org/lazarus/lazarus/-/tree/main/lcl/interfaces/qt6/cbindings) — Qt6 bindings for Free Pascal / Lazarus\n- [**`gamemode`**](https://github.com/FeralInteractive/gamemode) — Feral GameMode daemon (for the GameMode tweak)\n- **Nerd Fonts** — Used for icon glyphs in the sidebar and game badges\n\n### Optional / Used by specific features\n\n- [**`vkBasalt`**](https://github.com/DadSchoorse/vkBasalt) — Vulkan post-processing effects\n- [**`vksumi`**](https://github.com/reakjra/vkSumi) *(optional but recommended)* — Alternative Vulkan post-processor with 15 tunable parameters\n- [**`zenergy`**](https://github.com/BoukeHaarsma23/zenergy) — Displays AMD CPU power metrics in MangoHud\n- [**`protontricks`**](https://github.com/Matoking/protontricks) — Proton prefix management (native builds only, disabled in Flatpak)\n\n\n\u003e [!NOTE]\n\u003e In Flatpak, GOverlay hides host-dependent features such as GameMode and Protontricks because it cannot reliably detect or execute host binaries.\n\n---\n\n## Installation\n\n## Universal Methods\n\n### Flatpak\n\nYou can download it from [**`Flathub`**](https://flathub.org/en/apps/io.github.benjamimgois.goverlay)\n\n```bash\n# Add Flathub repository\nflatpak remote-add --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo\n\n# Install Goverlay\nflatpak install flathub io.github.benjamimgois.goverlay\n\n# Install required Vulkan layers for MangoHud and vkBasalt support\nflatpak install flathub org.freedesktop.Platform.VulkanLayer.MangoHud//25.08 \\\norg.freedesktop.Platform.VulkanLayer.vkBasalt//25.08 -y\n\n# Download vksumi flatpak runtime from its github page and install\nhttps://github.com/reakjra/vkSumi\nflatpak install vkSumi-25.08.flatpak\n\n```\n\n### AppImage\n\nDownload the AppImage from the [Releases page](https://github.com/benjamimgois/Goverlay/releases) and make it executable:\n\n```bash\nchmod +x Goverlay_*.AppImage\n./Goverlay_*.AppImage\n```\n\n## Distributions\n\n### Arch and derivatives\n\n**Option 1 – Official Repository**\n```bash\nsudo pacman -S goverlay\n```\n**Option 2 – AUR**\n```bash\nyay -S goverlay-git\n```\n\n### OpenSUSE\n```bash\nsudo zypper install goverlay\n```\n\n### Solus\n```bash\nsudo eopkg it goverlay\n```\n\n\u003e [!IMPORTANT]\n\u003e **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.\n\n---\n\n#### Libqt6pas\nThe `libqt6pas` package is not available in some distributions’ official repositories.  \nYou can get it from [David Bannon’s repository](https://github.com/davidbannon/libqt6pas/releases):\n\nUbuntu example:\n```bash\nsudo apt-get update\nwget https://github.com/davidbannon/libqt6pas/releases/download/v6.2.8/libqt6pas6_6.2.8-1_amd64.deb\nsudo dpkg -i libqt6pas6_6.2.8-1_amd64.deb\n```\n\n## Tarball\n\n1. Download the latest tarball from the [Releases page](https://github.com/benjamimgois/Goverlay/releases).\n2. Extract it:\n   ```bash\n   tar -xvf Goverlay*.tar.xz\n   ```\n3. Run the binary:\n   ```bash\n   ./Goverlay\n   ```\n\n\u003e **Note:** Since version 0.6.4, MangoHud must be installed to run Goverlay.\n\n## Building from Source\n\n### Prerequisites\n\n- [Lazarus IDE](https://gitlab.com/freepascal.org/lazarus/lazarus) with Qt6 widgetset support\n- Qt6 development libraries (`qt6-base-dev` or equivalent)\n- `make`\n- `git`\n\n### Building\n\n```bash\ngit clone https://github.com/benjamimgois/Goverlay.git\ncd Goverlay\nmake\n```\n\nThis compiles both `goverlay` and the integrated `pascube` Vulkan preview.\n\n### Running\n\n```bash\n./goverlay\n```\n\n### Installing\n\n```bash\nsudo make install\n```\n\nThis installs the startup script to `/usr/local/bin/goverlay`, allowing you to launch it directly via:\n\n```bash\ngoverlay\n```\n\n---\n\n## Architecture\n\n| Component | Technology |\n|---|---|\n| Language | Free Pascal (ObjFPC mode) |\n| IDE / Framework | Lazarus LCL with Qt6 widgetset |\n| UI Designer | Lazarus IDE manages `.lfm` files |\n| Build Tool | `make` (wrapper around `lazbuild`) |\n| Target | Single Linux binary (`goverlay`) |\n| Preview | Integrated Vulkan demo (`pascube`, PasVulkan engine) |\n| Wrapper | Compiled Free Pascal binary (`bgmod`) replacing legacy bash scripts |\n\n---\n\n## Keyboard Shortcuts\n\n| Shortcut | Action |\n|----------|--------|\n| `Ctrl + S` | Save current tab configuration |\n| `Ctrl + C` | Copy launch command to clipboard |\n| `Ctrl + F` | Focus global search field |\n| `F1` | Open \"How to use FGMOD\" quick guide |\n\n---\n\n## Credits\n\n### FlightlessMango\n\nHuge thanks to **FlightlessMango**, creator and maintainer of **MangoHud** — the foundation that made Goverlay possible.\n\n- https://flightlessmango.com\n- https://github.com/flightlessmango/MangoHud\n- https://discord.com/invite/Gj5YmBb\n\n### DadSchoorse\n\nSpecial thanks to **DadSchoorse**, creator of **vkBasalt**, which adds post-processing effects to Vulkan.\n\n- https://github.com/DadSchoorse/vkBasalt\n\n### OptiScaler Team \u0026 Contributors\n\nGoverlay integrates several components from the OptiScaler ecosystem and community-driven projects that enable upscaling, frame generation, and NVIDIA APIs on Linux.\n\n**OptiScaler**\n\nCore upscaling and frame-generation project for Linux.\n\nhttps://github.com/optiscaler/OptiScaler\n\n**fakenvapi**\n\nUser-space implementation of NVAPI used by OptiScaler and other tools.\n\nhttps://github.com/optiscaler/fakenvapi\n\n**Decky-Framegen (xXJSONDeruloXx)**\n\nPioneer project that inspired much of the OptiScaler installation logic.\n\nhttps://github.com/xXJSONDeruloXx/Decky-Framegen\n\n**fgmod (FakeMichau)**\n\nAnother important reference implementation for frame-generation utilities on Linux.\n\nhttps://github.com/FakeMichau/fgmod\n\n**DLSS-Enabler (Artur Graniszewski)**\n\nTooling that expands compatibility layers for DLSS and NVAPI-based features.\n\nhttps://github.com/artur-graniszewski/DLSS-Enabler\n\n### Lazarus IDE\n\nThis project was built using the [Lazarus IDE](https://www.lazarus-ide.org/).\n\n\u003ca href=\"https://www.lazarus-ide.org/\"\u003e\u003cimg src=\"https://i.ibb.co/9ykXNtw/Laz-banner.png\" alt=\"Laz-banner\" border=\"0\"\u003e\u003c/a\u003e\n\n---\n\n## Donations\n\nIf this project has been useful to you, consider supporting its development ❤️\n\n\u003ca href='https://ko-fi.com/T6T8ERJJ7' target='_blank'\u003e\u003cimg height='36' style='border:0px;height:36px;' src='https://storage.ko-fi.com/cdn/kofi6.png?v=6' border='0' alt='Buy Me a Coffee at ko-fi.com' /\u003e\u003c/a\u003e\n\n[![paypal](https://www.paypalobjects.com/en_US/i/btn/btn_donateCC_LG.gif)](https://www.paypal.com/cgi-bin/webscr?cmd=_s-xclick\u0026hosted_button_id=Q5EYYEJ5NSJAU\u0026source=url)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbenjamimgois%2Fgoverlay","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fbenjamimgois%2Fgoverlay","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fbenjamimgois%2Fgoverlay/lists"}