steamgriddb/decky-steamgriddb

Plugin for Decky Loader to apply and manage custom art assets from within gaming mode.

SteamGridDB plugin for Decky Loader

Easily browse and manage Steam artwork from SteamGridDB or your local files from within gaming mode.

Features

• Browse assets from SteamGridDB for the selected game.
• Support for non-Steam shortcuts and Source/GoldSrc mods.
• Ability to change icons for Steam or non-Steam shortcuts.
• Manually select images from the local file system.
• Utility to apply invisible assets.
• Ability to reset custom images back to default.
• Logo positioner.

Installation

1. Install Decky Loader
2. Open the Quick Access menu
3. Open the Plugins Browser
4. Find SteamGridDB and press "Install"

Usage

Select "Change Artwork..." from a game context menu.

You can access the menu by focusing on a game in your library and pressing .
Or by using the button on a game page.

Credits

Early Testing: Emenesu, Mr. Mendelli
Development Help: SDH Discord
Localisation:

Čeština	zenobit, theczechczech
Deutsch	Kurikuo, benutzer_artur7, Anja, FL0W, Remirax, LittleFreak
Español-España	Andrea Laguillo, Kam, m0uch0
Español-Latinoamérica	Kam
Français	Michael Jean
Italiano	SpagottoB37, RodoMa92
Nederlands	Phanpy100 (Fanny), Jannes Verlinde
Polski	DRS, Michał Kwiatkowski, MAX0R
Português-Brasil	Oregano, Thomas Eric
Português	Kokasgui, Ev1lbl0w
Română	Munt
Suomi	Jage
Svenska	Moneyman Dan, Super
Türkçe	Bilgehan Ceviz, Sib
Ελληνικά	Emenesu
Русский	fycher, LostHikking
Українська	Veydzher
한국어	yor42
日本語	Nes
正體中文	mingyc
简体中文	zhzy0077, XHXIAIEIN, simon3000

decky-steamgriddb's Issues

Can't overwrite images from games added by Heroic Launcher

I have some games added to steam trough Heroic Game Launcher "Add to Steam" functionality. For those games I can find steamgrid images with this plugin, and when I choose an image I get notification that it was successful. But the images are not actually applied.

There is workaround for it. If I use Manage tab to delete the images first and then choose my new images it will all work as intended. I suspect that deleting the originals from the code before setting up new images might fix the issue.

Steps to reproduce:

