mirror of
https://github.com/djibux/BoilR.git
synced 2026-09-01 05:53:41 +02:00
Update readme
This commit is contained in:
@@ -2,29 +2,32 @@
|
|||||||
|
|
||||||
## Description
|
## Description
|
||||||
|
|
||||||
This little tool will synchronize games from other platforms into your Steam library, using the Steam Shortcuts feature.
|
This little tool will show games from other games platforms in your Steam library.
|
||||||
The goal is that you do not have to leave your Steam library to launch games from other launchers/stores.
|
It uses the Steam 3rd party shortcuts feature and does not require you to set up anything.
|
||||||
If you set it up, it will also download artwork from [SteamGridDB](https://www.steamgriddb.com/).
|
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 BoilR up to automatically download artwork from [SteamGridDB](https://www.steamgriddb.com/).
|
||||||
|
|
||||||
## Features
|
## Features
|
||||||
|
|
||||||
- [x] [Legendary](https://github.com/derrod/legendary) integration
|
- [x] Show games from other platforms in your steam library
|
||||||
- [x] [Epic Games Store](https://www.epicgames.com/) integration
|
- [x] Automatically download art from [SteamGridDB](https://www.steamgriddb.com/)
|
||||||
- [x] [Itch.io](https://itch.io/app) integration
|
- [x] Cross Platform (Windows, Linux, Mac, Steam Deck)
|
||||||
- [x] [Origin](https://www.origin.com) integration
|
- [x] Standalone / No install needed
|
||||||
- [x] [GOG](https://www.gog.com/galaxy) integration
|
|
||||||
- [x] [UPlay](https://ubisoftconnect.com) integration
|
|
||||||
- [x] [Lutris](https://github.com/lutris/lutris) integration
|
|
||||||
- [x] Download art from [SteamGridDB](https://www.steamgriddb.com/)
|
|
||||||
- [x] Cross Platform (Windows, Linux, Mac)
|
|
||||||
- [x] Steam Deck support
|
|
||||||
- [x] UI For configuration
|
|
||||||
- [x] Small (~1.5mb on disk)
|
- [x] Small (~1.5mb on disk)
|
||||||
- [x] Lightweight (~2mb ram)
|
- [x] Lightweight (~2mb ram)
|
||||||
- [x] Fast synchronization (~30ms)
|
- [x] Fast synchronization (~1 second)
|
||||||
- [x] Fast art download (as fast as your internet will take you)
|
|
||||||
|
## Integrations
|
||||||
|
|
||||||
|
- [x] [Epic Games Store](https://www.epicgames.com/)
|
||||||
|
- [x] [Itch.io](https://itch.io/app)
|
||||||
|
- [x] [Origin](https://www.origin.com)
|
||||||
|
- [x] [GOG](https://www.gog.com/galaxy)
|
||||||
|
- [x] [UPlay](https://ubisoftconnect.com)
|
||||||
|
- [x] [Lutris](https://github.com/lutris/lutris)
|
||||||
|
- [x] [Legendary](https://github.com/derrod/legendary)
|
||||||
|
- [x] [Heroic Launcher](https://github.com/Heroic-Games-Launcher/HeroicGamesLauncher)
|
||||||
- [ ] XBox/Microsoft Store integration
|
- [ ] XBox/Microsoft Store integration
|
||||||
- [ ] Scheduling of synchronization
|
|
||||||
|
|
||||||
|
|
||||||
## Beta
|
## Beta
|
||||||
@@ -41,20 +44,20 @@ Feel free to submit issues and pull requests.
|
|||||||
## Getting cover art for your shortcuts
|
## Getting cover art for your shortcuts
|
||||||
|
|
||||||
- Get a [SteamGridDB API key](https://www.steamgriddb.com/profile/preferences/api)
|
- Get a [SteamGridDB API key](https://www.steamgriddb.com/profile/preferences/api)
|
||||||
- For the CLI version, Write it in the `config.toml` file (see how in the [config section](#configuration)).
|
- Write it in the `config.toml` file (see how in the [config section](#configuration)).
|
||||||
- for the Ui version , copy it into the auth key input.
|
- If you are using the Ui version just put it into the auth key input.
|
||||||
- Run the executable again
|
- Run the executable again
|
||||||
|
|
||||||
## Configuration
|
## Configuration
|
||||||
|
|
||||||
The tool reads its configuration from a `config.toml` file.
|
The tool reads its configuration from a `config.toml` file. If it cannot find one, it will create a default one on its first run.
|
||||||
You can either manually edit this file or use the UI version to changing these configurations.
|
You can either manually edit this file or use the UI version to changing these configurations.
|
||||||
|
|
||||||
Here is a simple example of how to write the config file:
|
Here is a simple example of how to write the config file:
|
||||||
|
|
||||||
```toml
|
```toml
|
||||||
[steamgrid_db]
|
[steamgrid_db]
|
||||||
auth_key="your steamgrid db auth key"
|
auth_key="Write your authentication key between these quotes"
|
||||||
```
|
```
|
||||||
|
|
||||||
And here is a full example of all configuration options:
|
And here is a full example of all configuration options:
|
||||||
@@ -67,24 +70,24 @@ location="C:\\ProgramData\\Epic\\EpicGamesLauncher\\Data\\Manifests" #If this va
|
|||||||
create_symlinks = true #Only for Linux, To get around a bug in steam where paths can not contain spaces, BoilR creates symlinks in ~/.boilr/link and uses those.
|
create_symlinks = true #Only for Linux, To get around a bug in steam where paths can not contain spaces, BoilR creates symlinks in ~/.boilr/link and uses those.
|
||||||
|
|
||||||
[legendary]
|
[legendary]
|
||||||
enabled=false #On windows this is default false, on linux default true
|
enabled=true
|
||||||
executable="legendary" #If this value is not defined, "legendary" will be used, it is assumed to be on the path.
|
executable="legendary" #The name of the "legendary" executable will be used, it is assumed to be on the path.
|
||||||
|
|
||||||
[lutris]
|
[lutris]
|
||||||
enabled=true #Default true
|
enabled=true
|
||||||
executable="lutris" #The executable to run for lutris, default is "lutris".
|
executable="lutris" #The executable to run for lutris, default is "lutris".
|
||||||
|
|
||||||
[itch]
|
[itch]
|
||||||
enabled=false #Default false
|
enabled=true
|
||||||
location="C:\\Users\\user\\AppData\\Roaming\\itch" #If this value is not defined, "%APPDATA%itch" will be used on windows, and HOME/.config/itch on linux.
|
location="C:\\Users\\user\\AppData\\Roaming\\itch" #If this value is not defined, "%APPDATA%itch" will be used on windows, and HOME/.config/itch on linux.
|
||||||
create_symlinks = true #Only for Linux, To get around a bug in steam where paths can not contain spaces, BoilR creates symlinks in ~/.boilr/link and uses those.
|
create_symlinks = true #Only for Linux, To get around a bug in steam where paths can not contain spaces, BoilR creates symlinks in ~/.boilr/link and uses those.
|
||||||
|
|
||||||
[origin]
|
[origin]
|
||||||
enabled=false #Default false
|
enabled=true
|
||||||
location="C:\\ProgramData\\Origin" #If this value is not defined, "%PROGRAMGDATA%origin" will be used on windows, and HOME/Games/origin/drive_c/ProgramData/Origin/ on linux.
|
location="C:\\ProgramData\\Origin" #If this value is not defined, "%PROGRAMGDATA%origin" will be used on windows, and HOME/Games/origin/drive_c/ProgramData/Origin/ on linux.
|
||||||
|
|
||||||
[gog]
|
[gog]
|
||||||
enabled=false #Default false
|
enabled=true
|
||||||
location="C:\\ProgramData\\GOG.com\\Galaxy" #The location of GOG Galaxy will default to this value if not defined on windows and "~/Games/gog-galaxy/drive_c/ProgramData/GOG.com/Galaxy" on linux.
|
location="C:\\ProgramData\\GOG.com\\Galaxy" #The location of GOG Galaxy will default to this value if not defined on windows and "~/Games/gog-galaxy/drive_c/ProgramData/GOG.com/Galaxy" on linux.
|
||||||
create_symlinks = true #Only for Linux, To get around a bug in steam where paths can not contain spaces, BoilR creates symlinks in ~/.boilr/link and uses those.
|
create_symlinks = true #Only for Linux, To get around a bug in steam where paths can not contain spaces, BoilR creates symlinks in ~/.boilr/link and uses those.
|
||||||
wine_c_drive="/home/username/Games/gog-galaxy/drive_c" #Only for Linux, Is mandatory on linux.
|
wine_c_drive="/home/username/Games/gog-galaxy/drive_c" #Only for Linux, Is mandatory on linux.
|
||||||
@@ -100,12 +103,12 @@ prefer_animated = false #If true, animated images will be prefered over static i
|
|||||||
|
|
||||||
## Tips for Linux
|
## Tips for Linux
|
||||||
|
|
||||||
If you are on linux, and want to use one of the launchers that is not available natively, i suggest you use Lutris and make sure that the BoilR integration for Lutris is enabled (see config section). If you want to avoid launching into Lutris here here are a few ways that you can do that.
|
If you are on Linux, and want to use one of the launchers that is not available natively, I suggest you use Lutris and make sure that the BoilR integration for Lutris is enabled (it is by default, see config section). If you want to avoid launching into Lutris, here are a few ways that you can do that.
|
||||||
|
|
||||||
### GOG
|
### GOG
|
||||||
|
|
||||||
- Install [Lutris](https://lutris.net/)
|
- Install [Lutris](https://lutris.net/)
|
||||||
- Install GOG thourgh Lutris [here](https://lutris.net/games/gog-galaxy/)
|
- Install GOG from Lutris [here](https://lutris.net/games/gog-galaxy/)
|
||||||
- Set the path to GOG in the config.toml (or through the ui)
|
- Set the path to GOG in the config.toml (or through the ui)
|
||||||
- Run BoilR
|
- Run BoilR
|
||||||
- Remember to pick which version of Proton you want to use for a game, before the first time you play it.
|
- Remember to pick which version of Proton you want to use for a game, before the first time you play it.
|
||||||
@@ -115,15 +118,18 @@ If you are on linux, and want to use one of the launchers that is not available
|
|||||||
I recommend you just use [Legendary](https://github.com/derrod/legendary). But if you really really want to use EGS you can:
|
I recommend you just use [Legendary](https://github.com/derrod/legendary). But if you really really want to use EGS you can:
|
||||||
|
|
||||||
- Install [Lutris](https://lutris.net/)
|
- Install [Lutris](https://lutris.net/)
|
||||||
- Install EGS thourgh Lutris [here](https://lutris.net/games/epic-games-store/)
|
- Install EGS from Lutris [here](https://lutris.net/games/epic-games-store/)
|
||||||
- Set the path to EGS in the config.toml (or through the ui)
|
- Set the path to EGS in the config.toml (or through the ui)
|
||||||
- Run BoilR
|
- Run BoilR
|
||||||
- Remember to pick which version of Proton you want to use for a game, before the first time you play it.
|
- Remember to pick which version of Proton you want to use for a game, before the first time you play it.
|
||||||
|
|
||||||
### Origin
|
### Origin
|
||||||
|
|
||||||
Here i just suggest you use [Lutris](https://lutris.net/games/origin/)
|
Here I just suggest you use [Lutris](https://lutris.net/games/origin/)
|
||||||
|
|
||||||
|
## What is up with the name BoilR?
|
||||||
|
|
||||||
|
This tool turns things into Steam, therefor boiler, And it is written in **R**urst so therefor: BoilR
|
||||||
|
|
||||||
## License
|
## License
|
||||||
|
|
||||||
|
|||||||
Reference in New Issue
Block a user