Skip to content

Add Working and maintained fork of SDH-GameThemeMusic - DeckyOstMusic#1065

Open
Allive wants to merge 3 commits into
SteamDeckHomebrew:mainfrom
Allive:main
Open

Add Working and maintained fork of SDH-GameThemeMusic - DeckyOstMusic#1065
Allive wants to merge 3 commits into
SteamDeckHomebrew:mainfrom
Allive:main

Conversation

@Allive

@Allive Allive commented Jun 16, 2026

Copy link
Copy Markdown

Add DeckyOstMusic to Plugin Store

This release is returning back main functionality of original OMGDuke/SDH-GameThemeMusic with providing the new ones:

  • Music on the home screen. The theme of the game you have highlighted in the library home/carousel now starts playing, not only on the game's page. The track follows your selection as you browse, and is debounced so scrolling quickly through the library doesn't trigger music for every game you pass — it only plays once you settle on a game.
  • Seamless playback across navigation. Going from the home screen into a game's page and back no longer restarts the track: the same game's theme continues through a shared audio player.
  • Background prefetch / downloads. On startup the plugin can download themes for your recently played and recently added games so they're cached locally and play instantly (configurable counts in settings). Downloads require yt-dlp.
  • Auto-download for the default pick. Previously only a manually chosen track was downloaded; now the auto-selected first search result is downloaded too (when downloads are enabled), so leaving the default choice still caches a local copy.
  • Restored compatibility. Fixes for current Steam client builds so the plugin loads and the context-menu / app-page integration keeps working.

Task Checklist

Developer

  • I am the original author or an authorized maintainer of this plugin.
  • I have abided by the licenses of the libraries I am utilizing, including attaching license notices where appropriate.
  • Generative AI was NOT used to write a majority of the code I am submitting.

Plugin

  • I have verified that my plugin works properly on the Stable and Beta update channels of SteamOS.
  • I have verified my plugin is unique or provides more/alternative functionality to a plugin already on the store.

Backend

  • No: I am using a custom backend other than Python.
  • No: I am using a tool or software from a 3rd party FOSS project that does not have it's dependencies statically linked.
  • Yes: I am using a custom binary that has all of it's dependencies statically linked.

Community

  • I have tested and left feedback on two other pull requests for new or updating plugins.
  • I have commented links to my testing report in this PR.

Testing

  • Tested by a third party on SteamOS Stable or Beta update channel.

@Allive Allive requested a review from a team as a code owner June 16, 2026 08:57
@github-actions github-actions Bot added the plugin-addition Adding a plugin to the Plugin Store label Jun 16, 2026
@github-actions

Copy link
Copy Markdown

Issues Found

No issues with your PR description were found.

Next Steps

  1. If we found any issues above, please edit your pull request description to resolve them and leave a comment saying you've done so.
  2. For the quickest review, please see the Community section of the pull request template for how you can help other developers.
  3. Once your description is correct, a maintainer will review your pull request as soon as possible.

Thank you for your contribution! If you need any help, please reach out on our Discord server. ❤️

@matthieupoupin3704-alt

matthieupoupin3704-alt commented Jun 20, 2026

Copy link
Copy Markdown

Installed Plugins

  • DeckyOstMusic - 1.8.0 (built from source, no release zip available)
  • AirDeck - 0.1.0
  • PowerTools
  • SDH-CssLoader
  • decky-steamgriddb
  • hltb-for-deck
  • protondb-decky

Specifications

  • SteamOS 3.8.10 (Stable)
  • Steam 1781041600 (Stable)
  • Decky 3.2.5-pre1 (Pre-Release)
  • Tested on a Steam Deck in Big Picture Mode.

Issues

Has the following major blocking issue(s): Plugin fails to load with SyntaxError: Unexpected token 'export' at PluginLoader.importReactPlugin. Likely caused by @decky/rollup v1.0.1; bumping to v1.0.2 may fix it. Additionally, the v1.8.0 GitHub release has no assets attached, making installation impossible without building from source.

Has the following minor non-blocking issue(s): None observed (plugin did not load).

Summary

Tested by building from source as no release zip is available on the v1.8.0 release. Upon loading, Decky immediately throws a SyntaxError indicating the bundle uses ES module syntax (export) incompatible with the current Steam client. Plugin cannot be used in its current state on SteamOS 3.8.10 Stable.

I was a big fan of the original GameThemeMusic and I'm looking forward to seeing the final results: hope the issues get fixed soon!

@Allive

Allive commented Jun 24, 2026

Copy link
Copy Markdown
Author

@matthieupoupin3704-alt Hey, thanks for your try. Pls give it a one more chance :)
Updated release with 1.8.1 with @decky/rollup bump and providing .zip asset for installation

FYI. Tested on 2 decks. Currently on preview version of decky loader as far as todays steam client update on main channel breaks stable version of decky loader

@matthieupoupin3704-alt

matthieupoupin3704-alt commented Jun 29, 2026

Copy link
Copy Markdown

@matthieupoupin3704-alt Hey, thanks for your try. Pls give it a one more chance :) Updated release with 1.8.1 with @decky/rollup bump and providing .zip asset for installation

FYI. Tested on 2 decks. Currently on preview version of decky loader as far as todays steam client update on main channel breaks stable version of decky loader

Hey, so I gave it one more chance and I really wasn't disappointed:

Installed Plugins

  • AirDeck - 0.2.0
  • DeckyOstMusic - 1.8.1
  • EmuDecky
  • PowerTools
  • SDH-CssLoader
  • SuggestMe-decky-plugin
  • decky-brightness-bar
  • decky-lsfg-vk
  • decky-steamgriddb
  • decky-storage-cleaner
  • hltb-for-deck
  • protondb-decky

Specifications

  • SteamOS 3.8.11 (Stable)
  • Steam 1782533657 (Stable)
  • Decky 3.2.6 (Stable)

Issues

Has the following major blocking issue(s):

  • yt-dlp is not bundled in the zip and must be installed manually: the plugin fails silently without it.

Has the following minor non-blocking issue(s):

  • Track transitions are not immediate even with locally cached tracks: there is a very very slight delay when switching between games, but it's just me being maniac i think
  • Occasional restart of the current track when entering a settings menu before it stops
  • Some UI strings are not translated in French, but it's just a localisation issue.
  • Invidious instances do not appear to work: only the default YouTube source functioned correctly

Summary

Tested by navigating game pages and the home screen in the Steam library on a Steam Deck OLED 512GB. yt-dlp had to be installed manually as it was not included in the zip, but I think it was just a small oversight. Once set up, the plugin worked correctly overall: music plays on the home screen, follows game selection, and search works well. Minor timing issues exist but nothing blocking. Really cool to get this plugin once again :)

@github-actions

github-actions Bot commented Jul 7, 2026

Copy link
Copy Markdown

This pull request is stale as no updates or testing reports have been posted within the last 7 days. Please ensure you are actively recruiting testers or resolving the issues discussed. If you do not remove the stale label or comment, this will be closed in 7 days. Please close this pull request if you need more time to resolve issues so we can keep our repo healthy.

@github-actions github-actions Bot added the stale label Jul 7, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

plugin-addition Adding a plugin to the Plugin Store stale

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants