Skip to content

Spexxl/OptiTux-GUI

Repository files navigation

OptiTux GUI Logo

OptiTux GUI

A native Linux frontend for managing OptiScaler installations across your game library.

Discord Patreon Buy Me a Coffee


Warning

OptiTux GUI is an independent, community-built tool and has no affiliation with the official OptiScaler project. OptiScaler is developed and maintained by its own team. This tool simply provides a graphical interface to manage OptiScaler installations on Linux. All credit for OptiScaler itself goes to its developers — see Credits.


What is it?

OptiTux GUI lets you install, configure, and remove OptiScaler across your Linux game library — without touching the terminal or manually copying files.

It scans your Steam and Heroic library, detects your GPU, picks the right upscaling backend automatically, and handles everything from downloading OptiScaler releases to writing the correct configuration into OptiScaler.ini.

What you can do with it:

  • Browse your installed games and see which ones have OptiScaler active
  • Quick Install — one click, done. Detects your GPU, picks the best upscaler, downloads if needed, installs and configures
  • Custom Install — choose the exact OptiScaler version, upscaler backend (FSR, DLSS, XeSS), whether to include the FSR4 INT8 addon, and optionally enable Frame Generation
  • Download and manage OptiScaler releases from both the official repository and the OptiTuxDB
  • Uninstall cleanly, with automatic backup and restore of the original DLLs

Game List Interface


Requirements

OptiTux GUI is built with Tauri and runs on Linux.

Runtime dependencies (required):

  • A working desktop environment with WebView support (WebKitGTK)

Optional but recommended:

p7zip

OptiScaler releases ship as .7z archives. OptiTux GUI includes a fallback extractor, but the native p7zip binary is significantly faster — especially noticeable on large archives.

Distro Command
Arch / Manjaro sudo pacman -S p7zip
Fedora / RHEL sudo dnf install p7zip p7zip-plugins
Ubuntu / Debian sudo apt install p7zip-full
openSUSE sudo zypper install p7zip

pciutils (lspci)

Used to accurately detect your GPU model and architecture. Without it, GPU detection falls back to sysfs, which may be less precise for certain cards.

Distro Command
Arch / Manjaro sudo pacman -S pciutils
Fedora / RHEL sudo dnf install pciutils
Ubuntu / Debian sudo apt install pciutils
openSUSE sudo zypper install pciutils

📦 Installation Guide

All installation files can be found on the GitHub Releases page. Choose the format that best fits your Linux distribution.

🔹 .deb (Debian, Ubuntu, Linux Mint, Pop!_OS)

Ideal for Debian and Ubuntu-based distributions.

  • How to install:
    1. Download the .deb file.
    2. Double-click the file to open it with your interface's package installer (such as GNOME Software or GDebi Package Installer).
    3. Alternatively, install via terminal:
      sudo apt install ./optitux-gui_amd64.deb

🔹 .rpm (Fedora, Nobara, openSUSE, RHEL)

Ideal for distributions that use the RPM package manager.

  • How to install:
    1. Download the .rpm file.
    2. Double-click the file to open it with the Software Center (GNOME Software, Discover).
    3. Alternatively, install via terminal:
      sudo dnf install ./optitux-gui.rpm

🔹 .flatpak (Universal)

Flatpak is a universal format that runs in a sandbox, ensuring the program works regardless of the libraries installed on your main system.

  • Requirements: You must have Flatpak support enabled on your distro. If you don't have it, follow the instructions at flatpak.org/setup.
  • How to install:
    1. Download the .flatpak file.
    2. Since this is a local package (bundle), it should be installed via terminal to ensure that permissions and runtime dependencies are correctly pulled:
      flatpak install ./optitux-gui.flatpak
    3. Follow the on-screen instructions and confirm the installation of dependencies (GNOME runtimes) if prompted.
  • How to run: The app will appear in your system menu.
  • ⚠️ Troubleshooting (Missing Icon): On some distributions (especially Arch-based like CachyOS, Manjaro, or EndeavourOS), the app icon might not appear immediately after installation. To fix this:
    • Restart your session: Log out and log back in, or simply reboot your system. This forces the desktop environment to refresh the Flatpak export paths.
    • Manual Run: You can always launch it via terminal while the icon doesn't show:
    flatpak run optitux-gui 

🔹 .tar.zst (Portable / Generic)

This is a compressed file containing the program's binary. It can be run on any Linux distribution as long as the system has the base libraries installed.

  • Requirements: Make sure you have the runtime dependencies listed in the Requirements section (such as webkit2gtk, p7zip, and pciutils).
  • How to install:
    1. Download and extract the file:
      tar -xzf optitux-gui.pkg.tar.zst 
    2. Enter the extracted folder:
      cd optitux-gui
    3. Give execution permission to the binary (if necessary):
      chmod +x optitux
    4. Run the program:
      ./optitux
  • Tip: You can move the extracted folder to a permanent location (like /opt or ~/.local/bin) and manually create a .desktop file so it appears in your menu.

You will need Rust and Node.js installed.

# Clone the repository
git clone https://github.com/Spexxl/OptiTux-GUI.git
cd OptiTux-GUI

# Install frontend dependencies
npm install

# Run in development mode
npm run tauri dev

# Build a release binary
npm run tauri build

Support the project

Running a community hub with version hosting and infrastructure costs time and money. If OptiTux GUI has been useful to you, consider supporting its development:

Patreon Buy Me a Coffee


Credits

OptiTux GUI would not exist without the work of the OptiScaler project.

OptiScaler — the upscaling compatibility layer that OptiTux GUI manages. All upscaling functionality, DLL injection, and INI configuration logic belongs to the OptiScaler team and its contributors.

If you find OptiScaler useful, consider supporting its developers directly through their repository.

About

Optiscaler interface manager for Linux.

Topics

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors