SoVis Games
EN / 中
Steam Deck guide intermediate

Steam Deck: Decky Loader — Install, Must-Have Plugins, and Plugin Workflow (2026)

How to install Decky Loader in desktop mode, the must-have plugins (CSS Loader, PowerTools, SteamGridDB, Decky Recorder, Animation Changer), the plugin marketplace, and how to keep Decky and plugins auto-updated.

· 10 min read · Updated Aug 1 · SoVis Games Editorial Team

Decky Loader is the plugin framework that turns Steam Deck’s Quick Access menu into a swappable, theme-able, tinker-friendly panel — without ever leaving Game Mode. This guide is the deep dive that the first-time setup guide only mentions in passing.

If you only install one piece of customization software on your Deck, install Decky. The plugin ecosystem plugs into the gap SteamOS leaves open: per-game performance tuning, custom library artwork, themes, recording, and animation swaps.

What Decky Loader is, and why you want it

Decky is a plugin loader (github.com/SteamDeckHomebrew/decky-loader) that injects into Steam’s Quick Access Menu (•••) in Game Mode. Once installed, the QAM grows a small plugin icon at the bottom — clicking it opens the Decky panel, where you can install plugins with one click, browse a marketplace, and configure Decky itself.

Decky runs as a user-space service — files live in /home/deck/homebrew/. SteamOS system updates don’t touch that folder, so Decky survives most updates automatically. When a Steam update does break Decky, the fix is usually “restart Steam” or “re-run the install one-liner”.

The headline benefit: tweak the Deck without ever leaving Game Mode.

1. Prerequisites: desktop mode + sudo password

  1. Switch to Desktop Mode: Steam → Power → Switch to Desktop. (Or hold the power button long-press → “Switch to Desktop”.)
  2. Open Konsole — the terminal app. Look for the black icon in the taskbar at the bottom of the desktop.
  3. Set a sudo password: the deck user ships with no password. Run passwd and type a new password twice. Without this, none of the Desktop Mode commands below will work.
Set a sudo password first

The Deck ships without a sudo password. Several Decky plugins (PowerTools in particular) invoke sudo for TDP control. If you skip passwd, those plugins install but their actions silently fail.

2. Installing Decky Loader

The official one-liner (current as of 2026-08):

curl -L https://github.com/SteamDeckHomebrew/decky-loader/releases/latest/download/install_release.sh | sh

The installer:

  • Pulls the latest Decky release (~5 MB).
  • Drops files into /home/deck/homebrew/.
  • Registers a systemd user service that starts on Steam launch.
  • Enables Decky in Steam’s Quick Access.

That’s it — return to Game Mode and the Decky icon is at the bottom of the QAM.

2.1 Verifying the install

Switch back to Game Mode: Steam → Power → Switch to Gaming Mode. Once in Game Mode, press the ••• button to open the Quick Access Menu. Scroll to the bottom — there should be a small Decky icon (a stylized “D” or rocket, depending on theme). Click it to open the Decky panel.

If you don’t see the icon: Restart Steam. Steam → Power → Restart. Decky is a user-space service that initializes as Steam starts; a fresh start almost always fixes the missing-icon symptom.

Restarting Steam is the universal Decky fix

When in doubt — Decky icon missing, plugin not loading, QAM acting weird — restart Steam first. It fixes most transient Decky issues in under 10 seconds.

3. The Decky plugin marketplace

Open the Decky panel in QAM → Store tab.

The store is browser-style, sorted by category:

  • Utilities — PlayTime, MagicPods, etc.
  • Themes — CSS Loader community themes.
  • Performance — PowerTools.
  • Recording — Decky Recorder.
  • Library — SteamGridDB, Library Auto-Filter.
  • Appearance — Animation Changer.

Each plugin has an Install button. Click it; Decky pulls the plugin (~1 MB) and registers it in the panel.

3.1 Update and uninstall

Every installed plugin in the Decky panel has its own settings page with Update (if newer available) and Uninstall buttons. One click each; no terminal required.

3.2 Pre-release and “power-user” plugins

Some plugins aren’t in the official store yet — they’re on GitHub with a “Pre-Release” or “Beta” tag. To install those: open the plugin’s settings in Decky → “Developer” tab → enable “Allow installation from arbitrary URLs” (this fires once, per session). Then drop the GitHub URL into the install dialog.

Use with caution — pre-release plugins are less tested.

4. The must-have plugin stack (install these five first)

4.1 CSS Loader — themes

CSS Loader skins the entire SteamUI in Game Mode: Library, QAM, Store, Overlay. Install it, then browse community themes from the CSS Loader tab in Decky. Themes are pure CSS overlays — installing a new theme takes effect without restarting Steam.

Recommended theme sources: the DeckyThemes subreddit and the decky.xyz verified list.

4.2 PowerTools — TDP + GPU controls

PowerTools adds per-game controls directly in the QAM:

  • TDP limit (W).
  • GPU clock (MHz).
  • SMT (Simultaneous Multithreading) toggle — usually off for battery savings.
  • FSR / resolution override.
  • Per-game auto-profiles.

