Skip to content

Installation

Dependencies

The GUI depends on Qt, which often requires a library that is not installed by default on most desktop environments. Install it with:

sudo apt update && sudo apt install libxcb-cursor0

sudo dnf install xcb-util-cursor

sudo pacman -S xcb-util-cursor

sudo zypper install libxcb-cursor0

Installation methods

If you don’t have pipx installed, install it first:

sudo apt update && sudo apt install pipx
pipx ensurepath

sudo dnf install pipx
pipx ensurepath

sudo pacman -S python-pipx
pipx ensurepath

sudo zypper install python-pipx
pipx ensurepath

Then install the upscaler:

pipx install linux-rt-upscaler

And that's it! ⭐

Install from source

Building from source requires C/C++ compilation tools and development packages. Install them with:

sudo apt update && sudo apt install gcc make libvulkan-dev libx11-dev libxcb1-dev \
    libx11-xcb-dev libxext-dev libxdamage-dev libxfixes-dev

sudo dnf install gcc make vulkan-loader-devel libX11-devel libxcb-devel libX11-xcb-devel \
    libXext-devel libXdamage-devel libXfixes-devel

sudo pacman -S base-devel vulkan-devel libx11 libxcb libxext libxdamage libxfixes

sudo zypper install gcc make vulkan-devel libX11-devel libxcb-devel libX11-xcb-devel \
    libXext-devel libXdamage-devel libXfixes-devel

Then clone and install:

git clone https://github.com/baronsmv/linux-rt-upscaler.git
cd linux-rt-upscaler

# build in local env:
pip install -e .

# or better, inside a uv virtual env:
uv venv && uv pip install -e .

Desktop integration (optional)

After installing, you can add a desktop entry so the GUI appears in your application menu:

curl -fsSL https://raw.githubusercontent.com/baronsmv/linux-rt-upscaler/refs/heads/main/scripts/desktop_integration.sh \
    -o /tmp/desktop_integration.sh
less /tmp/desktop_integration.sh  # always review scripts before running them
sh /tmp/desktop_integration.sh