Installation Guide

If you want to get lsfg-vk up and running as fast as possible, follow these steps:

1. Buy and install Lossless Scaling on Steam.
2. Go to the Releases page and download the file suiting your Linux distribution.
   • Download the file ending in .deb for distributions using DPKG (Debian, Ubuntu, Mint, etc.).
   • Download the file ending in .rpm for distributions using RPM (Fedora, etc.).
   • Download the file ending in .tar.zst for distributions using ALPM (Arch Linux, CachyOS, SteamOS, etc.).
   • Otherwise download the file ending in .zip.
3. Open a terminal in the folder where you downloaded the file and follow the instructions for your distribution (see below, make sure to adjust the filenames!).
4. (Optional) If you're running Flatpak, follow the install instructions below.
5. After installing, continue reading this page to configure lsfg-vkx

Should you encounter any issues during these steps, read the troubleshooting guide.

Distributions using DPKG (Debian, Ubuntu, Mint, etc.)

sudo apt install ./lsfg-vk-x.y.z-x86_64.deb

Distributions using RPM (Fedora, etc.)

sudo dnf install ./lsfg-vk-x.y.z-x86_64.rpm

Distributions using ALPM (Arch Linux, CachyOS, SteamOS, etc.)

Important

Steam Deck users need to run these commands before installing:

sudo pacman-key --init
sudo pacman-key --populate holo
sudo pacman -Syy

sudo pacman -U ./lsfg-vk-x.y.z-x86_64.tar.zst

Other distributions

Change into the /usr/local directory:

cd /usr/local

Specify the full path to the zip file you downloaded:

unzip /path/to/lsfg-vk-x.y.z-x86_64.zip

Edit the .json file that was just created using a text editor and replace the following line:

    "library_path": "liblsfg-vk.so",
turns into
    "library_path": "/usr/local/lib/liblsfg-vk.so",

Flatpak

Note

As of right now, this method does not install the graphical configuration editor lsfg-vk-ui.

Download both Flatpak files from the same page, then install both (you can omit the --user in a system installation):

flatpak --user install ./org.freedesktop.Platform.VulkanLayer.lsfg_vk_23.08.flatpak
flatpak --user install ./org.freedesktop.Platform.VulkanLayer.lsfg_vk_24.08.flatpak

Next, you need to give any Flatpak app you want to use access to the lsfg-vk configuration directory.

# replace <user> with your username and <appid> with the appid (e.g. io.mpv.Mpv)
mkdir -pv ~/.config/lsfg-vk
flatpak override --user --filesystem=/home/<user>/.config/lsfg-vk:rw <appid>
flatpak override --user --env=LSFG_CONFIG=/home/<user>/.config/lsfg-vk/conf.toml <appid>