PowerTools complements the built-in Performance tab — the built-in tab handles per-session overrides, PowerTools handles per-game auto-profiles. With per-game Proton overrides plus PowerTools per-game profiles, you’ve got the full per-game tuning stack.

4.3 SteamGridDB — custom library artwork

SteamGridDB downloads custom artwork (caps, heroes, icons, logos) from the community SteamGridDB service. One button per game in the library. Replaces the manual “find art on Google → drag into Steam” workflow.

4.4 Decky Recorder — game capture

Decky Recorder adds a one-button record/stream toggle to the QAM. Records to MP4 locally on the Deck’s SSD; optional RTMP streaming to Twitch, YouTube, or a custom server. Output is good enough for typical gaming clips without filling your SSD with raw recordings.

4.5 Animation Changer — boot/shutdown/suspend loops

Animation Changer swaps Steam’s built-in boot, shutdown, and suspend animations. The community library has hundreds — Pokémon GameCube boot, Game Boy Advance “Nintendo” splash, custom loops. Pure cosmetic, but iconic.

5. Power-user plugin picks

Once the must-haves are settled:

PluginPrimary use case
PlayTimeTotal playtime tracker visible in QAM, per-game
AutoSuspend / SuspendifyAuto-suspend after configurable idle time (battery saver)
ProconLapseAuto-capture screenshots at user-defined intervals during play
MagicPodsPer-game trigger / stick mapping without leaving Game Mode
SteamDeckGyroDSUExposes the Deck’s gyro as a DSU server so external emulators can read it

6. Writing your own CSS Loader theme (skippable)

If you want to fork an existing theme or write one from scratch, the structure is:

~/homebrew/themes/MyTheme/
├── manifest.json   # metadata: name, author, version
├── main.css        # overrides — typically hundreds of selectors
└── /images/        # custom icons, backgrounds

Themes are pure CSS — no compilation, no build step. Fork a community theme from GitHub, edit main.css, drop into ~/homebrew/themes/, enable in CSS Loader. Refresh Steam and the changes appear.

Skip this section if “install community themes” was enough for you — themes are nice-to-have, not required.

7. Automated Decky and plugin updates

7.1 How Decky Loader auto-updates

Decky panel → Settings → Update Decky Loader. One click; Steam restart picks up the new build. Major Decky releases (1.x → 2.x) sometimes require the full re-install one-liner, but those are infrequent (one per year or less).

7.2 How plugins auto-update

By default, plugins update on Decky panel startup. Configurable per plugin. To force-update all: Decky panel → Settings → Update all plugins.

7.3 Rolling back a bad plugin

A plugin update can break a game (CSS Loader breaking the QAM, PowerTools mis-setting TDP, etc.). Roll back per plugin: plugin settings → Versions tab → pick a previous version → restart Steam.

This per-plugin versioning is the key safety net — a bad plugin update doesn’t take down your Deck.

8. Troubleshooting

8.1 Decky icon missing after Steam update

Most common cause: a Steam update has temporarily broken Decky. Steps:

  1. Restart Steam first. (Steam → Power → Restart.)
  2. If still missing, re-run the install one-liner from §2.
  3. If still missing, check journalctl --user -u decky-loader in Konsole for clues.

Valve ships Steam updates that occasionally take 24–48 hours before Decky patches a fix. If a Steam update just landed and Decky is broken, waiting a day then re-running the install one-liner usually fixes it.

8.2 A plugin crashes the QAM

Open the Decky panel → Settings → disable the suspect plugin → Restart Steam. Don’t reinstall Decky — the plugin is the problem, not Decky itself.

8.3 CSS Loader theme causes blank UI

CSS Loader → disable the broken theme → Restart Steam. Themes are pure CSS; rolling back doesn’t touch your library or saves.

8.4 SteamOS update broke Decky entirely

Major SteamOS releases (3.5 → 3.6 → 3.7) sometimes change system files Decky relies on. Wait 24–48 hours for the upstream Decky patch, then re-run the install one-liner from §2.

9. Safety and security

Plugins run as your user account. They can read and modify everything you can — files, environment variables, network. Stick to plugins from:

  • The official Decky store (verified by Decky maintainers).
  • Well-known GitHub repos: SteamDeckHomebrew/* is the official org; a handful of community repos are also reputable.

Avoid plugins that:

  • Ask for your Steam credentials.
  • Ask for your sudo password at install time.
  • Claim to “unlock paid Steam features” or generate free games. These are scams.
Plugins run as your user

A malicious plugin can read everything you can. The official store is curated; off-store plugins are not. When in doubt, check the plugin's GitHub repo history and r/SteamDeck threads before installing.

10. FAQ

Does Decky work on LCD Steam Deck too?

Yes. Same Decky build runs on LCD and OLED. PowerTools affects both similarly.

Will SteamOS updates remove Decky?

No. Decky lives in /home/deck/homebrew/ — the user home directory. SteamOS updates only touch the system partition (/). The only exception is if a Steam update temporarily breaks Decky before it gets re-patched — that’s a re-install, not a removal.

Can Decky void my warranty?

Valve does not endorse Decky but does not ban it. The Steam Deck is designed to be user-modifiable; warranty is not voided by software tweaks. Physical damage from disassembling the Deck is another matter — see SSD upgrade §10 for that side.

What’s next