repository·main·Indexed 43 days ago
https://github.com/frogthefrog/moondeckAn automation plugin and companion app (MoonDeck Buddy) that enables seamless streaming of Steam games via Moonlight without needing to manually add them to Sunshine first, providing an experience similar to GeForce GameStream or Steam Remote Play. Version 1.12.2.
MoonDeck is an automation plugin designed to simplify launching Steam games via the Moonlight client for streaming. It allows you to play Steam games through Moonlight without manually adding them to Sunshine first, providing an experience similar to GeForce GameStream or Steam Remote Play.
Requirement: MoonDeck requires a lightweight companion application called MoonDeck Buddy to be installed on the host PC.
pyglet.experimental package contains modules provided for testing and feedback purposes. Because these modules are experimental, they are subject to being broken, refactored, or removed from the package without prior notice. Use them only if you are prepared for potential breaking changes.To build and deploy the plugin package, follow these steps:
.env.example to .env and update any relevant settings.pnpm:pnpm run setup
pnpm run build:plugin
pnpm run deployAlternatively, you can use VSCode tasks by pressing Ctrl+Shift+P (or Cmd+Shift+P on macOS), selecting Tasks: Run Task, and choosing the desired task.
pnpm run setup && pnpm run build:plugin && pnpm run deployMoonDeck is a Decky plugin that uses definePlugin to register its lifecycle and UI components. The plugin initializes several managers (shortcuts, settings, connectivity, and launcher) and a RouteManager once Steam services are ready. It handles user login state changes by triggering an initialization callback that waits for non-Steam app details to be available before proceeding.
import { definePlugin } from "@decky/api";
import { QuickSettingsView } from "./components/quicksettingsview/quicksettingsview";
import { TitleView } from "./components/titleview";
export default definePlugin(() => {
return {
name: "MoonDeck",
icon: <MoonDeckMain />,
content: <QuickSettingsView />,
onDismount() {
// Cleanup logic
},
alwaysRender: true,
titleView: <TitleView />
};
});MoonDeck uses a flat configuration format via eslint.config.mjs. The configuration integrates recommended rules from @eslint/js, type-checked rules from typescript-eslint, and stylistic rules from @stylistic/eslint-plugin.
Key configuration aspects include:
tsconfig.json for parser options to enable type-aware linting.1tbs brace style, double quotes, no trailing commas, and mandatory semicolons.@typescript-eslint/no-unused-vars rule is strictly enforced but allows ignoring variables that start with an underscore (_).sort-imports with specific member syntax orders.import { defineConfig } from "eslint/config";
import eslint from "@eslint/js";
import stylistic from "@stylistic/eslint-plugin";
import tseslint from "typescript-eslint";
export default defineConfig(
eslint.configs.recommended,
tseslint.configs.recommendedTypeChecked,
stylistic.configs.customize({
arrowParens: true,
braceStyle: "1tbs",
commaDangle: "never",
quotes: "double",
semi: true
}),
// ... additional rules and file overrides
);Global flags can be used with any command to modify logging or configuration behavior.
--verbose: Enables verbose logging.--log-file <path>: Specifies a path to an optional log file.--config-file <path>: Specifies the path to the configuration file (defaults to config.json).moondeck --verbose --config-file my_config.json app statusMoonDeck stores its configuration and logs in the following locations:
| Data Type | Path |
|---|---|
| Settings | /home/$USER/.config/moondeck/settings.json |
| Backend logs | /tmp/moondeck.log |
| Runner logs | /tmp/moondeck-runner.log |
| Moonlight logs | /tmp/moondeck-runner-moonlight.log |
| Frontend logs | Written to the web console |
Use these methods to interact with GameStream hosts on the network.
scan_for_hosts(timeout): Scans the network for available hosts. Returns a list of hosts.find_host(host_id, timeout): Locates a specific host by its ID.get_server_info(address, port, timeout): Retrieves detailed information about a specific server at the given address and port.await plugin.scan_for_hosts(timeout=5.0)
await plugin.find_host(host_id="some_id", timeout=5.0)
await plugin.get_server_info(address="192.168.1.10", port=47984, timeout=5.0)The moondecklaunchbutton package provides the UI component for the MoonDeck launch button. You can import all exported members (including the main component) from the package entrypoint.
import { MoonDeckLaunchButton } from './moondecklaunchbutton';HostSelectionView component is the primary entrypoint for providing a user interface that allows users to select a host within the MoonDeck application. It is exported from the src/components/hostselectionview module.nonsteamappsview module provides UI components for viewing non-Steam applications. You can import all exported members from the entry point of this module.The StatusIndicatorsView component is the primary entry point for displaying status indicators within the MoonDeck UI. It is exported from the src/components/statusindicatorsview module. To use it, import the exported members from the package entry point.
import { StatusIndicatorsView } from './components/statusindicatorsview';
// Usage depends on the specific props and implementation details
// defined in the underlying module.