• Install any game trough heroic(there are some free games on gog https://www.gog.com/partner/free_games ) (Ideally a game that has some data in steamgrid)
• In heroic go into installed game details -> 3 dots in upper right -> Add to Steam
• Restart Steam client/steam deck so the library refreshes with a new game
• Find the game -> properties -> Change artwork...
• Set capsule/wide capsule/hero/logo, wait for success notification (don't use icon, since it will want to restart steam deck)
• Look into Manage tab or close the plugin

Expected: the selected images are displayed
What happens: the originals are displayed

[Bug]: While downloading games, the context menu patch is unreliable

Was discovered on lastest stable update (pre 3.5), user could not click "Change Artwork" while they were downloading games.

Seems like each time the download % increased, the UI would rerender, and the patch would not get applied.

See this discord chain for full context.

Setting logo always puts position to the bottom left

Reset Logo Position

I'm loving the new ability to reposition logos, but I'm not seeing a way to reset to the default size and anchor. This is a right-click option in the desktop Steam client, so I wasn't sure if this was a bug or if it's something that might be added eventually.

Viewable Grid Limit

If selected filter options would return more than 50 potential results, only the first 50 are shown. There is no indication of any further available options, nor any way to load the omitted options without altering filter settings.

Sorry if this is intended behavior; I couldn’t find documentation one way or the other.

Help needed

I am trying to develop a plugin, and I learned the openFilePickerV2 api from your work (thanks), But I'm having some difficulty when I assign the return value to a variable and try to refresh the ui，and I noticed the way you refreshOverview, lol. so is the problem from serverapi or just my code broken?

Steam Deck Beta Oct 26th Update (Possibly Even Earlier) seems to have broken Steamgriddb.

Updated the Decky Plugin to the latest on the stable Decky store (1.3.1) but while the Change Artwork option is there, it drops you to a blank screen with the search bar selected however any entry just goes to searching Steam as normal. Nothing comes up for the Artwork part of the UI like in the past.

Feature Request: .ico icon files & official icons

Would it be possible to add .ico files support for icons and option to set official ones?

File system is not refreshed for manual replacement

To reproduce :
-Install the Decky plugin
-Try to browse the file location for a non steam game
-Go to desktop mode and prepare a folder in the Pictures folder with some arts
-Back to gaming mode
-On the Manage tab in the plugin, the filesystem tree does not make the new folder appear

I tried to reboot the deck, no changes.

Menu option disappeared

I still have Steamgriddb installed but the menu option to change artwork has disappeared. I've tried uninstalling and reinstalling the plugin but it remains missing.

Suggestion: Export App Assets to External Files

The ability to export all of an app's currently selected assets would be a useful feature, so I can then take what my game has currently set and the save them back to my local SRM setup.

Feature Request: Apply All Official Artwork

Hi again,

with the official Boop plugin, there's an option to apply all the official Steam artwork for a given title. Would it be possible to implement a button that does the same thing?

Thanks.

How-to contribute

Hello 👋

Excellent tool! I would like to contribute but I don't see an md file that explains how to. Also, I'm curious how functions are tested and debugged.

Thanks!

Translation

How to test translation? I can't find a way put translated strings into program on deck yet. I wanna try it...

Unable to find plugin in Decky Plugins Browser

I cannot find this plugin in the plugin browser on my device.
I further visited https://plugins.deckbrew.xyz/ and https://beta.deckbrew.xyz/ but neither of them have the plugin either.

I also went to the "Manual Plugin Install" section and used the link https://github.com/SteamGridDB/decky-steamgriddb/archive/refs/heads/main.zip which installed it. However, the folder structure of the directory created in /home/deck/homebrew/plugins does not match the other plugins. This makes it unusable, since it doesn't appear in the list of plugins.

Is there a reason it's not visible in the plugin browser?
If that cannot be fixed, is there a "release" zip file I can point it to by using the manual install option?

Manually Define Game Title Search

For games where there are multiple versions (Final Fantasy VIII and Remastered in my example case), it would be useful to have the option to manually define the title to search for an alternate version of the game, as they may have far more options for artwork.

Just doesn't do anything.

I installed the latest stable version 1.2.4 and it doesn't work. After I click the "change artwork" button there is just a blank Steam store page. I've tried reinstalling or installing older versions - nothing works.

Have the latest decky loader and the latest stable steam version and OS.

Resize covers to 300x450 instead of 600x900?

The library isn't as responsive as it could, and sometimes the covers need to load (only for 0.1 secs or something).

I'm just wondering here, shouldn't be faster with low quality images? Because the Deck resolution is 1280x800 and it can't show 600x900 covers in all their glory to begin with.

Is there any way to test if a gallery of 300x450 images can boost the performance of the library, and if this is true... shouldn't we use imagemagick for every downloaded cover to set it at a lighter resolution?

If everything i'm saying has no sense please mark this as closed, thanks!

Steamos 3.5 Broken

Option to change artwork disappeared when updating to steamos 3.5 making the plugin unusable

no more icon changer?

theres no icon tab anymore

File picker extensions should be case insensitive

Clean Gameview Hero Art Alignment Compatibility Issues

Clean Gameview stretches the hero art to fit the screen, cutting out some of the artwork. SteamGridDB centers artwork, resulting in artwork with subjects on the sides to appear cut off. Examples:

It should also be noted that this issue also occurs on the home page both without plugins, and when I am using the expanded Hero option in Art Hero. Tony Hawk used for examples:
(Face cut off)

(Only negative space visible)

An option to choose a center or move and resize the artwork in these cases would be greatly appreciated. Since it may affect alignment, I am also using Footer Editor to remove my footer.

V1.2.0 blank description

just updated to version 1.2.0 of the plugin due to a notification from decky launcher that an update was available.
after updating, when selecting the plugin in the decky loader menu, the resulting window is blank. the lovely documentation with the animated graphic showing how to use the plugin to change artwork is nowhere to be seen.

when selecting 'Change Artwork' either from the library 'card' for a game, or from the settings icon within the game card's window, rather than the expected search area and options for alternative images, now a blank webpage appears and tapping 'a' to select brings you to an expanded library view. selecting anything from there is as if you've selected the card from the library showing the main options, play game, controller settings and settings.

so basically the plugin's info window along with the plugin's functionality are both gone with this update.

i've just reverted to version 1.1.1 of the plugin and everything works as expected/as it had prior to updating to 1.2.0

Unclosable fullscreen blur after failing to find capsules (rare)

Use case - AfterParty installed as nonsteam game (from epic, using epiclauncher from desktop), change artwork.
Try to browse for capsule, nothing appears if wifi is being weird (see steamdeck 5ghz wifi bug after sleep).

Since nothing appears, it times out, but the page overlays over the steamdeck OS completely, very blurry but you can see unreachble "refresh" button and a line of text before it. No means of closing the unreachable webpage, restart of SD fixes it.
Cannot reproduce as restart also fixed 5ghz connection issue so change artwork actually shows capsule art now.

Can't reorientate logos for titles using assets generated from Steam ROM Manager (potentially more)

Steps to reproduce:

1. Add game via Steam ROM Manager with Logo
2. Use Plugin to move the Logo
3. The loading symbol appears until pressing the d-pad, then, it's taking up the whole space and is not orientable.

Images Used + Shortcuts.vdf

• Using the Game titled "Bionicle Heroes"
  TestData.zip

Add Option to Select Steam Original Assets

Unfortunately, some games don't have any custom artwork which causes a blank screen when attempting to add art from the database.

Seen here with "Burnhouse Lane":

However, this game - like others - has Steam original assets available on SteamGrid. It would be ideal to be have an option to select the default Steam assets for all artwork of a particular game.

Other than a case for a game with no custom artwork, this feature could be useful for those users who use default Steam artwork, but want to then customize one or two pieces of art for the game.

Set all official assets with a single button

Would it be possible to add a shortcut (‘Y’ for instance since it is not binded as of now) to apply all official assets availables for a given game?

I think this would be really handy for those that import non-Steam games and want to use the Steam assets. So instead of going by every category applying the official asset it would be available on a single key press.

Thank you very much!

Plugin shows images for the previously selected game in certain situations

Sometimes the plugin shows images for the previous game that was selected. For example select Batman -> Change Artwork... and you'll see images for Batman. Then go to Spider-man -> Change Artwork... and sometimes you'll see the art for Batman instead of Spider-man. I'm not sure for all things that cause it.

Steps to reproduce:
Unfortunately I didn't manage to find one reliable way to reproduce it. Whenever I think I found a way, next time I try it it's not breaking. I think it's related to higher cpu or storage activity. This works... sometimes:

• start downloading any game with few gigs of size (so it doesn't finish too fast)
• go into your library and "options -> change artwork..." on multiple games.
• In some cases older game will appear instead of the current one

Interestingly enough when you click options the menu for the game will display proper title for the game, so Steam Deck itself catches proper game. But I think the hook for the plugin is too late to notice the menu. Sometimes it unloads the "Change option..." option after a while, but doesn't replace it with the new game.

"Just don't download games while changing artwork" doesn't fully work, because activity caused by changing artwork also seems to cause the issue. When you do it the plugin downloads new art, and then library loads the downloaded art, and I think this makes the issue appear as well. Downloading game is just more reliable in making the plugin unreliable.

Results cutting off bottom of page too early

The plugin is not working anymore on steam deck

Version : 1.0.0
I manage to install the plugin via the "decky shop".
When I click on SteamGridDB, I have the folowwing error :

TypeError : Cannot read property 'prototype' of undefined
at eval (eval at importReactPlugin (http://localhost:l337/frontend/index.js:1874:43), :25864:55)

It doesn't work anymore for me

Can't Change Icons for Non-Steam Games

Decky Prerelease, Steam OS and Client Beta
Tried changing everything to stable and didn't help either

Can't switch tabs from Capsules

After I change two or three game artworks all of a sudden I can switch between artwork tabs and can only apply Capsule artwork. Restarting fixes it until I do two or three more then it breaks.

Non-Steam Game Shortcuts Not Showing

I am having a weird issue where when I add Non-Steam games to my library in Desktop mode, they no longer appear in my Non-Steam games. This happened after I was changing some of the artwork using this plugin. I have tried restarting, tried deleting the shortcuts and re-adding them as well.

Keeps loading

Each time I want to assign a picture to something it's as if the filter is just not loading. It's in an eternal loading screen.

Artworks not loading

Hey there,

I just installed decky and SteamGridDB and i'm trying to change the artwork of a game, the problem is it stays on the loading page and does not load the assets

I enabled developer mode on my deck, do i need to do something else?

Thanks in advance

Option to disable restart prompt on icon change.

I find myself frequently accidentally saying yes to this (as it is the default option) and an option to disable the prompt would be awesome.

No longer functions

just opening the plugin says Error, and the plugin simply no longer functions

SteamGridDB API Error

I receive the following error when trying to pull artwork. SteamGridDB API Error: SGDB API request failed. Looks like the API key is expired/revoked????

Feature Request: Sort By Recent

Hi there,

I often upload my own grids to SteamGridDB, but they're hard to find because the Decky plugin doesn't have a sort feature. So I'd really love the ability to sort by recent.

Thanks!

Stuck at loading spinner

I'm stuck at the loading spinner forever in each tab. I'm sorry for not being able to provide more specific info.

I've seen some other people in reddit who have the same issue.

Edit: For some reason this is only happening with some specific games (For example: The Witcher 3)

the built-in steamgriddb api key Request limit

First of all, thank you for making such a good plug-in for us to use
It would be more convenient if I could define the apikey myself

menus disappearing

so I just got in to this because I like adding a lot of third-party non-steam games and this is a great way to find artwork but I have to play Rush to collect the menu every time I try to change artwork or add artwork to a game example video below

Unless a video only link
https://youtu.be/ZmJJ8sQcVd0

Give feedback when there are no assets

Hi there!

First off, I want to express my appreciation for this fantastic project - great work! 👏

I've been using it and noticed a small usability improvement that I'd like to suggest. Currently, when there are no assets available for a game, the user is met with a blank screen, which might leave them wondering if there's an issue. To enhance the user experience, I was wondering if it's possible to implement an informative message that appears when there are no assets for a game.

Here's the idea: When there are no assets to display, consider adding an unobtrusive info message, something like "No assets available." This would provide users with clear feedback and help them understand that there are no assets for the selected game, eliminating any confusion.

I believe this addition would be a valuable enhancement to an already impressive project. Thanks for considering this suggestion!

Usage instructions in QAM & show currently selected asset side-by-side.

When I first opened up the plugin, I instinctively went to access the QAM since that's how you use all the other plugins, but only saw social media links. I propose adding a small line explaining how to use it just to make it easier for users.

Here's my quick and dirty edit of the HTML:

<div class="quickaccesscontrols_Text_1hJkB">To edit game artwork: Select a game &gt; press Options &gt; Change Artwork <br><br>More SteamGridDB Stuff</div>

And also on the subject of the picker itself:

I would also suggest having an icon overlaid over the currently used image, or some other such indicator. I know we have the Mange tab, but since you're already kicked to the Capsule tab by default, it would make it easier for quick comparisons between similar images for example.

Manage Images does not show all relevant file types.

When manually selecting an image from the Manage section (e.g. if say SteamGridDB doesn't have an image and you want to add your own) only .jpg file types show, you are unable to select other file types such as .png for logos or .ico for icons, etc.

Translated and Fixed some strings in the Brazilian Portuguese Translation

@doZennn Saw your post on Reddit asking for people to contribute on Crowdin, so I decided to revise the current Brazilian Portuguese translation and translate the missing strings. Please accept the two revisions I modified. Thank you.

By the way, this is my profile on SteamGridDB: https://www.steamgriddb.com/profile/76561198051799142

When selecting local assets half of the folder and files are missing

The filesystem view when you manage assets on disk seems to be missing half of the folders/files which should be there.
So for example I have 8 files in a folder but only 4 show up to be selected. Or i have 2 folder but only 1 is visible in the filebrowser.

Search by Steam ID?

I have a game (Bokura) it appears in steam and steamdb when searched by that name, but the official name is in Japanese. The plugin can't find the game. If I could just type in the Steam number, it would be a very simple matter.

Adjustable logo position in manager

Update Decky Frontend Lib version

Plugin no longer works with the latest version of decky. Per this SteamDeckHomebrew/decky-loader#339 (comment)