Add ProtonDB Library Badges

[Yohlo]

ProtonDB Library Badges

Adds ProtonDB rating tiers at a glance inside the Steam library. This plugin adds:

• A small colored tier dot beside every game in the library sidebar.
• A ProtonDB stat on every game page's play bar. Clicking it opens the game's ProtonDB report.
• A ProtonDB rating section in the Library Filters panel, so the library list can be filtered by tier and those filters can be saved into dynamic collections.
• A toggle button in the icon row beside the library search box to quickly show or hide the sidebar dots.
• A settings page with a "clear cache" action. Ratings are fetched from the public ProtonDB summaries API and cached locally for a week.

How it differs from the existing protondb plugin: that plugin shows a compatibility widget on Steam store pages. This one covers the library only: sidebar indicators, the game page play bar, and library filtering / dynamic collections. The two do not overlap and are compatible with each other.

Repository: https://github.com/Yohlo/protondb-library-badges
Release: v1.0.0

The only network calls are to https://www.protondb.com/api/v1/reports/summaries/<appid>.json.

Screenshots

Library Dots	Filters
Toggle	Play Bar

Dynamic Collections

Task Checklist

Developer

• I am the original author or an authorized maintainer of this plugin.
• I have complied with all license requirements for the libraries used, including providing appropriate notices where necessary.
• My plugin is fully open source and does not depend on any external paid services, except for widely trusted and well-known platforms. Additionally, neither I nor anyone associated with me profits from any such services.

Plugin Functionality

• I have tested the plugin on both the Stable and Beta Steam update channels.
• My plugin is unique, or provides additional or alternative functionality to plugins already on the store.

Backend Configuration

• No: I use a standard Millennium python backend in my plugin.
• No: I use custom binaries that or rely on other FOSS projects that aren't written directly using Millennium's python backend.

Community Contribution

• I have tested and left feedback on two other plugin pull requests.
• I have added links to those feedback comments in this PR.

Sorry, just found Millennium ):

---

Testing Instructions

1. Download protondb-library-badges-v1.0.0.zip from the releases page and extract it into your Millennium plugins folder, or clone the repo there and run npm install && npm run build.
2. Start Steam, enable ProtonDB Library Badges under Millennium → Plugins, and restart Steam.
3. Open the Library. Each game in the sidebar list should show a small colored dot on the left after a moment (ratings load lazily and are cached).
4. Click any game. The play bar should show a ProtonDB stat with the tier. Clicking it should open that game's ProtonDB report page.
5. Open the Library Filters panel. A ProtonDB rating section should be present. Selecting one or more tiers should filter the game list.
6. With a tier filter active, save the filter as a dynamic collection and confirm the collection only contains games of that tier.
7. Click the ProtonDB toggle button in the icon row beside the library search box. The sidebar dots should hide, and show again on a second click.
8. Open the plugin's settings page in Millennium and click Clear cache. Ratings should refetch on the next library view.

• Verified by a third party on Steam Client Stable.
• Verified by a third party on Steam Client Beta.

---

[D3XX3R]

Tried it and it works with no issues.
I'm on Steam Client Stable.

[ejalxndr]

@Yohlo Looks great.

Lets make the plugin name in plugin.json something more specific then "protondb-library". Maybe "protondb-library-badges"

[Yohlo]

@ejalxndr Good call, just renamed the plugin to protondb-library-badges. Thanks!