https://github.com/daaboulex/lsfg-vk-nix
LSFG-VK packaged for NixOS — Vulkan frame generation for Linux
https://github.com/daaboulex/lsfg-vk-nix
flake frame-generation gaming gpu nix nixos vulkan
Last synced: 24 days ago
JSON representation
LSFG-VK packaged for NixOS — Vulkan frame generation for Linux
- Host: GitHub
- URL: https://github.com/daaboulex/lsfg-vk-nix
- Owner: Daaboulex
- License: mit
- Created: 2026-03-03T13:13:12.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2026-05-17T06:45:23.000Z (about 1 month ago)
- Last Synced: 2026-05-17T08:42:49.526Z (about 1 month ago)
- Topics: flake, frame-generation, gaming, gpu, nix, nixos, vulkan
- Language: Shell
- Size: 20.5 KB
- Stars: 3
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Security: SECURITY.md
Awesome Lists containing this project
README
# lsfg-vk-nix
[](https://github.com/Daaboulex/lsfg-vk-nix/actions/workflows/ci.yml)
[](https://nixos.org)
[](./LICENSE)
Nix package for [lsfg-vk](https://github.com/PancakeTAS/lsfg-vk) by [PancakeTAS](https://github.com/PancakeTAS) — Vulkan frame generation using [Lossless Scaling](https://store.steampowered.com/app/993090/Lossless_Scaling/) on Linux.
## Upstream
| | |
|---|---|
| **Project** | [Starter-Pack-Gaming/lsfg-vk](https://github.com/Starter-Pack-Gaming/lsfg-vk) |
| **License** | GPL-3.0 |
| **Tracked** | Git commits (v2.0.0-dev) |
## What Is This?
A Nix flake that builds the lsfg-vk Vulkan layer + UI + CLI from upstream with full CI infrastructure:
- **Upstream tracking** every 6 hours via GitHub Actions — new commits land here within hours
- **Pre-build verification** — fail-closed pipeline (eval → build → ELF check) before any push to `main`
- **Implicit Vulkan layer** — auto-loads for any Vulkan game; per-game enable through environment variables or the GUI
- **Lossless Scaling integration** — pulls the Lossless Scaling DLL from the user's Steam install at runtime; this flake does NOT redistribute Lossless Scaling
## What's Included
| Component | Description |
|---|---|
| **lsfg-vk layer** | Implicit Vulkan layer that generates additional frames using Lossless Scaling's frame generation algorithm |
| **lsfg-vk-ui** | Qt6/QML graphical configuration interface with per-game profiles, flow scale controls, and performance mode |
| **lsfg-vk-cli** | Command-line tool for benchmarking and configuration validation |
## Requirements
- **[Lossless Scaling](https://store.steampowered.com/app/993090/Lossless_Scaling/)** installed via Steam
- Vulkan-capable GPU (AMD RADV, NVIDIA, Intel)
## Installation
Add as a flake input:
```nix
{
inputs.lsfg-vk = {
url = "github:Daaboulex/lsfg-vk-nix";
inputs.nixpkgs.follows = "nixpkgs";
};
}
```
Then add the overlay:
```nix
nixpkgs.overlays = [ inputs.lsfg-vk.overlays.default ];
```
## Usage
### As a Flake Input
```nix
{
inputs.lsfg-vk = {
url = "github:daaboulex/lsfg-vk-nix";
inputs.nixpkgs.follows = "nixpkgs";
};
}
```
Add the overlay to your system configuration:
```nix
nixpkgs.overlays = [ inputs.lsfg-vk.overlays.default ];
```
Then add to your packages:
```nix
environment.systemPackages = [ pkgs.lsfg-vk ];
```
### Quick Test (without installing)
```bash
nix run github:daaboulex/lsfg-vk-nix # Launch the UI
nix run github:daaboulex/lsfg-vk-nix#lsfg-vk-cli # Launch the CLI
```
## Configuration
After installation, launch `lsfg-vk-ui` from your application menu or terminal:
```bash
lsfg-vk-ui
```
- Configure per-game profiles in the **Profile Settings** section.
- Set the Lossless Scaling install path in **Global Settings** (auto-detected for Steam).
- Run benchmarks with `lsfg-vk-cli benchmark`.
- Validate your config with `lsfg-vk-cli validate`.
The Vulkan layer activates automatically for any game matching a configured profile.
To disable the layer for a specific application:
```bash
DISABLE_LSFGVK=1 your-application
```
## Updates
This package tracks the upstream `v2.0.0-dev` tag from [PancakeTAS/lsfg-vk](https://github.com/PancakeTAS/lsfg-vk). A GitHub Actions workflow automatically checks for new releases and updates the package hash.
## Development
```bash
nix develop # dev shell with pre-commit hooks
nix flake check --no-build # eval check (fast)
nix build # build package
nix fmt # format with treefmt
```
## Credits
- **[PancakeTAS](https://github.com/PancakeTAS)** — Creator and maintainer of lsfg-vk
- **[Lossless Scaling](https://store.steampowered.com/app/993090/Lossless_Scaling/)** by [TechPowerUp](https://www.techpowerup.com/)
- All upstream [contributors](https://github.com/PancakeTAS/lsfg-vk/graphs/contributors)
## License
- **Nix packaging (this repo)**: [MIT](LICENSE)
- **lsfg-vk (upstream)**: [GPL-3.0](https://github.com/PancakeTAS/lsfg-vk/blob/develop/LICENSE.md)
---
*Maintained as part of the [Daaboulex](https://github.com/Daaboulex) NixOS ecosystem.*