- Top Pick: Valve Steam Deck OLED 512GB
- Runner-up: SanDisk 1TB Extreme microSDXC
- Also consider: Samsung T9 Portable SSD 2TB
Add a handful of non-Steam games to Steam on Linux — an emulator front end, a GOG purchase, a launcher shortcut — and the library starts to look broken. Steam only downloads official artwork for games bought on Steam itself, so everything else gets grey boxes, blank capsules or a stretched icon where a proper cover should be. The bigger and more mixed a library gets, the worse it looks.
SteamGridDB is the community project that fills those gaps. It is a free, volunteer-run database of game artwork that any tool can query, and on Linux it connects to Steam through three distinct routes: a one-click helper called SGDBoop, a plugin that lives inside Decky Loader on Steam Deck, and the library managers that fetch artwork automatically while they import your games. This explainer covers what the database actually holds, how each route works, and where the honest limits are.
As an Amazon Associate, we earn from qualifying purchases.
Quick answer
SteamGridDB is a community-run database of game artwork — grids, heroes, logos and icons — that fills the gaps Steam leaves for non-Steam shortcuts and older titles. On Linux you apply that art three ways: SGDBoop from the website, the SteamGridDB plugin inside Decky Loader on Steam Deck, or automatically through managers like Steam ROM Manager and BoilR.
What the database actually holds
SteamGridDB organises everything into game entries, and each entry collects four kinds of artwork uploaded by volunteers: grids, heroes, logos and icons. Popular games may have dozens of alternatives for each slot, ranging from the artwork the publisher originally shipped to alternate designs, minimalist covers and animated versions. Obscure games may have a single grid, or nothing at all.
Two things make the database more useful than a folder of downloaded images. First, it covers far more than the Steam catalogue: non-Steam games, standalone applications, emulators and mods all have entries, which is exactly the material a Linux library is full of. Second, it exposes a free API. Tools authenticate with an API key you generate from your SteamGridDB account while signed in, and that key is what lets SGDBoop, the Decky plugin, BoilR and Steam ROM Manager search and download artwork on your behalf instead of you saving files by hand.
The four kinds of artwork
Steam displays library art in fixed slots, and SteamGridDB sorts its uploads to match them:
- Grids are the covers in your library grid. They come in two shapes: portrait at 600 by 900, and landscape at 920 by 430 for the horizontal layout.
- Heroes are the wide banner across the top of a game’s library page, at 1920 by 620 or 3840 by 1240. Heroes carry no text of their own.
- Logos are transparent images of the game’s title that Steam floats over the hero, so a good logo matters as much as the banner beneath it.
- Icons are the small square images used in lists and shortcuts.
When you browse a game’s page on SteamGridDB you can filter by these dimensions and by style, which saves time: a portrait grid dropped into the landscape slot, or a hero with the title baked in plus a separate logo on top, are the two mistakes that make a fixed library look wrong again.
Route one: SGDBoop, the one-click helper
SGDBoop is SteamGridDB’s own tool, and it works from your browser. Install it — on Linux the simplest route is the Flatpak, listed on Flathub as com.steamgriddb.SGDBoop, with binary and source installs also offered — and it registers itself as the handler for a special sgdb protocol. The project’s page then walks you through a test popup to confirm your browser can call it, and a switch that turns on the extra buttons across the site.
From there, hovering over any artwork on SteamGridDB shows two buttons. One applies the image to the matching Steam game directly. The other, marked with a plus, opens a picker so you can aim the artwork at a non-Steam shortcut or a Source or GoldSrc mod instead. SGDBoop downloads the file and files it under the right app ID inside Steam’s own artwork folder, so the change is a normal piece of custom artwork rather than a hack. Two quirks are worth knowing: on Linux you may need to restart Steam before changes appear, icons need a restart on any system, and icons cannot be changed for Source or GoldSrc mods.
Route two: the Decky plugin on Steam Deck
If most of your library time happens in the Deck’s Game Mode, the SteamGridDB plugin for Decky Loader removes the browser from the loop entirely. With Decky installed, the plugin adds an artwork option to each game’s menu: open it, search the database, pick a grid, hero, logo or icon, and the plugin downloads and applies it on the spot, without a trip to Desktop Mode. You connect it once with the free API key from your SteamGridDB account.
This is the most comfortable route for fixing one game at a time on the Deck itself, and it handles non-Steam shortcuts — the entries that need it most — just as well as Steam purchases. Its limit is scale: changing art game by game is pleasant for a dozen titles and tedious for three hundred.
Route three: managers that fetch art as they import
The third route never visits the website at all. Library managers use the same API to pull artwork automatically while they create your shortcuts:
- Steam ROM Manager matches every game its parsers import against SteamGridDB and downloads a capsule, hero, logo and icon for each entry it writes. It is the bulk option, built for emulator libraries and large collections.
- BoilR scans the libraries of other launchers, creates the missing Steam shortcuts, and downloads matching artwork in the same pass.
- Launchers such as Heroic and Faugus fetch SteamGridDB art for the games in their own libraries, including sideloaded titles.
The difference from the first two routes is intent. SGDBoop and the Decky plugin are curation tools: you choose each image. Managers treat artwork as metadata and pick for you, which is faster and usually right — and easy to override later with one of the manual routes when a pick looks off.
How to choose your route
Match the route to the job. One ugly shortcut on a desktop PC: SGDBoop, two minutes in a browser. A Steam Deck library you maintain from the couch: the Decky plugin. A fresh emulator import or a new launcher library: let Steam ROM Manager or BoilR do the whole batch, then hand-fix the handful of entries where the automatic choice disappoints. Whichever route you take, choose portrait grids for the standard library view, keep heroes text-free, and prefer the original publisher artwork when you want the library to look like one collection rather than a collage.
Who should skip this
Skip SteamGridDB if your library is entirely Steam purchases with complete official art — there is nothing to fix. Skip it if the idea of community-made artwork bothers you; every image here is a volunteer upload, not a canonical asset. And skip the tool routes if you never add non-Steam shortcuts: the database earns its keep on mixed libraries, emulator setups and Deck collections, not on a tidy single-store shelf.
The honest limits
Coverage is uneven because uploads are voluntary. A famous game might offer forty grids; a niche one might offer none, and no route can apply artwork that does not exist. Quality varies the same way, and styles clash if you grab whatever ranks first. The artwork itself belongs to the artists and publishers who created it — SteamGridDB is a community archive, uploads can be removed, and nothing about using it changes who owns the images. Finally, custom artwork lives in Steam’s own folders, so a Steam reinstall or a moved library means reapplying or carrying the artwork folder across; the managers make that a re-run rather than a rebuild, but it is still a step.
Gear that suits a well-kept library
Valve Steam Deck OLED 512GB
The machine this workflow suits best: Game Mode is where missing artwork is most visible, and the Decky plugin route exists because of it. The OLED model’s screen also makes good heroes and grids look noticeably better than the grey boxes they replace.
Specs:
- Display: 7.4-inch HDR OLED, 1280 x 800, up to 90 Hz
- Storage: 512 GB NVMe SSD with a microSD expansion slot
- Wireless: Wi-Fi 6E and Bluetooth 5.3
- Battery: 50 Whr
SanDisk 1TB Extreme microSDXC
A curated library usually grows past the internal drive. This card is the standard expansion pick, with the A2 app rating that matters for launching games rather than just storing them.
Specs:
- Capacity: 1 TB, microSDXC UHS-I
- Ratings: U3, V30 and A2 app performance
- Maker-rated read speed: up to 190 MB/s with a compatible reader
- Model: SDSQXAV-1T00-GN6MA
Samsung T9 Portable SSD 2TB
For desktop Linux libraries, a fast external SSD holds the non-Steam installs and emulator folders that managers scan, and moves the whole collection between machines in one copy.
Specs:
- Capacity: 2 TB
- Interface: USB 3.2 Gen 2×2 over USB-C
- Maker-rated sequential reads: up to 2,000 MB/s on a Gen 2×2 host
- Model: MU-PG2T0B/AM
8BitDo Ultimate 2 Bluetooth Controller
Library curation ends at the couch. This controller covers the Deck-adjacent and desktop setups a mixed library gets played on, with three connection modes and a charging dock in the box.
Specs:
- Connections: Bluetooth, 2.4 GHz wireless and wired USB-C
- Sticks and triggers: TMR joysticks and Hall effect triggers, per the maker
- Extras: two remappable back buttons, charging dock included
- Maker-listed compatibility: Nintendo Switch, Windows and Android
JSAUX Docking Station HB0603
A dock turns the Deck into the desktop machine where SGDBoop and the managers are most comfortable to use, with a big screen for judging artwork and Ethernet for bulk downloads.
Specs:
- Ports: HDMI, Gigabit Ethernet, three USB-A 3.0 ports and a USB-C power input
- Video: HDMI output at 4K and 60 Hz, per the maker’s own description
- Charging: USB-C power delivery up to 100 W input
- Model: HB0603
FAQ
Is SteamGridDB free to use?
Yes. Browsing and downloading artwork is free, and the API key the tools need is generated free from your account while signed in. The tools covered here — SGDBoop, the Decky plugin, Steam ROM Manager and BoilR — are free and open source.
Does SGDBoop work with the Flatpak version of Steam?
Yes. SGDBoop itself ships as a Flatpak, its recent releases specifically fixed the Flatpak installation check, and because it writes artwork into Steam’s own artwork folder by app ID, it works with either Steam package. Restarting Steam after applying art is the step most people miss.
Will custom artwork survive a reinstall?
Steam stores custom artwork in a grids folder inside your Steam user data, keyed by app ID. Copy that folder into a new installation and the art comes with it. Without the copy, re-running BoilR or Steam ROM Manager rebuilds most of it automatically.
What if a game has no artwork on SteamGridDB?
It happens with obscure titles. You can set any image yourself through Steam’s own custom artwork option, or upload an image to the game’s SteamGridDB entry so the next person finds it — that is how the gaps in the database get closed.
Final verdict
SteamGridDB is the missing half of a Linux Steam library: Steam provides the shelf, and this database provides the covers for everything Steam did not sell you. SGDBoop is the right default on a desktop, the Decky plugin is the right default on a Steam Deck, and the managers are the right answer at bulk scale. Set it up once, and a mixed library finally looks like one collection.











