Skip to content

Add deck-progress-tracker to Plugin Store#1005

Merged
EMERALD0874 merged 2 commits into
SteamDeckHomebrew:mainfrom
maroun2:add-deck-progress-tracker
Apr 23, 2026
Merged

Add deck-progress-tracker to Plugin Store#1005
EMERALD0874 merged 2 commits into
SteamDeckHomebrew:mainfrom
maroun2:add-deck-progress-tracker

Conversation

@maroun2
Copy link
Copy Markdown
Contributor

@maroun2 maroun2 commented Mar 21, 2026

Add deck-progress-tracker to Plugin Store

Deck Progress Tracker is a Decky Loader plugin that tracks your gaming progress across your Steam library. It automatically categorizes games by completion status (Not Started, In Progress, Completed) using playtime data and HowLongToBeat integration. It provides a dashboard with progress stats and filtering accessible from the Quick Access Menu.

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 update channel of SteamOS. Beta testing was not possible — Decky Loader does not currently load on SteamOS 3.7.20 Beta (decky-loader#837).
  • 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.

Testing

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

@maroun2 maroun2 requested a review from a team as a code owner March 21, 2026 20:03
@maroun2
Copy link
Copy Markdown
Contributor Author

maroun2 commented Mar 21, 2026

My testing reports for other plugins:

@github-actions github-actions Bot added the plugin-addition Adding a plugin to the Plugin Store label Mar 21, 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. ❤️

@maroun2
Copy link
Copy Markdown
Contributor Author

maroun2 commented Mar 22, 2026

@beebls
Copy link
Copy Markdown
Contributor

beebls commented Mar 26, 2026

My testing reports for other plugins:

* Non-Steam Badges by @sebet: [Added "Decky non-Steam Badges" plugin #987 (comment)](https://github.com/SteamDeckHomebrew/decky-plugin-database/pull/987#issuecomment-4100785452)

* Decky Launch Options by @Wurielle: [Update Decky Launch Options to v1.9.0 #1000 (comment)](https://github.com/SteamDeckHomebrew/decky-plugin-database/pull/1000#issuecomment-4101082585)

* Decky Clipper by @Managor: [Add Decky Clipper plugin #1003 (comment)](https://github.com/SteamDeckHomebrew/decky-plugin-database/pull/1003#issuecomment-4104201790)

We really do appreciate the extensive reviews, however, for the future, don't submit reviews for plugins that aren't already deployed to the testing store, as there may be further changes from the author before the plugin is finalized and thus the review becomes moot.

If when you submit your PR there aren't any plugins on the testing store to test, don't feel like you have to then go and test some non-approved ones.

@beebls
Copy link
Copy Markdown
Contributor

beebls commented Mar 26, 2026

It looks like your PR is attempting to modify deck-progress-tracker and GamesPrefixManager, can you rebase onto latest main so that your plugin is the only change

@beebls
Copy link
Copy Markdown
Contributor

beebls commented Mar 26, 2026

Plugin code itself looks good, however most commits are co-authored by Claude.

There's nothing inherently wrong about AI codegen, I just need to ask a couple clarifying questions to you.

  1. To what extent was AI used when creating the plugin (was all or nearly all code authored by AI), this matters for copyright purposes, where we need to know that you can claim copyright to the code in your repo.

  2. Was the decky/steam specific code double-checked to ensure all interfaces and methods actually exist? We have had a lot of cases where AI can hallucinate SteamClient methods or VDF components and it can lead to plugins that don't function.

Lastly, it appears that your plugin is based off of the decky plugin template, but yours is MIT licensed whereas the plugin template is BSD licensed, you'll need to change your license to reflect this.

@maroun2
Copy link
Copy Markdown
Contributor Author

maroun2 commented Mar 26, 2026

Thanks for the review!

AI usage: Claude helped me mostly with commit messages and as a coding assistant. But look at the commit history — this wasn't some one-shot vibe-coded thing. It took weeks of work, especially getting game discovery to work for all 800+ owned games, not just installed ones. That alone was painful. And I cleaned up the history before going public, so you're not even seeing all of it. This is my work and I can claim copyright.

Steam/Decky APIs: All Decky imports are verified against the actual installed packages. The undocumented Steam frontend stuff — app store, achievement cache, client APIs — all validated through testing on my actual Steam Deck. I also built fallback chains for these APIs because they don't always behave the same way. That came from real debugging sessions, not guesswork.

License: Fixed — changed to BSD-3-Clause in 1.3.5.

Testing store: Sorry about that — I'm new to the submission process and didn't know about the testing store workflow. Will follow the correct process going forward.

PR is rebased onto latest main with only my plugin.

Copy link
Copy Markdown
Member

@EMERALD0874 EMERALD0874 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  • Your license is still non-compliant. Please see the LICENSE file from decky-plugin-template and note how you need to cite us as the original authors of the plugin template.
  • Your PR is not rebased onto main. You're still attempting to build two other plugins.

@maroun2 maroun2 force-pushed the add-deck-progress-tracker branch from e421e30 to 8eeb9ae Compare April 1, 2026 10:46
@maroun2
Copy link
Copy Markdown
Contributor Author

maroun2 commented Apr 1, 2026

I hope this time is right.

Rebased onto latest main — PR now only modifies .gitmodules and plugins/deck-progress-tracker.

License updated to BSD-3-Clause with Steam Deck Homebrew attribution.

CI is now building only deck-progress-tracker.

Copy link
Copy Markdown
Member

@EMERALD0874 EMERALD0874 left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM for testing

@EMERALD0874
Copy link
Copy Markdown
Member

Please review the pipeline failure.

@maroun2 maroun2 force-pushed the add-deck-progress-tracker branch from 8eeb9ae to f879d7d Compare April 4, 2026 05:10
@maroun2
Copy link
Copy Markdown
Contributor Author

maroun2 commented Apr 5, 2026

I believe this is fixed now — rebased onto latest main with the build issue resolved and license updated. However, it seems the CI can only be approved by a maintainer, so I can't verify the fix myself. Could you approve the workflow run so we can confirm?

@beebls
Copy link
Copy Markdown
Contributor

beebls commented Apr 8, 2026

Looks like the CI is still failing, seemingly you do not have a pnpm lockfile

@maroun2 maroun2 force-pushed the add-deck-progress-tracker branch from f879d7d to 4c8e218 Compare April 9, 2026 12:30
@maroun2
Copy link
Copy Markdown
Contributor Author

maroun2 commented Apr 9, 2026

@beebls lockfile added, can you run the checks please?

@maroun2
Copy link
Copy Markdown
Contributor Author

maroun2 commented Apr 11, 2026

@Managor or anyone with free time. Can you please test my plugin? It is finally in the testing store.

@maroun2 maroun2 mentioned this pull request Apr 14, 2026
4 tasks
@github-actions
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 Apr 19, 2026
@Managor
Copy link
Copy Markdown
Contributor

Managor commented Apr 19, 2026

Sorry, I missed this from my emails.

Plugin Testing Report

Installed Plugins

  • Decky Clipper - 1.0.0
  • SteamGridDB - 1.7.1
  • Deck Progress Tracker 1.3.6
  • Download All - 1.0.0
  • ProtonDB Badges - 1.2.0
  • PlayCount - 1.7

Specifications

  • SteamOS 3.9 (Main)
  • Steam 1776387948 (Stable)
  • Decky 3.2.3 (Prerelease)

Issues

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

  • The progress tracker badge on game info view overlaps with player count and isn't visible
  • The badge on the game info view isn't navigable on by a controller
  • Tapping on the badge to open the progress view doesn't push a new entry to the history stack. Pressing B will take you out of the game info view instead of just closing the progress view
  • Scrolling all the way down and then back all the way up in the QAM view doesn re-reveal the Library (X games) label

Summary

The core functionality of the plugin seems to be working with only minor annoyances.

@maroun2
Copy link
Copy Markdown
Contributor Author

maroun2 commented Apr 19, 2026

Thank you for the test! @Managor

@beebls Should I fix the issues now? Or can we leave it to next version?
I was hoping to get out MVP.

@santojon
Copy link
Copy Markdown
Contributor

santojon commented Apr 20, 2026

Plugin Testing Report

Installed Plugins

AutoFlatpaks - 1.6.8
SteamGridDB - 1.7.1
MoonDeck - 1.11.3-d8a315e
CSS Loader - 2.1.2
TabMaster - 2.15.0
vibrantDeck - 2.0.1
Deck Progress Tracker - 1.3.6-4c8e218

Specifications

SteamOS 3.7.21 (stable)
Steam 1773426488 (Stable)
Decky 3.2.3 (Stable)

Issues

  • Tag not navigable by controller

Summary

I used the plugin without problems. It seems to be working without major issues.

@santojon santojon mentioned this pull request Apr 20, 2026
7 tasks
@github-actions github-actions Bot removed the stale label Apr 20, 2026
@beebls
Copy link
Copy Markdown
Contributor

beebls commented Apr 22, 2026

Thank you for the test! @Managor

@beebls Should I fix the issues now? Or can we leave it to next version? I was hoping to get out MVP.

Entirely up to you, if you think the plugin is good enough to release as is, then give me the word and I'll release it, but if you want to make a change you can, you'll just need to get another review on that newer version after we approve it

@maroun2
Copy link
Copy Markdown
Contributor Author

maroun2 commented Apr 23, 2026

Lets release it please. All the issues are valid, but instead of buttons the touchscreen can be used. I will fix it in the future versions.

@EMERALD0874 EMERALD0874 merged commit 180f903 into SteamDeckHomebrew:main Apr 23, 2026
1 check passed
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

Projects

None yet

Development

Successfully merging this pull request may close these issues.

5 participants