SteamDeckHomebrew/decky-loader
Decky Loader
Decky Loader is an open-source plugin system that extends the Steam Deck's gaming mode interface with community-made plugins and customizations. It functions as a plugin loader that injects JavaScript plugins into the Steam Deck's web-based interface at runtime, enabling real-time appearance and behavior changes without leaving the active gaming session.
The system combines a CORS-bypassing proxy layer that intercepts and modifies HTTP fetch requests from plugins to remove same-origin restrictions, with a Python-to-TypeScript bridge that exposes Python functions as callable TypeScript methods through bidirectional IPC. This allows plugins to make fetch requests to any domain and run Python functions directly from TypeScript React code for extended backend logic. A runtime plugin lifecycle manager handles installation, updates, uninstallation, and reloading through a dedicated menu system that operates entirely within the gaming session.
The platform includes an in-place plugin store browser that embeds a full web view within the Steam Deck's overlay, allowing users to browse, install, and manage plugins without leaving the game interface. Through the UI overlay injection system, users can modify the Steam Deck's interface styling, screen saturation, system sounds, and other appearance settings via community plugins.
Features
- Gaming Interface Plugins - Installs, updates, and removes plugins on a Steam Deck through an in-game interface without leaving gaming mode.
- Plugin Lifecycle Management - Manages plugin installation, updates, uninstallation, and reloading entirely within the gaming session.
- Plugin Loaders - An open-source plugin loader that extends the Steam Deck's gaming mode interface with community plugins.
- Plugin Managers - Updates, uninstalls, and reloads plugins through a dedicated menu without leaving the game interface.
- Cross-Language Function Bridges - Enables plugins to call Python functions directly from TypeScript React code for backend logic.
- CORS Proxies - Ships a local proxy that intercepts fetch requests to bypass browser same-origin restrictions for plugins.
- Cross-Origin Networking - Enables plugins to make fetch requests to any domain without browser same-origin blocking.
- Python-JavaScript Bridges - Provides a bidirectional IPC bridge that exposes Python functions as callable TypeScript methods.
- Same-Origin Policy Relaxation - Allows plugins to make fetch requests to any domain without browser same-origin policy blocking.
- Plugin Installation Utilities - Opens a built-in browser within the Steam Deck overlay to discover and install plugins with one click.
- In-Game Plugin Browsers - Opens a built-in browser within the Steam Deck overlay to discover and install plugins with one click.
- Hook-Based Plugin Systems - Injects JavaScript plugins into the Steam Deck's web-based UI at runtime via hook-based injection.
- Python Integration - Allows calling Python functions directly from TypeScript React code for extended backend logic.
- Dynamic UI Injection - Injects custom CSS and JavaScript into the Steam Deck's web-based UI for real-time appearance changes.
- In-Game Plugin Browsers - Embeds a full web browser within the Steam Deck overlay for browsing and installing plugins in-game.
- Interface Appearance Customizations - Modifies interface styling, screen saturation, and system sounds through community plugins.
- Gaming Utilities - Plugin loader for customizing handheld gaming devices.
