Add Deck Shelves to Plugin Store

[santojon]

Add Deck Shelves to Plugin Store

Features

• Inject custom shelves into library/home
• Shelves backed by collections, library tabs, or custom filters
• Advanced filter groups with AND/OR logic for complex game queries
• Filter games by:
  • Favorites, installed, hidden, non-Steam
  • Name (substring or regex)
  • Deck compatibility level
  • Playtime range (min / max minutes)
  • Played within N days
  • Update pending
  • Store tags, achievement count, friends who own
• Sort shelves alphabetically, by recent play, total playtime, release date, size on disk, Metacritic score, or review score
• Library tab selection shows your actual runtime tabs, including those created by other plugins
• Reorder and toggle shelf visibility from the QAM
• Import / export all shelves as JSON
• Persistent settings across plugin reinstalls
• Multi-language support (en, pt-BR, de, es, fr, it)

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.

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.
• No: 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.

[github-actions]

Issues Found

• Both testing boxes are present in your description. Please remove one of them per the Markdown comment above the testing section.

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. ❤️

[santojon]

debug flag exists on code just for debug purposes, but is removed in my packaging script:
https://github.com/santojon/Deck-Shelves/blob/main/scripts/build/package.sh
Lines 17-19

if have to run this script on some specific flow decky build follows, please say me

I'm using it on

pnpm run package

and

pnpm run dist

[moi952]

Hi,
I tried your plugin — it’s really great and fills a huge gap in Steam’s functionality. However, I’m experiencing a few issues:

1- My favorites aren't displaying. I have 7 favorites, but nothing shows up on the home screen. Perhaps the selection is based on the collection name, which in my case must be French and in yours English? So the problem would occur for all languages.

2- I tried the "Recently Added" collection, but it doesn't seem to be sorted in that order.

3- The displayed covers don't use the style (rounded edges, for example). You can see that when I navigate, Steam games have a border radius when focused, but not the Steam games themselves (Cyberpunk 2077 is a non-steam game, Splitgate is a steam game).

4- When navigating the Steam row, the focus of the game I'm browsing is the middle one. If I scroll to the right, it scrolls to the left, but the selected cover is still the middle one. With your plugin, the selection goes all the way to the right before scrolling.

5- There's a sort of lag, more like a latency (but I don't know if it's Steam causing this or not) when I navigate to a line you added

6- Quite a few translations are missing

Despite these points, the plugin is really clean and works very well. I expected some asynchronous loading with a delay before collections appeared, but that’s not the case.
If you manage to make the small adjustments (especially navigation behavior and correct border rendering), this plugin will become indispensable!

[EMERALD0874]

@moi952 Please only review plugins that have been deployed to the testing store.

Withholding review on this plugin since the required action mentioned by GitHub Actions has not been completed.

[moi952]

@moi952 Please only review plugins that have been deployed to the testing store.

Withholding review on this plugin since the required action mentioned by GitHub Actions has not been completed.

Sorry, I didn't know. This is the first time I've submitted a plugin, and especially the first time I've seen how it works overall.

[beebls]

debug flag exists on code just for debug purposes, but is removed in my packaging script: https://github.com/santojon/Deck-Shelves/blob/main/scripts/build/package.sh Lines 17-19

if have to run this script on some specific flow decky build follows, please say me

I'm using it on

pnpm run package

and

pnpm run dist

Our build CI just builds from the source that is in the file at present, so you will have to remove the debug flag in source.

Additionally, it appears you have not properly linked the submodule as there is no new plugins being detected.

[EMERALD0874]

@santojon Please make your submodule a path without spaces.

[EMERALD0874]

debug flag exists on code just for debug purposes, but is removed in my packaging script[...]

Unless you use the backend folder to run a custom backend build process, you can't easily specify a shell script to run. I highly recommend removing the debug flag and using a shell script to build it with the flag instead.

[santojon]

debug flag exists on code just for debug purposes, but is removed in my packaging script[...]

Unless you use the backend folder to run a custom backend build process, you can't easily specify a shell script to run. I highly recommend removing the debug flag and using a shell script to build it with the flag instead.

Both suggestions done ✅ @EMERALD0874

[santojon]

debug flag exists on code just for debug purposes, but is removed in my packaging script: https://github.com/santojon/Deck-Shelves/blob/main/scripts/build/package.sh Lines 17-19

if have to run this script on some specific flow decky build follows, please say me

I'm using it on

pnpm run package

and

pnpm run dist

Our build CI just builds from the source that is in the file at present, so you will have to remove the debug flag in source.

Additionally, it appears you have not properly linked the submodule as there is no new plugins being detected.

Have tried here and now it seems to be ok. Can you try again?

[santojon]

Test reports:

#1022

#1005

#1016

[beebls]

@santojon, Please refrain from making a large number of updates to your PR while it's still in the review stage.

When you feel your plugin is feature-complete for a first release, please reply and let me know and then we will review it, but any further updates would cause us to have to start from scratch reviewing it.

[santojon]

@santojon, Please refrain from making a large number of updates to your PR while it's still in the review stage.

When you feel your plugin is feature-complete for a first release, please reply and let me know and then we will review it, but any further updates would cause us to have to start from scratch reviewing it.

@beebls The main features are ready. I was just taking advantage of the fact that it hasn't been approved yet to add improvements. In that case, I'll stop updating from now until it's approved.