Skip to content

Latest commit

 

History

History
151 lines (111 loc) · 8.45 KB

Readme.md

File metadata and controls

151 lines (111 loc) · 8.45 KB

BoilR

BoilR automatically adds (almost) all your games to your Steam library (including image art).

BoilR Screenshot BoilR Images Screenshot

It uses the Steam 3rd party shortcuts feature and does not require you to set up anything. The goal is that you do not have to leave your Steam library to launch games from other launchers/stores, so that you can find all the games that you have available. Optionally, you can set up BoilR to automatically download artwork from SteamGridDB.

Getting started

  • Download the latest release from the releases page.
  • Run the executable.
    • if you are on a Steam Deck, right click and mark it "executable" under properties
  • Click Import Games.
  • Restart Steam to see your new shortcuts.

If you are on Linux (or a Steam Deck) you can install BoilR from flathub. Be aware that the flatpak version has some limitations compared to the native version. There is also an AUR package

Index

Features

  • Show games from other platforms in your steam library
  • Automatically download art from SteamGridDB
  • Customize your Steam games art
  • Backup your shortcuts
  • Cross Platform (Windows, Linux, Mac, Steam Deck)
  • Standalone / No install needed
  • Small (~3mb on disk)
  • Lightweight (~30mb ram)
  • Fast synchronization (~1 second)

Integrations

BoilR can import games from many platforms, but there are limits based

Platforms Windows Linux (executable) Linux (flatpak)
Epic Games Store Yes Yes, install through proton Yes, install through proton
Itch.io (Windows Games) Yes No No
Itch.io (Linux Games) No Yes Yes
Origin Yes Yes, install through proton Yes, install through proton
GOG Yes No (Use Heroic or MiniGalaxy) No (Use Heroic or MiniGalaxy)
UPlay Yes Yes Yes
Lutris (Flatpak) No Yes Yes (make sure Lutris is shut down first)
Lutris (Non-Flatpak) No Yes Yes
Legendary No Yes Yes
Rare No Yes Yes
Heroic Launcher No Yes Yes
Amazon Games Yes No No
Flatpaks No Yes Yes
Bottles No Yes Yes
MiniGalaxy No Yes Yes
Playnite Yes No No
Game Pass Yes No No

Getting cover art for your shortcuts

  • Get a SteamGridDB API key
  • Run BoilR
  • Put the auth key in the input in the settings
  • Click "Import games"

Tips

Tips for Linux

If you are running Linux (this includes Steam Deck) and are running into problems check tips for Linux section

Configuration

Most people will not have to configure anything, just open BoilR and click Import Games, but it is possible to configure a lot, see the configuration section

Run as CLI

In previous releases there was both a CLI and UI version of BoilR, now there is only a UI version. But you can add the commandline argument --no-ui and then the UI version will act like the old CLI version. This saves some CO2 from not having to build 2 versions of BoilR for each platform, and it also makes development easier.

Rename shortcuts

You can rename a shortcut from BoilR by double clicking it from the import list and picking a new name. If you want to revert back to the original name, just clear the name and click rename.

Try the native version over the flatpak

In general, the native (downloaded form the releases page) version of BoilR is the more reliable one. If you experience bugs or errors please try the native version and see if that fixes your problem.

Contributions

How can I help/contribute?

If you are a coder, you are very welcome! You can fork this repo and then create a pull request.

To check formats and errors of code before run the code:

cargo fmt

cargo check

To run BoilR just write:

cargo run

If you are not a developer (or you don't like to code in Rust) do spread the work and create issues/discussions for anything.

I found a bug, what do I do?

Check that there is not already an issue for it here If not, create a new issue and I will have a look at it (remember to write which OS you are using).

I have a great idea / I would like support for a specific platform, what do I do?

Check out the discussions and feel free to create new discussions for your idea.

Can I donate to support BoilR?

Nope, please don't, donate it to your favorite charity instead, and if you don't have one of those may I suggest something like GiveWell.

License

This project is dual license MIT or Apache 2.0 , it is up to you. In short, you can do what you want with this project, but if in doubt read the license files.

What is up with the name BoilR?

This tool turns things into Steam, therefor boiler, And it is written in Rust so therefor: BoilR