Skip to content

Add Deckyfin plugin#1070

Open
avivkilloz wants to merge 1 commit into
SteamDeckHomebrew:mainfrom
avivkilloz:main
Open

Add Deckyfin plugin#1070
avivkilloz wants to merge 1 commit into
SteamDeckHomebrew:mainfrom
avivkilloz:main

Conversation

@avivkilloz

@avivkilloz avivkilloz commented Jun 23, 2026

Copy link
Copy Markdown

Add Deckyfin to Plugin Store

Deckyfin lets you manage a Windows game library from the Decky sidebar without leaving Gaming Mode. It's aimed at users who store games on a home server, NAS, or local drive and want to add them to Steam as non-Steam shortcuts with proper Proton configuration and artwork — all from the Deck.

Deckyfin Home Page Deckyfin Settings Page Deckyfin Game Page

What it does:

  • Library view — scans a configured games folder and lists detected games in a card or list view with SteamGridDB artwork
  • Steam shortcut integration — adds any game as a non-Steam shortcut with a single tap; removes it just as easily
  • Proton version picker — sets a per-game Proton/Wine version via CompatToolMapping (all installed Proton versions listed)
  • Dependency installation — installs Windows runtimes (vcrun2022, dotnet40/48, directx9, etc.) into the game's Proton prefix via a 4-method fallback chain (native protontricks → flatpak protontricks → runuser → sudo), with xvfb-run wrapping for headless X display
  • Prefix initialization — creates and initializes a fresh Wine/Proton prefix for the game
  • SteamGridDB artwork — searches SteamGridDB and applies portrait, hero, logo, and wide art directly to Steam's grid folder; also supports applying any image type manually via URL

Multiple game sources (folders) can be configured, each with its own scan path. Offline network mounts are handled gracefully — the source shows as offline rather than freezing the UI.

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

@avivkilloz avivkilloz requested a review from a team as a code owner June 23, 2026 07:11
@github-actions github-actions Bot added the plugin-addition Adding a plugin to the Plugin Store label Jun 23, 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. ❤️

@avivkilloz

Copy link
Copy Markdown
Author

still active

3 similar comments
@avivkilloz

Copy link
Copy Markdown
Author

still active

@avivkilloz

Copy link
Copy Markdown
Author

still active

@avivkilloz

Copy link
Copy Markdown
Author

still active

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.

1 participant