From 05c333ef555dbd0a18f650daf2b21e3728259383 Mon Sep 17 00:00:00 2001 From: Kurt Himebauch <136133082+xXJSONDeruloXx@users.noreply.github.com> Date: Sat, 5 Sep 2026 17:58:04 -0400 Subject: docs: update lsfg-vk v2 usage --- README.md | 14 +++++++------- 1 file changed, 7 insertions(+), 7 deletions(-) (limited to 'README.md') diff --git a/README.md b/README.md index e8bf1fa..199e5e7 100644 --- a/README.md +++ b/README.md @@ -16,7 +16,7 @@ ## What is this? -A Decky plugin that streamlines the installation of **lsfg-vk** ([Lossless Scaling Frame Generation Vulkan layer](https://github.com/PancakeTAS/lsfg-vk)) on Steam Deck, allowing you to use the Lossless Scaling frame generation features on Linux with a controller friendly UI in SteamOS, Bazzite, or any other Linux platform compatible with Decky Loader. +A Decky plugin that streamlines the installation of **lsfg-vk** ([Lossless Scaling Frame Generation Vulkan layer](https://lsfg-vk.dev/)) on Steam Deck, allowing you to use the Lossless Scaling frame generation features on Linux with a controller friendly UI in SteamOS, Bazzite, or any other Linux platform compatible with Decky Loader. ## Installation @@ -33,7 +33,7 @@ A Decky plugin that streamlines the installation of **lsfg-vk** ([Lossless Scali 1. **Purchase and install** [Lossless Scaling](https://store.steampowered.com/app/993090/Lossless_Scaling/) from Steam 2. **Open the plugin** from the Decky menu 3. **Click "Install lsfg-vk"** to automatically set up the lsfg-vk vulkan layer -4. **Configure settings** using the plugin's UI - adjust FPS multiplier, flow scale, performance mode, HDR settings, and experimental features +4. **Configure settings** using the plugin's UI - adjust FPS multiplier, flow scale, FP16 acceleration, performance mode, and launch workarounds 5. **Apply launch option** to games you want to use frame generation with: - Add `~/lsfg %command%` to your game's launch options in Steam Properties - Or use the "Launch Option Clipboard" button in the plugin to copy the command @@ -44,7 +44,7 @@ A Decky plugin that streamlines the installation of **lsfg-vk** ([Lossless Scali The plugin provides several configuration options to optimize frame generation for your games: ### Core Settings -- **FPS Multiplier**: Choose between 2x, 3x, or 4x frame generation +- **FPS Multiplier**: Use OFF/1x bypass or choose 2x, 3x, or 4x frame generation - **Flow Scale**: Adjust motion estimation quality (lower = better performance, higher = better quality) - **Performance Mode**: Uses a lighter processing model - recommended for most games - **HDR Mode**: Enable for games that support HDR output @@ -70,17 +70,17 @@ For per-game feedback and community support, please join the [decky-lsfg-vk Disc ## What it does The plugin: -- Automatically downloads and installs the latest lsfg-vk Vulkan layer to `~/.local/lib/` +- Installs the pinned lsfg-vk 2.0.0 x86_64 and x86 Vulkan layers from the official upstream build - Configures the Vulkan layer in `~/.local/share/vulkan/implicit_layer.d/` -- Creates a TOML configuration file in `~/.config/lsfg-vk/conf.toml` with your settings +- Creates and migrates the v2 TOML configuration in `~/.config/lsfg-vk/conf.toml`, preserving a one-time v1 backup during upgrade - Automatically detects your Lossless Scaling DLL installation - Provides an easy-to-use interface to configure frame generation settings: - - **FPS Multiplier**: Choose 2x, 3x, or 4x frame generation + - **FPS Multiplier**: Use OFF/1x bypass or choose 2x, 3x, or 4x frame generation - **Flow Scale**: Adjust motion estimation quality vs performance - **Performance Mode**: Use lighter processing for better performance - **HDR Mode**: Enable for HDR-compatible games - **Experimental Features**: Override present mode and set FPS limits -- **Hot-reloading**: Configuration changes apply immediately without restarting games +- **Hot-reloading**: Multiplier, flow scale, and performance mode changes apply without restarting games - Easy uninstallation that removes all installed files when no longer needed ## Credits -- cgit v1.2.3 From 230e26e967b985d09f2d753fdf58e48b4b367a0a Mon Sep 17 00:00:00 2001 From: Kurt Himebauch <136133082+xXJSONDeruloXx@users.noreply.github.com> Date: Sat, 5 Sep 2026 17:58:28 -0400 Subject: docs: remove stale v1 references --- README.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) (limited to 'README.md') diff --git a/README.md b/README.md index 199e5e7..66c11ff 100644 --- a/README.md +++ b/README.md @@ -47,7 +47,7 @@ The plugin provides several configuration options to optimize frame generation f - **FPS Multiplier**: Use OFF/1x bypass or choose 2x, 3x, or 4x frame generation - **Flow Scale**: Adjust motion estimation quality (lower = better performance, higher = better quality) - **Performance Mode**: Uses a lighter processing model - recommended for most games -- **HDR Mode**: Enable for games that support HDR output +- **FP16 Acceleration**: Use half-precision acceleration when supported ## Feedback and Support @@ -78,14 +78,14 @@ The plugin: - **FPS Multiplier**: Use OFF/1x bypass or choose 2x, 3x, or 4x frame generation - **Flow Scale**: Adjust motion estimation quality vs performance - **Performance Mode**: Use lighter processing for better performance - - **HDR Mode**: Enable for HDR-compatible games + - **FP16 Acceleration**: Use half-precision acceleration when supported - **Experimental Features**: Override present mode and set FPS limits - **Hot-reloading**: Multiplier, flow scale, and performance mode changes apply without restarting games - Easy uninstallation that removes all installed files when no longer needed ## Credits -- **[PancakeTAS](https://github.com/PancakeTAS/lsfg-vk)** for creating the lsfg-vk Vulkan compatibility layer +- **[PancakeTAS](https://lsfg-vk.dev/)** for creating the lsfg-vk Vulkan compatibility layer - **[Lossless Scaling](https://store.steampowered.com/app/993090/Lossless_Scaling/)** developers for the original frame generation technology - **[Deck Wizard](https://www.youtube.com/@DeckWizard)** - Extensive community support including comprehensive guides, promotional content, thorough testing and feedback, custom artworks, and tutorial videos. His passionate advocacy and continuous support have been instrumental in this plugin's success. - The **Decky Loader** team for the plugin framework -- cgit v1.2.3 From e8e469f99078858dc953663cba6f3428e80b1c5d Mon Sep 17 00:00:00 2001 From: xXJSONDeruloXx Date: Sat, 5 Sep 2026 23:44:37 -0400 Subject: refactor: delegate runtime checks to lsfg-vk --- README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) (limited to 'README.md') diff --git a/README.md b/README.md index 66c11ff..3d9ee7e 100644 --- a/README.md +++ b/README.md @@ -57,7 +57,7 @@ For per-game feedback and community support, please join the [decky-lsfg-vk Disc **Frame generation not working?** - Ensure you've added `~/lsfg %command%` to your game's launch options -- Check that the Lossless Scaling DLL was detected correctly in the plugin +- Ensure the Lossless Scaling installation is visible to the upstream lsfg-vk search paths - Try enabling Performance Mode if you're experiencing crashes - Make sure your game is running in fullscreen mode for best results @@ -73,7 +73,7 @@ The plugin: - Installs the pinned lsfg-vk 2.0.0 x86_64 and x86 Vulkan layers from the official upstream build - Configures the Vulkan layer in `~/.local/share/vulkan/implicit_layer.d/` - Creates and migrates the v2 TOML configuration in `~/.config/lsfg-vk/conf.toml`, preserving a one-time v1 backup during upgrade -- Automatically detects your Lossless Scaling DLL installation +- Delegates Lossless Scaling DLL discovery to lsfg-vk's upstream runtime search - Provides an easy-to-use interface to configure frame generation settings: - **FPS Multiplier**: Use OFF/1x bypass or choose 2x, 3x, or 4x frame generation - **Flow Scale**: Adjust motion estimation quality vs performance -- cgit v1.2.3 From ad2b182777bfd0a5ceef6e654df75ff13eb8b503 Mon Sep 17 00:00:00 2001 From: xXJSONDeruloXx Date: Sun, 6 Sep 2026 15:08:45 -0400 Subject: refactor: offload configuration to lsfg-vk --- README.md | 13 +++++++------ 1 file changed, 7 insertions(+), 6 deletions(-) (limited to 'README.md') diff --git a/README.md b/README.md index 3d9ee7e..4be9cca 100644 --- a/README.md +++ b/README.md @@ -33,18 +33,18 @@ A Decky plugin that streamlines the installation of **lsfg-vk** ([Lossless Scali 1. **Purchase and install** [Lossless Scaling](https://store.steampowered.com/app/993090/Lossless_Scaling/) from Steam 2. **Open the plugin** from the Decky menu 3. **Click "Install lsfg-vk"** to automatically set up the lsfg-vk vulkan layer -4. **Configure settings** using the plugin's UI - adjust FPS multiplier, flow scale, FP16 acceleration, performance mode, and launch workarounds +4. **Configure settings** using the plugin's UI - select Default or a running/configured game and adjust the upstream lsfg-vk settings 5. **Apply launch option** to games you want to use frame generation with: - Add `~/lsfg %command%` to your game's launch options in Steam Properties - Or use the "Launch Option Clipboard" button in the plugin to copy the command -6. **Launch your game** - frame generation will activate automatically using your plugin configuration +6. **Launch your game** - frame generation activates when the game's Steam AppID matches an assigned upstream profile ## Configuration Options -The plugin provides several configuration options to optimize frame generation for your games: +The plugin edits upstream lsfg-vk v2 profiles directly. Unassigned games leave the layer unloaded. ### Core Settings -- **FPS Multiplier**: Use OFF/1x bypass or choose 2x, 3x, or 4x frame generation +- **FPS Multiplier**: Choose 2x, 3x, or 4x frame generation - **Flow Scale**: Adjust motion estimation quality (lower = better performance, higher = better quality) - **Performance Mode**: Uses a lighter processing model - recommended for most games - **FP16 Acceleration**: Use half-precision acceleration when supported @@ -79,8 +79,9 @@ The plugin: - **Flow Scale**: Adjust motion estimation quality vs performance - **Performance Mode**: Use lighter processing for better performance - **FP16 Acceleration**: Use half-precision acceleration when supported - - **Experimental Features**: Override present mode and set FPS limits -- **Hot-reloading**: Multiplier, flow scale, and performance mode changes apply without restarting games +- **Present Mode**: Override FIFO/VSync behavior +- **Swapchain Image Count**: Preserve the application's swapchain image count +- **Hot-reloading**: Upstream reloads settings for the active profile; profile assignment itself applies on the next launch - Easy uninstallation that removes all installed files when no longer needed ## Credits -- cgit v1.2.3 From 7bc5f685186b1ff03ce0f7c99e7bec411beabaeb Mon Sep 17 00:00:00 2001 From: xXJSONDeruloXx Date: Sun, 6 Sep 2026 22:04:54 -0400 Subject: feat: make ui suck less, frfr --- README.md | 41 ++--------------------------------------- 1 file changed, 2 insertions(+), 39 deletions(-) (limited to 'README.md') diff --git a/README.md b/README.md index 4be9cca..13918fd 100644 --- a/README.md +++ b/README.md @@ -34,56 +34,19 @@ A Decky plugin that streamlines the installation of **lsfg-vk** ([Lossless Scali 2. **Open the plugin** from the Decky menu 3. **Click "Install lsfg-vk"** to automatically set up the lsfg-vk vulkan layer 4. **Configure settings** using the plugin's UI - select Default or a running/configured game and adjust the upstream lsfg-vk settings -5. **Apply launch option** to games you want to use frame generation with: - - Add `~/lsfg %command%` to your game's launch options in Steam Properties - - Or use the "Launch Option Clipboard" button in the plugin to copy the command 6. **Launch your game** - frame generation activates when the game's Steam AppID matches an assigned upstream profile -## Configuration Options - -The plugin edits upstream lsfg-vk v2 profiles directly. Unassigned games leave the layer unloaded. - ### Core Settings + - **FPS Multiplier**: Choose 2x, 3x, or 4x frame generation - **Flow Scale**: Adjust motion estimation quality (lower = better performance, higher = better quality) -- **Performance Mode**: Uses a lighter processing model - recommended for most games +- **Performance Mode**: Uses a lighter processing model (recommended for most games) - **FP16 Acceleration**: Use half-precision acceleration when supported ## Feedback and Support For per-game feedback and community support, please join the [decky-lsfg-vk Discord Channel](https://discord.gg/TwvHdVucC3) -## Troubleshooting - -**Frame generation not working?** -- Ensure you've added `~/lsfg %command%` to your game's launch options -- Ensure the Lossless Scaling installation is visible to the upstream lsfg-vk search paths -- Try enabling Performance Mode if you're experiencing crashes -- Make sure your game is running in fullscreen mode for best results - -**Performance issues?** -- Lower the Flow Scale setting for better performance -- Enable Performance Mode (recommended for most games) -- Try reducing the FPS multiplier from 4x to 2x or 3x -- Consider using the experimental FPS limit feature for DirectX games - -## What it does - -The plugin: -- Installs the pinned lsfg-vk 2.0.0 x86_64 and x86 Vulkan layers from the official upstream build -- Configures the Vulkan layer in `~/.local/share/vulkan/implicit_layer.d/` -- Creates and migrates the v2 TOML configuration in `~/.config/lsfg-vk/conf.toml`, preserving a one-time v1 backup during upgrade -- Delegates Lossless Scaling DLL discovery to lsfg-vk's upstream runtime search -- Provides an easy-to-use interface to configure frame generation settings: - - **FPS Multiplier**: Use OFF/1x bypass or choose 2x, 3x, or 4x frame generation - - **Flow Scale**: Adjust motion estimation quality vs performance - - **Performance Mode**: Use lighter processing for better performance - - **FP16 Acceleration**: Use half-precision acceleration when supported -- **Present Mode**: Override FIFO/VSync behavior -- **Swapchain Image Count**: Preserve the application's swapchain image count -- **Hot-reloading**: Upstream reloads settings for the active profile; profile assignment itself applies on the next launch -- Easy uninstallation that removes all installed files when no longer needed - ## Credits - **[PancakeTAS](https://lsfg-vk.dev/)** for creating the lsfg-vk Vulkan compatibility layer -- cgit v1.2.3 From d1990a2b630f7161342a9c854bce0fcf7a967a8d Mon Sep 17 00:00:00 2001 From: xXJSONDeruloXx Date: Fri, 11 Sep 2026 13:11:42 -0400 Subject: readme updates and version bump --- README.md | 11 +++++------ 1 file changed, 5 insertions(+), 6 deletions(-) (limited to 'README.md') diff --git a/README.md b/README.md index 13918fd..31e2ad8 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,5 @@ # Decky LSFG-VK -> **Note:** > This is an **unofficial community plugin**. It is independently developed and **not officially supported** by the creators of Lossless Scaling or lsfg-vk. For support, please use the [decky-lsfg-vk Discord Channel](https://discord.gg/TwvHdVucC3). @@ -14,26 +13,26 @@

