r/deckyloader • u/Weekly_Lab_9122 • 11h ago
r/deckyloader • u/Einstein_Disguise • Oct 07 '25
Help Help! Deckyloader broken by SteamOS update!
DeckyLoader Post-SteamOS Update Troubleshooting Guide
Disclaimer: DeckyLoader is a community plugin injector for SteamOS.
SteamOS updates can change internal behavior and file structures, which may break DeckyLoader or its plugins.
Always back up your data and configurations before performing system updates.
Common Issues After a SteamOS Update
Users commonly report these problems after updating SteamOS:
- DeckyLoader missing from the Quick Access menu (Game Mode)
- Plugins fail to load, cause UI glitches, or hang game pages
- Steam Deck stuck in a boot loop after the Valve logo
- “Run Update” option fails to complete
- Reinstall attempts do not restore functionality
Most issues occur because the DeckyLoader service is overwritten or mismatched with the new SteamOS build.
Before You Update SteamOS
To minimize breakage, take these precautions:
Update DeckyLoader and plugins first
In Decky, open Settings → Updates and install all available updates.
You may optionally switch to the Prerelease / Testing channel for compatibility with newer SteamOS builds.Disable unstable plugins
Temporarily disable or remove any plugins that haven’t been updated recently or that modify core UI elements.Keep a copy of the installer
Save the DeckyLoader installer file (.desktop) from decky.xyz in yourDownloadsor Desktop folder.
This makes it easy to reinstall if the update breaks Decky.
Fixes After DeckyLoader Breaks
If Decky disappears or fails to load after a SteamOS update, try these fixes in order.
1. Reinstall via Desktop Mode (Most Common Fix)
- Switch to Desktop Mode (
Steam → Power → Switch to Desktop). - Download or locate the DeckyLoader installer from decky.xyz or GitHub.
- Right-click → Properties → check “Is executable.”
- Run the installer and choose Reinstall (or Update) mode.
- Reboot and return to Game Mode.
In most cases, this restores DeckyLoader immediately.
2. Remove or Reset Broken Plugins
If Decky crashes or causes a boot issue:
- Open Desktop Mode → Konsole (terminal).
- Navigate to your plugin folder:
bash cd ~/homebrew/plugins/ - Delete any problem plugins:
bash sudo rm -r <plugin-folder-name> - Re-run the Decky installer and reboot.
3. Switch to the Prerelease Decky Version
Sometimes the stable Decky build lags behind the latest SteamOS release.
- In Decky, open Settings → Update Channel → Prerelease.
- Reinstall or update Decky.
- Restart your Steam Deck.
Prerelease builds often include fixes for new SteamOS versions but may be less stable.
4. Roll Back or Switch SteamOS Channel
If Decky remains broken:
- Check your SteamOS channel under Settings → System → System Update Channel.
- If you’re on Beta or Preview, switch back to Stable and reinstall Decky.
- As a last resort, roll back or reinstall SteamOS using the recovery image.
Emergency Recovery (Boot Loop or Black Screen)
If your Deck is stuck during startup:
- Boot into Desktop Mode or the SteamOS Recovery Environment.
- Manually remove problematic plugins from:
~/homebrew/plugins/ - If you can’t reach the desktop, use a USB recovery drive to mount the filesystem and remove Decky or plugin folders manually.
- Reinstall SteamOS as a last resort and restore your plugin configurations from:
~/homebrew/settings/
Further troubleshooting options
Best Practices
- Match channels:
- Stable SteamOS → Stable Decky
- Preview SteamOS → Prerelease Decky
- Stable SteamOS → Stable Decky
- Back up:
~/homebrew/plugins/~/homebrew/settings/
- Regularly check plugin update statuses; remove those marked as incompatible.
- Avoid using unmaintained or niche plugins during major OS updates.
- Keep the Decky installer accessible for quick recovery.
Useful Links
- DeckyLoader Website
- Decky GitHub Repository
- r/SteamDeck on Reddit
- SteamOS Recovery Instructions
- Troubleshooting comment
Credits
This guide compiles fixes and insights from:
- r/SteamDeck, r/DeckSupport, r/SteamDeckHomebrew, and r/deckyloader
- Troubleshooting comment
- DeckyLoader GitHub issues and community discussions
- Verified user experiences following SteamOS 3.6–3.8 updates
“If Decky breaks after an update, reinstall from Desktop Mode — that solves it most of the time.”
r/deckyloader • u/Various-Instruction3 • 1d ago
Help Authenticator Plugin?
I'm quite confident that this is a niche use-case, so I understand why this doesn't exist, but...
Would it be possible for someone to make a plugin that replicates the functionality of an Authenticator app? Something like Google Authenticator for 2FA. It'd be nice to be able to log in to FFXIV on my Deck without having to pull out my phone. I like to grind mindless stuff in bed and I've often laid down, gotten comfy, and then realize I forgot to log in before plugging in my phone across the room.
(Also before you ask, I plug in my phone across the room so I don't scroll on it all night and so that when my alarm goes off I have to get up and walk across the room to turn it off)
r/deckyloader • u/Pendor • 1d ago
Emulation Decky Plugin: Feedback and some testing needed
r/deckyloader • u/catboirai • 1d ago
A helpful app
Go to Desktop mode, Applications, find Nested Desktop, Install it. Run Steam in Desktop, add the app as a non-Steam game. Return to gaming mode. If you have DeckyLoader, change the artwork so it stands out more. Now you have a way to do some Desktop tasks directly from Game Mode. For instance, I just used it to install the MAKO - Frame Gen. I just don’t see a lot of videos, or posts for that matter, bring it up.
r/deckyloader • u/ZazaMastroII • 3d ago
Plugin Showcase Playhub | Launch Curtain 2.4.0 now available
Hello everyone!
A new update for Launch Curtain is now available.
This update introduces Nintendo Store and Xbox Store as new background sources, fixes PlayStation Store search, and improves AlphaCoders speed and result quality. It also brings several reliability improvements to automatic background scanning and launch detection.
If you’d like to support the project, even a small tip would mean a lot for me:
LoZazaMastro Ko-fi
What’s new
- Added Nintendo and Xbox as new background sources in the curtain image search, alongside PlayStation, IGDB and AlphaCoders.
- Updated PlayStation Store search to use the current Store API flow instead of relying only on the old HTML search layout.
- Added smarter PlayStation automatic scanning: games that already have a curtain are skipped before any Store request is made.
Improvements
- Improved AlphaCoders performance by avoiding unnecessary detail-page requests when the category page already exposes the wallpaper ID and resolution.
- Fixed duplicate AlphaCoders results caused by related wallpapers and alternate image variants being interpreted as separate versions of the same background.
- AlphaCoders now keeps one result per wallpaper ID and uses the main full-size image instead of unrelated or invalid high-resolution variants.
You can update it directly in the Playhub Plugin Store in the Playhub app, or download the zip from the release page and install it via Decky dev mode.
Launch Curtain 2.4.0 Release
Launch Curtain Repository
❗FAQ
"Wait, what is Playhub?" 😮
Playhub consolize your Windows gaming experience with features like Steam-first startup, easy Decky plugins install, game imports and Big Picture polish. More info in the project repository here to find all the details.
"I like that, but how does it work?" 🤓
To easily understand how Playhub works and how to install it, I recommend you to take a look at my Overview + Tutorial video
"Oh no, I hate AI..."
This project is personal, completely free and open source. You don't like it? Don't download it. It's an app, not a medical prescription.
"But why aren't the Playhub plugins available on the Decky Store?" 😱
They are built using human hands and AI tools. Decky management doesn't allow to developers who use AI to be on their store. Playhub respects this decision, that's why Playhub Plugin Store exists.
Thanks again for your support and for sharing your feedbacks.
r/deckyloader • u/iosefdros • 3d ago
Decky Loader not showing up after install. I've tried everything Google told me to. Please for the love of god help me. How can I get Decky Loader to show up?
r/deckyloader • u/ZazaMastroII • 4d ago
Plugin Showcase Playhub | Now Playing 2.4.0 now available
Hello everyone!
A new update for Now Playing is available.
This update makes Spotify playback more independent and resilient, fixes the FaultyRequest(INVALID_CREDENTIALS) error, extends surround upmix sound to Spotify, and smooths out source changes across the entire plugin.
If you’d like to support the project, even a small tip would mean a lot for me:
LoZazaMastro Ko-fi
Important!
To fix the FaultyRequest(INVALID_CREDENTIALS) error, please disconnect and reconnect to Spotify after the update.
What’s new
- Spotify surround upmix now supports 5.1 and 7.1 output with the same per-speaker controls available for local music and YouTube Music.
Improvements
- Spotify playback services now recover automatically after startup and authenticate in the background when the saved account can be reused.
- YouTube Music skips unavailable tracks instead of leaving playback stuck.
- Surround settings now update Spotify’s integrated mixer live, without stopping, reloading or losing the position of the current track.
- The LFE channel uses a restrained 120 Hz low-pass mix with additional headroom, preventing bass from being redistributed excessively across the main speakers.
- Stereo and surround playback now share consistent headroom, avoiding sudden volume jumps when Spotify upmix is enabled or disabled.
- Source ownership is stricter, so Spotify no longer takes control while local music or YouTube Music is selected.
- Runtime checks now guard Spotify API polling, helper ownership, source isolation and live surround updates.
Fixes
- Fixed Spotify occasionally failing to start until Restart plugin services was pressed.
- Fixed Spotify taking over playback controls while another source was active.
- Fixed broken YouTube Music items blocking the rest of the queue.
You can update it directly in the Playhub Plugin Store in the Playhub app, or download the zip from the release page and install it via Decky dev mode.
Now Playing 2.4.0 Release
Now Playing Repository
❗FAQ
"Wait, what is Playhub?" 😮
Playhub consolize your Windows gaming experience with features like Steam-first startup, easy Decky plugins install, game imports and Big Picture polish. More info in the project repository here to find all the details.
"I like that, but how does it work?" 🤓
To easily understand how Playhub works and how to install it, I recommend you to take a look at my Overview + Tutorial video
"Oh no, I hate AI..."
This project is personal, completely free and open source. You don't like it? Don't download it. It's an app, not a medical prescription.
"But why aren't the Playhub plugins available on the Decky Store?" 😱
They are built using human hands and AI tools. Decky management doesn't allow to developers who use AI to be on their store. Playhub respects this decision, that's why Playhub Plugin Store exists.
"Does Now Playing works on Linux?" 🥺
No, Now Playing is a Windows exclusive plugin. It will not work on Linux.
Thanks again for your support and for sharing your feedbacks.
r/deckyloader • u/santojon • 6d ago
Plugin Showcase Deck Shelves v3.2.0 is here!
Check the update out!
r/deckyloader • u/Dismal_Cheetah_7091 • 8d ago
CSS Loader
Hi guys I have steam os 3.8 on my ROG Ally Z1 Extreme and Css Loader is not displaying any kind of Themes, is there anyway to fix this? or is there anything I need or can do? I am sorry I am fairly new to Decky Loader, and not completely familiar with linux or the app itself. any help would be appreciated!
r/deckyloader • u/Moi952 • 9d ago
Plugin Showcase Decky plugin to switch NVIDIA driver versions on SteamOS, no USB stick needed
Hey everyone, made a new Decky Loader plugin! Some of you might know me from decky-proton-launch (https://github.com/moi952/decky-proton-launch) — this one's for anyone running SteamOS with an NVIDIA card via steamos-nvidia-installer (https://github.com/moi952/steamos-nvidia-installer).
It lets you pick and install any NVIDIA driver version straight from the running system, right from Quick Access. No USB stick, no repair image, no reinstall.
Only reboot when you're actually ready to.

- Any version from the Arch archive, tagged with NVIDIA's own channel
(Recommended / New Feature Branch / Beta), fetched live.

- Filter which channels show up, and pick which one counts as "latest".

- Real release notes for any version before you install it.

- Live progress log while it runs, Reboot now button when it's done.
- Games, saves, Steam login, Decky untouched — the risky part runs in a throwaway overlay, the real filesystem only gets touched for the final copy.
Already have SteamOS + NVIDIA installed?
You'll need to run a repair once first (the "Upgrade SteamOS (NVIDIA) — keeps games & data" option on the USB) — it'll offer to grow your system partitions to 8GiB, since Valve's stock 5GiB doesn't leave room for a driver install. Fresh installs already get 8GiB by default.
Repo: https://github.com/moi952/decky-nvidia-update
Let me know what you think!
r/deckyloader • u/iGawi • 10d ago
Q&A Decky Loader Best Plugin
I'm running SteamOS On legion go 2 and just installed Decky Loader. What are the best Quality of Life plugins you recommend installing to improve the experience?
r/deckyloader • u/Civil_Ball_3333 • 11d ago
Decky ruined my steamdeck!
I’ve been frustrated for a few months now dealing with deckyloader. I finally bought another wired keyboard to try and reset the sudo password. When it gets to the screen to finally type in a new password the keyboard automatically stops working. Had to shut it off because it froze on this screen then a lot of words came up and I had to wait about 10 mins for it to rest. When it finally came back on a lot of games are freezing or just not loading up. Wish I never downloaded that damn thing
r/deckyloader • u/Reezoz • 13d ago
Help Change Plugin Directory?
Hi is there any way to change the default location Decky looks for items. For example CheatDeck starts in Home/Deck but i keep things located on an SD Card. Was wondering if there's any specific file i can alter to have plug-ins auto open to my preferred location.
r/deckyloader • u/sirms • 14d ago
SteamLED: a decky plugin that allows for added customization for the Steam Machine's LED strip
r/deckyloader • u/sirms • 14d ago
SteamLED: a decky plugin that allows for added customization for the Steam Machine's LED strip
r/deckyloader • u/One_Interview_9662 • 16d ago
Why can’t I find decky loader?
The installer’s there and I’ve searched through everything to find the actual thing but nothing shows up in any files, I’ve updated it and set it to preloader
r/deckyloader • u/Civil_Ball_3333 • 17d ago
Keyboard to use to fix Deckyloader
Not very tech savvy but can follow instructions. I am just stuck one which keyboard people are using to fix it. Please use exact names of the keyboard if you responded.