- Top Pick: Valve Steam Deck OLED 512GB
- Runner-up: WD_BLACK SN850X 2TB NVMe SSD
- Also consider: Samsung T9 Portable SSD 2TB
A Linux game library rarely lives in one place. Some games sit in Heroic, others in Lutris, a few in the itch app, some inside Bottles, and Steam only knows about the ones bought on Steam. Browsing that split collection means remembering which launcher owns which game, and in Big Picture or on a Steam Deck most of it is invisible, because Steam’s couch interfaces only show what Steam itself can see.
BoilR is a small open-source utility, written in Rust and dual-licensed under MIT and Apache 2.0, that closes the gap. It scans the launchers on your system, writes the games it finds into Steam as non-Steam shortcuts, and can download matching cover art from SteamGridDB in the same pass. This guide explains what it imports on Linux, how the flow works, where detection stops helping, and how it differs from Steam ROM Manager and adding shortcuts by hand.
As an Amazon Associate, we earn from qualifying purchases.
Quick answer
BoilR is a free open-source tool that scans Heroic, Lutris, itch.io, Bottles and several other launchers on Linux, then adds the games it finds to Steam as non-Steam shortcuts with one button press. Add a free SteamGridDB API key in its settings and it downloads cover art during the same import. It creates shortcuts only; the original launchers still install, update and launch the games.
What BoilR actually does
BoilR works through Steam’s built-in third-party shortcuts feature, the same mechanism behind the Add a Non-Steam Game menu item. Instead of adding entries one at a time, it reads the libraries of other launchers and writes every missing game into Steam’s shortcuts file, after which you restart Steam so the entries appear. Nothing is moved or reinstalled: each shortcut points at the launcher or executable that already runs the game.
The project describes BoilR as a standalone download of a few megabytes that finishes a synchronisation in about a second, and it can back up your existing shortcuts before changing them. Because the entries are ordinary Steam shortcuts, everything Steam layers on top still applies: per-game Proton settings, controller layouts, categories, and the Big Picture and Steam Deck interfaces.
What BoilR can import on Linux
The project’s integration list is long, and on Linux it covers most launchers people actually use:
- Heroic Games Launcher, plus Legendary and Rare, two Epic front ends
- Lutris, in both its Flatpak and regular installs; shut Flatpak Lutris down before importing, per the docs
- The Epic Games Store and the EA app, when they are installed through Proton
- Ubisoft Connect
- The itch.io app, for Linux games; a Windows itch library cannot be read from Linux
- Bottles, MiniGalaxy, and Flatpak applications themselves
The notable gap is GOG: BoilR has no direct GOG import on Linux, and the project tells Linux users to route GOG libraries through Heroic or MiniGalaxy instead. Amazon Games, Playnite and Game Pass integrations exist only on Windows. Detection is automatic but not magic: BoilR looks in the standard install locations, so a launcher installed somewhere unusual may need its path set in BoilR’s settings first.
Installing BoilR and running your first import
Linux users get three routes. The standalone binary from the project’s releases page is the one the documentation recommends as the more reliable option; on a Steam Deck you mark the file as executable and run it. The Flatpak from Flathub is the convenient route for standard setups, with some limitations covered below. Arch-based systems also have a community AUR package, and a BoilR 2.0 beta with a Deck-friendly touch interface is available through the Flathub beta channel.
The import itself is plain. Open BoilR and it lists the games it found, grouped by platform. Untick anything you do not want, rename any shortcut whose title you dislike, then click Import Games and restart Steam. Re-running BoilR after installing something new is safe, because it only adds shortcuts that are missing. For stores installed through Proton, the project’s Linux tips add one manual step: pick the Proton version for a game in its shortcut properties before first playing it.
Artwork: the SteamGridDB API key step
Without a key, imported games arrive with blank tiles. The fix is a one-time setup: create a SteamGridDB account, generate the free API key from your profile page while signed in, paste it into the key field in BoilR’s settings, and import again. From then on, each import also downloads grid, hero and logo artwork for the new shortcuts, and BoilR can customise artwork for games already in your Steam library.
Artwork quality depends on the database, not on BoilR: obscure itch.io releases may have no volunteer-uploaded art at all, and those shortcuts keep a plain tile until you add an image by hand.
BoilR vs Steam ROM Manager vs adding games by hand
All three approaches write to the same Steam shortcuts system; the choice is about effort and control.
BoilR is the automatic route. For a standard setup there is nothing to configure: it knows where each launcher keeps its library, finds the games, and imports them with their artwork. The trade-off is control: you get a list with tick boxes and renaming, not parsers, rules or per-folder logic.
Steam ROM Manager is the configurable route. You build or adjust parsers for each source, preview exactly what will be created, and control titles and artwork in detail. That power suits emulator collections and unusual folder layouts, where BoilR has nothing to detect, but it costs real setup time for ordinary launcher libraries.
Adding a game by hand is the precise route. You pick the exact executable, set launch options and choose a Proton version per title, which is right for one or two standalone installs. It does not scale: doing it for a whole Epic library is an evening of clicking.
The Flatpak wrinkles
Flatpaks are where most BoilR support questions come from, and the project’s Linux tips address the big one directly. If Steam itself is a Flatpak, it runs inside a sandbox and cannot start other Flatpak applications directly. BoilR detects this and writes those shortcuts so they launch through flatpak-spawn on the host instead, but Steam first needs a one-time permission grant, done with a flatpak override command from the project’s tips page, followed by a Steam restart. Without it, shortcuts to Flatpak Lutris, Bottles or Heroic installs do nothing when clicked. The Flatpak build of BoilR also sees less of your system than the native binary, which is why the documentation steers people who hit bugs toward the native release.
Honest limits
BoilR’s shortcuts are not integrations, and it is worth being clear about what that means. The source store gains no presence inside Steam: no store achievements, no store friends activity, and no cloud saves managed by Steam. Updates still happen inside the original launcher, and if Heroic or Lutris breaks, the Steam shortcut pointing at its game breaks with it. BoilR organises launching; it takes over nothing else.
Detection has edges too. Launchers in portable or relocated folders are missed until you point BoilR at them. A shortcut stores a fixed path, so moving a game or renaming a drive mount breaks the entry until it is edited or re-imported. And the Linux integration list is not the Windows list: direct GOG import is absent, and a handful of integrations do not exist here.
Gear for a library that lives in five launchers
Valve Steam Deck OLED 512GB
The Deck is where a unified library pays off most. Everything BoilR imports appears in the same Game Mode grid as your Steam purchases, artwork included, so the Epic freebie and the itch.io download sit next to everything else.
Specs:
– Display: 7.4-inch HDR OLED, 1280 by 800, up to 90 Hz
– Storage: 512 GB NVMe SSD with microSD expansion
– System: SteamOS with Game Mode and Desktop Mode
– Wireless: Wi-Fi 6E and Bluetooth
– Battery: 50 Wh
WD_BLACK SN850X 2TB NVMe SSD
On the desktop side, five launchers’ worth of installs add up quickly. A roomy Gen4 drive keeps the Heroic, Lutris and Steam libraries on one fast volume.
Specs:
– Capacity: 2 TB
– Interface: PCIe Gen4 x4, M.2 2280
– Sequential read: up to 7,300 MB/s (maker figure)
– Model: WDS200T2X0E
Samsung T9 Portable SSD 2TB
A fast portable drive is the easiest way to shuttle big installs between a desktop and a docked Deck, or to hold an overflow library.
Specs:
– Capacity: 2 TB
– Interface: USB 3.2 Gen 2×2 over USB-C
– Transfer speed: up to 2,000 MB/s (maker figure)
– Model: MU-PG2T0B/AM
SanDisk 1TB Extreme microSDXC
For Deck owners, a large microSD card is the natural home for the imported half of the library: the itch.io experiments and Epic giveaways you want installed but not on the internal drive.
Specs:
– Capacity: 1 TB
– Ratings: UHS-I, U3, V30, A2
– Read speed: up to 190 MB/s (maker figure)
– Model: SDSQXAV-1T00-GN6MA
8BitDo Ultimate 2 Bluetooth Controller
Once every game launches through Steam, one good pad can serve all of them through Steam Input. This controller pairs with the Deck, a docked setup or a desktop, and its remappable back buttons keep working across launchers because Steam owns the layout.
Specs:
– Model: 80ND
– Joysticks: TMR
– Triggers: switchable Hall effect and tactile modes
– Connectivity: Bluetooth, 2.4 GHz, wired
– Battery: 1,000 mAh, charging dock included
– Extras: two back paddles, extra bumpers, motion control
How to choose your import route
Choose BoilR if your games live in Heroic, Lutris, itch.io or Bottles in their standard locations and you want the library merged today. Choose Steam ROM Manager if you also import emulators or loose game folders, or need detailed control over names and artwork. Choose manual adding for a handful of standalone games, or one title that needs specific launch options. Whichever route you pick, back up your shortcuts first and restart Steam after any change.
Who should skip BoilR
Skip it if you buy everything on Steam, because there is nothing to import. Skip it if you expect store features inside Steam, since no shortcut tool can bring Epic achievements or GOG cloud saves with it. GOG Galaxy loyalists on Linux should also pass: there is no Galaxy route here, and your library needs to live in Heroic or MiniGalaxy first.
FAQ
Is BoilR free to use?
Yes. BoilR is open source under a dual MIT and Apache 2.0 licence, costs nothing, and the SteamGridDB API key it uses for artwork is also generated free from your account.
Does BoilR work on the Steam Deck?
Yes. Install it from Flathub or run the release binary after marking it executable. The 2.0 beta is built around the Deck, with a touch-friendly interface for Game Mode.
Why did BoilR miss some of my games?
The usual causes are a launcher in a non-standard location, a Windows-only integration such as direct GOG import on Linux, or the Flatpak build’s restricted view of the system. Setting the path in BoilR’s settings, or switching to the native build, fixes most cases.
Do imported games use Proton automatically?
The shortcut launches the same executable or launcher as before. For Windows games, you choose the Proton version in the shortcut’s Steam properties before the first launch, as with a shortcut added by hand.
Final verdict
BoilR does one narrow job with almost no friction: it finds the games your other launchers already manage and puts them in Steam, artwork included, in a single pass. It will not replace those launchers, and GOG owners need a detour through Heroic. But for the typical Linux mix of Heroic, Lutris and itch.io, it turns five libraries into one faster than adding a single game by hand. Install the native build, add the SteamGridDB key, and re-run it after every install spree.