-## What is this? - -A Decky plugin that streamlines the installation of **lsfg-vk** ([Lossless Scaling Frame Generation Vulkan layer](https://lsfg-vk.dev/)) on Steam Deck, allowing you to use the Lossless Scaling frame generation features on Linux with a controller friendly UI in SteamOS, Bazzite, or any other Linux platform compatible with Decky Loader. +Decky LSFG-VK is a Decky plugin that streamlines the installation of **lsfg-vk** ([Lossless Scaling Frame Generation Vulkan layer](https://lsfg-vk.dev/)) on Steam Deck, allowing you to use the Lossless Scaling frame generation features on Linux with a controller friendly UI in SteamOS, Bazzite, or any other Linux platform compatible with Decky Loader. ## Installation 1. **Download the plugin** from the [releases tab](https://github.com/xXJSONDeruloXx/decky-lsfg-vk/releases) - - Download the "decky-lsfg-vk.zip" file to your Steam Deck + - Download the "Decky LSFG-VK.zip" file to your Steam Deck 2. **Install manually through Decky**: - In Game Mode, go to the settings cog in the top right of the Decky Loader tab - Enable "Developer Mode" - Go to "Developer" tab and select "Install Plugin from Zip" - - Select the downloaded "decky-lsfg-vk.zip" file + - Select the downloaded "Decky LSFG-VK.zip" file ## How to Use 1. **Purchase and install** [Lossless Scaling](https://store.steampowered.com/app/993090/Lossless_Scaling/) from Steam +2. **Switch Branch** In the Lossless Scaling Steam app, go to Properties > Game Versions & Betas > select "lsfg-vk" branch, and let Steam download the new version 2. **Open the plugin** from the Decky menu 3. **Click "Install lsfg-vk"** to automatically set up the lsfg-vk vulkan layer 4. **Configure settings** using the plugin's UI - select Default or a running/configured game and adjust the upstream lsfg-vk settings +5. **Configure Flatpak apps** in the Flatpak tab individually or with **Enable all** and **Remove all profiles** 6. **Launch your game** - frame generation activates when the game's Steam AppID matches an assigned upstream profile ### Core Settings -- cgit v1.2.3