eugeniosegala/decky-lsfg-vk-experimental v0.13.0-experimental.25

Decky LSFG-VK Experimental 0.13.0-experimental.25

on GitHub

Optional coexistence: If you want to keep the original/public Decky LSFG-VK plugin installed, you can. Both plugins can remain installed and enabled. For native Steam/Proton games, choose exactly one launch wrapper: public ~/lsfg %command% or experimental ~/.local/bin/lsfg-vk-experimental %command%; never combine them. Flatpak apps, including Heroic, are selected through Flatpak setup instead.

What’s new since 0.13.0-experimental.24

• Engine update: Bundles checksum-verified lsfg-vk 2.0.0-dev28-experimental.25. Complete the required in-plugin engine-update step after installing the ZIP.
• HDR foundation — in progress: The bundled engine contains HDR10/PQ and linear-scRGB colour-pipeline groundwork, Gamescope feedback, packed HDR10 boundary transport, and safe passthrough. HDR activation and frame generation are not exposed by this Decky release while cross-game presentation, colour, and performance validation continues.
• 64-bit and 32-bit Vulkan support: Installs architecture-matched host and Flatpak layers. Vulkan selects the correct layer for each game process, so genuine 32-bit Vulkan games no longer need the old WoW64 option; existing wrappers are migrated away from stale PROTON_USE_WOW64 exports.
• Safer live reconfiguration and stall recovery: Transient partial configuration writes are retried. Frame Generation and Adaptive Target, Maximum Multiplier, and Smooth Cadence can update in place when resources permit; resource-shape and model settings are deferred, so restart the game to guarantee those changes. A transient backend stall keeps native presentation active and warms temporal history before generation resumes.
• Private layer discovery migration: The .25 wrapper regenerates older launchers and retains the uniquely named experimental layer on the proven SDR path. Heroic Flatpak launches explicitly retain Gamescope WSI ahead of the experimental layer; Flatpak cleanup recognises both historical isolated and additive layouts.
• Diagnostic log presets: Installs ~/.local/bin/lsfg-vk-experimental-diagnostics with focused HDR, Adaptive, recovery, performance, lifecycle, startup, layer, and error filters.
• Local engine packaging: Maintainers can build a Decky ZIP directly from a sibling lsfg-vk checkout. The generated ZIP records the exact commit, dirty state, filenames, and checksums without changing the tracked public release pin.
• Documentation: Expands HDR, dual-architecture, diagnostics, Flatpak migration, local packaging, and community-coverage guidance.

🎮 In-game considerations

Every game, renderer, and display setup behaves differently. Compare Fixed and Adaptive Frame Generation one setting at a time. For most games, fullscreen is the best starting point for performance and frame pacing. Keep the configuration that feels best for that game.

See the Configuration guide and Troubleshooting guide for the full behaviour and per-game controls.

First-time Heroic setup: Read the Heroic and other Flatpak applications guide in the README.

Installation

New to Decky or installing this plugin for the first time? See the full Install and use guide for Decky Loader setup and prerequisites.

1. Download Decky.LSFG-VK.Experimental-0.13.0-experimental.25.zip below.
2. On the Steam OS, open Decky Loader's settings and enable Developer Mode.
3. Choose Developer > Install Plugin from Zip, then select the downloaded ZIP.
4. In the plugin, select Install Experimental LSFG-VK (developer build). For native Steam/Proton games, add ~/.local/bin/lsfg-vk-experimental %command% to the game’s Steam launch options.

Updating an existing experimental installation

1. Quit any game currently using ~/.local/bin/lsfg-vk-experimental.
2. Uninstall this experimental plugin from Decky, then download the newer ZIP from this fork’s releases.
3. In Game Mode, open Decky Loader’s settings, choose Developer > Install Plugin from Zip, then select the newer ZIP.
4. Restart your Steam Deck or Steam Machine.
5. ⚠️ Required: Open this plugin and select Install Experimental LSFG-VK (developer build) to install the version bundled in the new ZIP.
6. If you use Heroic, select Flatpak Setup, then select Update for Heroic’s matching runtime extension (usually 25.08). This replaces its Flatpak layer with the engine bundled in the new ZIP; Heroic preparation and per-game Wrapper commands remain unchanged.

Experimental profiles and Steam launch options are retained. The private native engine and launcher are re-created in step 5; shared Flatpak extensions are retained, then refreshed in step 6. The public/original plugin may remain installed, but use exactly one plugin wrapper per game.

Known limitations of lsfg-vk 2.0.0-dev28-experimental.25

• HDR is in progress and unavailable in this Decky release: The engine foundation is included, but the plugin locks HDR exposure off and does not provide a per-game opt-in. In-game HDR controls may be unavailable by design. A later release can unlock the path after activation, presentation, colour, and performance are validated across games.
• Adaptive targets are not hard frame limiters: Adaptive varies generated-frame count toward an average target. It cannot reduce a native framerate already above the target, exceed the configured multiplier/GPU/compositor capacity, or guarantee an unreachable output rate.
• Image-quality and latency trade-offs remain game-dependent: Higher multipliers and lower real-frame rates can increase ghosting and input latency. Smooth Cadence may improve motion consistency while reducing responsiveness.
• Layer coexistence: The original and experimental Decky plugins may remain installed, but use exactly one wrapper per game. The experimental wrapper selects its uniquely named private layer and disables both public LSFG identities for that process. Its controlled SDR discovery keeps Gamescope WSI available for Heroic launches.

Before you play

• This is experimental: test each game before relying on it.
• Confirm the detected Lossless.dll path before launching. Leaving it blank permits upstream discovery.

Engine payload

• Bundles checksum-verified lsfg-vk-2.0.0-dev28-experimental.25-linux.tar.xz.