Skip to content

SteamDeckHomebrew/decky-loader

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Plugin Loader Chat

steamuserimages-a akamaihd

Keep an eye on the Wiki for more information about Plugin Loader, documentation + tools for plugin development and more.

Installation

  1. Go into the Steam Deck Settings
  2. Under System -> System Settings toggle Enable Developer Mode
  3. Scroll the sidebar all the way down and click on Developer
  4. Under Miscellaneous, enable CEF Remote Debugging
  5. Click on the STEAM button and select Power -> Switch to Desktop
  6. Make sure you have a password set with the "passwd" command in terminal to install it (YouTube Guide).
  7. Open a terminal and paste the following command into it:
    • For users:
      • curl -L https://github.com/SteamDeckHomebrew/PluginLoader/raw/legacy/dist/install_release.sh | sh
    • For the latest pre-release,
      • curl -L https://github.com/SteamDeckHomebrew/PluginLoader/raw/main/dist/install_prerelease.sh | sh
    • For testers/plugin developers:
      • curl -L https://github.com/SteamDeckHomebrew/PluginLoader/raw/main/dist/install_prerelease.sh | sh
      • Wiki Link
  8. Done! Reboot back into Gaming mode and enjoy your plugins!

Install/Uninstall Plugins

  • Using the shopping bag button in the top right corner, you can go to the offical "Plugin Store"
  • Simply copy the plugin's folder into ~/homebrew/plugins
  • Use the settings menu to uninstall plugins, this will not remove any files made in different directories by plugins.

Uninstall

  • Open a terminal and paste the following command into it:
    • curl -L https://github.com/SteamDeckHomebrew/PluginLoader/raw/main/dist/uninstall.sh | sh

Features

  • Clean injecting and loading of one or more plugins
  • Persistent. It doesn't need to be reinstalled after every system update
  • Allows 2-way communication between the plugins and the loader.
  • Allows plugins to define python functions and run them from javascript.
  • Allows plugins to make fetch calls, bypassing cors completely.

Developing plugins

  • There is no complete plugin development documentation yet. However a good starting point is the Plugin Template repository.
  • Please consult the Wiki for installing development versions of PluginLoader.
    • This is also useful for Plugin Developers looking to target new but unreleased versions of PluginLoader.
  • Here's how to get the Steam Deck UI on your enviroment of choice.
    • (The video shows Windows usage but unless you're using Arch WSL/cygwin this script is unsupported on Windows.)

Source control and deploying plugins are left to each respective contributor for the cloned repos in order to keep depedencies up to date.

Credit

The original idea for the concept is based on the work of marios8543's steamdeck-ui-inject project.