Repolode
Submit
SteamDeckHomebrew

SteamDeckHomebrew/decky-loader

A plugin loader that lets homebrew plugins run on the Steam Deck's Gaming Mode interface.

View on GitHubWebsite
Stars
7,396
Forks
278
Open issues
117
Last commit
2 days ago

What is it?

Decky Loader is a homebrew plugin launcher for the Steam Deck. It injects and loads multiple plugins into the Steam Deck UI, so third-party tools can stylize menus, change system sounds, adjust screen saturation, or tweak system settings.

Plugins can communicate two ways with the loader, and Python functions can be called from TypeScript React front ends. Plugins can also make fetch calls that bypass CORS. Installation runs from a desktop installer, and installed plugins persist across reboots and SteamOS updates.

The project provides a plugin browser inside the Decky menu, where users install, update, reload, or remove plugins. Plugin developers can start from the official plugin template repository.

Key features

  • 01Injects and loads multiple plugins into the Steam Deck UI.
  • 02Keeps plugins installed across system updates and reboots.
  • 03Enables two-way communication between plugins and the loader.
  • 04Lets TypeScript React front ends call Python functions.
  • 05Allows plugin fetch requests that bypass CORS.

Use cases

  • Customizing the Steam Deck menu appearance with CSS plugins.
  • Changing system sounds or screen color settings on the Steam Deck.
  • Adjusting power or system settings that the stock UI does not expose.
  • Developing and testing Steam Deck plugins with a Python and React stack.

Quick start

  1. 1

    Switch the Steam Deck to Desktop mode via the Power menu

  2. 2

    Download the installer file from the latest release

  3. 3

    Run the installer on the desktop, or use the fast install command in Konsole

    Install with the official instructions in the README
  4. 4

    Open the Return to Gaming Mode shortcut on the desktop

Things to know

  • Designed specifically for the Steam Deck's Gaming Mode interface, so it is not useful on other devices.
  • Known conflicts exist with Syncthing and software using ports 1337 or 8080.
  • Plugins may disappear after SteamOS updates and may need reinstalling.

Topics

#steam-deck#plugins#steamos#homebrew#python#typescript#steam#steamdeck

FAQ

What is decky-loader?
A plugin loader that lets homebrew plugins run on the Steam Deck's Gaming Mode interface. Decky Loader is a homebrew plugin launcher for the Steam Deck. It injects and loads multiple plugins into the Steam Deck UI, so third-party tools can stylize menus, change system sounds, adjust screen saturation, or tweak system settings.
Is decky-loader free to use? What license does it have?
decky-loader is open source under the GPL-2.0 license. Check the license terms before using it in commercial products.
Is decky-loader still maintained?
Actively maintained. The last commit to decky-loader was on Oct 18, 2026.
What can I use decky-loader for?
Customizing the Steam Deck menu appearance with CSS plugins. Changing system sounds or screen color settings on the Steam Deck. Adjusting power or system settings that the stock UI does not expose. Developing and testing Steam Deck plugins with a Python and React stack.
How do I install decky-loader?
Switch the Steam Deck to Desktop mode via the Power menu Download the installer file from the latest release Run the installer on the desktop, or use the fast install command in Konsole Open the Return to Gaming Mode shortcut on the desktop
Where can I get decky-loader?
The source code and installation instructions are on GitHub: https://github.com/SteamDeckHomebrew/decky-loader

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects