lsfg-vk-flake/README.md
Nojus dfdc7159e1 readme: mention ui package
at this point it might be better to overlay the packages onto pkgs but this remains a task for future me
2025-07-27 02:23:37 +02:00

70 lines
No EOL
1.9 KiB
Markdown

# lsfg-vk-flake
Nix flake for using [Lossless Scaling's frame generation on Linux](https://github.com/PancakeTAS/lsfg-vk)
>[!IMPORTANT]
> You need to have Lossless Scaling installed on Steam!
> In case it is not installed on the default Steam drive, you may want to consider setting the correct path in the lsfg-vk config.
## Installation
### System-wide (NixOS module)
This approach will install an implicit layer to ``/etc/vulkan/implicit_layer.d/``
Add this to your flake inputs, output function and modules list:
```nix
inputs = {
...
lsfg-vk-flake.url = "github:pabloaul/lsfg-vk-flake/main";
lsfg-vk-flake.inputs.nixpkgs.follows = "nixpkgs";
}
outputs = {nixpkgs, lsfg-vk-flake, ...}: {
nixosConfigurations.hostname = nixpkgs.lib.nixosSystem {
...
modules = [
...
lsfg-vk-flake.nixosModules.default
];
};
}
```
And then enable this in your system config:
```nix
services.lsfg-vk = {
enable = true;
ui.enable = true; # installs gui for configuring lsfg-vk
};
```
### User install (manual)
1. Build the library:
```bash
nix build
```
2. Create the following path in case it does not exist:
```bash
mkdir -p $HOME/.local/share/vulkan/implicit_layer.d
```
3. Symlink the build results to your $HOME/.local/
```bash
cp -ifrsv "$(readlink -f ./result)"/* $HOME/.local/
```
## Usage
Run a Vulkan application with the environment variable ``ENABLE_LSFG=1`` set.
Example:
```bash
ENABLE_LSFG=1 vkcube
```
To confirm that it is working, look for output like this in the terminal: lsfg-vk(...): ...
You can also enable it per game on Steam by adding this to the launch options:
```
ENABLE_LSFG=1 %COMMAND%
```
>[!NOTE]
> If the environment variable is set but the program doesn't show any lsfg-vk output, you may need to add the application to your lsfg-vk configuration file at `~/.config/lsfg-vk/config.toml`. Read more about it in the [Wiki](https://github.com/PancakeTAS/lsfg-vk/wiki/Configuring-lsfg-vk)