Launch any Heroic-Games-Launcher game using bash scripts without having to open Heroic.

Last update: Dec 27, 2022

Overview

HeroicBashLauncher

Ever wanted to launch your EGS games installed through Heroic Games Launcher directly from the terminal, Lutris or any other frontend game launcher? Heroic Bash Launcher lets you do exactly that.

You can now launch your game directly without having to open Heroic at all. There's no need to run heroic to find the game's launch command.

Pre-requisites

Heroic Games Launcher 1.10 'Kizaru'
Python 3

Working

Heroic Bash Launcher automatically detects installed games and creates a launch file for each game. The launch file is created using the bash shell script, i.e. .sh files. For example, if I have Rocket League installed, it will create the launch file titled "Sugar.sh".

Every game's launch file will contain all the launch parameters according to the game's setting in Heroic Games Launcher, including cloud syncing for supported games.

All these launch files will be available in the GamesFiles folder.

You can execute a game's launch file using the terminal like ./Sugar.sh or your preferred game launcher/manager like Lutris or EmulationStation.

Note: For now, all launch files will be titled according to how legendary names the games (AppName.sh). You can look for your preferred game's AppName by opening Heroic Games Launcher and navigating to the bottom of the game's "Settings" window.

Usage

Execute the program by running ./HeroicBashLauncher.sh in your terminal. You will be required to enable executable permissions for this file.

Keep in mind, you have to run this program everytime you change the Settings in the Heroic Games Launcher app. This helps to overwrite the old launch parameters with the new ones.

Features Planned

Name files according to the actual game name
Ask user for a default path for saving game launch files
Only update game launch files whose setting is changed
Additional game launch options support (Eg. ARK)
Automatically update launch parameters when executing game launch file

Issues

Uninstalled games will get detected because of leftover files. (AppName.json files in ~/.config/heroic/GamesConfig)

Changelog

Version 1.0 - 18/11/21

License

This project is under the GNU GPLv3 license. You can take a look at the LICENSE.md for more information.

Comments

[Bug] HBL Modifies shortcuts.vdf incorrectly
Before posting this issue, make sure you've read the Issues section in the Readme and the Flatpak/Steam-Deck guide.

Describe the bug I'm the dev for Steam ROM Manager. I've noticed that several users that also use HBL are experiencing bugs in SRM.

The reason is the way that the steam file shortcuts.vdf gets modified by HBL. The structure of shortcuts.vdf (once converted to a JSON) should be

{ "shortcuts": [ 0: {...}, //app1 ... ] }

But instead it's

{ "shortcuts": { "": {...} } }

Since SRM expects an array under "shortcuts", it breaks when trying to push things to it. Perhaps HBL is handling this incorrectly when the user is only adding a single game to Steam?

To Reproduce Not sure because I don't use HBL. But basically, add (maybe just one) game to steam with HBL then try to use SRM (or other similar tools).

Expected behavior Shortcuts.vdf readable and writeable by SRM after being modified by HBL.

Screenshots Here is the jsonified version of a shortcuts.vdf file that has been modified by HBL, as seen in SRM:

Details

Platform: Any

OS: Any

Heroic Version: Not sure

Bash Launcher Version: Not sure

bug
opened by cbartondock 47
[Bug] v2.6.0 Flatpak GLIBC error on Steam Deck
To Reproduce Steps to reproduce the behavior:

Download https://github.com/redromnon/HeroicBashLauncher/releases/download/v2.6.0/HeroicBashLauncher-2.6.0.zip

Extract and run setup.sh

No success message

Find error in HeroicBashLauncher.log

[97233] Error loading Python lib '/tmp/_MEI4ps1Eb/libpython3.10.so.1.0': dlopen: /usr/lib/libm.so.6: version `GLIBC_2.35' not found (required by /tmp/_MEI4ps1Eb/libpython3.10.so.1.0)

Expected behavior Success message.

Details

Platform: Steam Deck

OS: Steam OS

Heroic Version: v2.3.1 Flatpak

Bash Launcher Version: v2.6.0
opened by carn1x 39
Game not launching from SteamDeck UI

Sorry to post this here since my bet is it's not even an issue with the shell script you're generating, but on the off chance that it is....

When trying to run Hades using the latest AppImage relase (HeroicBashLauncher_AppImage_2.2.5 and latest Heroic Launcher) it will launch from terminal AND launch from the Steam UI from Desktop, but it will NOT launch from the SteamDeckUI. Is there a good way to debug this? I can post the steam logs when running steam in terminal and launching hades from there, but it works in that scenario...
steam deck heroic

opened by ajbucci 29
gameoverlayrenderer.so error

ArchLinux using appImage fresh install, both os and launcher

steps:

./setup.sh ./Addtosteam.sh

run steam press play

RocketLeague_Heroic.log

rocket league launcher script delete itself after the error
documentation

opened by A-w-x 22
[Bug] Can't launch any game with Steam Proton
Before posting this issue, make sure you've read the Issues section in the Readme and the Flatpak/Steam-Deck guide.

Describe the bug I can launch games from Heroic Game Launcher, but i can't launch any game inyected by HeroicBashLauncher

To Reproduce Steps to reproduce the behavior:

Execute setup.sh

Execute any game.sh

Error

Execute setup.sh

Launch Steam Deck Mode

Launch any inyected game

Error

Expected behavior The game is launched

Screenshots If applicable, add screenshots to help explain your problem.

Details

Platform: Steam Deck

OS: SteamOS Holo 3.2

Heroic Version: v2.3.0-beta.3 Flatpak

Bash Launcher Version: v2.5.0 Flatpak

Proton 7.0

Additional context Log file: ` Gtk-Message: 13:34:54.553: Failed to load module "canberra-gtk-module" 3.32.0

Running launch command for Absolute Drift: STEAM_COMPAT_CLIENT_INSTALL_PATH=/home/deck/.var/app/com.heroicgameslauncher.hgl/.steam/steam STEAM_COMPAT_DATA_PATH=/AbsoluteDrift /app/bin/heroic/resources/app.asar.unpacked/build/bin/linux/legendary launch 19927295d6e3467887d4e830d8c85963 --no-wine --wrapper "/home/deck/.steam/steam/steamapps/common/Proton 7.0/proton run" [cli] INFO: Logging in... [Core] INFO: Trying to re-use existing login session... [cli] INFO: Checking for updates... [Core] INFO: Getting authentication token... [cli] INFO: Launching 19927295d6e3467887d4e830d8c85963... Traceback (most recent call last): File "legendary/cli.py", line 3004, in File "legendary/cli.py", line 2919, in main File "legendary/cli.py", line 685, in launch_game File "subprocess.py", line 858, in init File "subprocess.py", line 1704, in _execute_child FileNotFoundError: [Errno 2] No such file or directory: '/home/deck/.steam/steam/steamapps/common/Proton' [9] Failed to execute script 'cli' due to unhandled exception! ---CANNOT CONNECT TO NETWORK. RUNNING IN OFFLINE MODE--- [cli] INFO: Launching 19927295d6e3467887d4e830d8c85963... Traceback (most recent call last): File "legendary/cli.py", line 3004, in File "legendary/cli.py", line 2919, in main File "legendary/cli.py", line 685, in launch_game File "subprocess.py", line 858, in init File "subprocess.py", line 1704, in _execute_child FileNotFoundError: [Errno 2] No such file or directory: '/home/deck/.steam/steam/steamapps/common/Proton' [15] Failed to execute script 'cli' due to unhandled exception! Gtk-Message: 13:34:56.694: Failed to load module "canberra-gtk-module"

** (zenity:19): WARNING **: 13:34:56.817: AT-SPI: Could not obtain desktop path or name

** (zenity:19): WARNING **: 13:34:56.831: AT-SPI: Could not obtain desktop path or name

** (zenity:19): WARNING **: 13:34:56.831: atk-bridge: get_device_events_reply: unknown signature

** (zenity:19): WARNING **: 13:34:56.832: atk-bridge: get_device_events_reply: unknown signature

** (zenity:19): WARNING **: 13:34:56.832: atk-bridge: GetRegisteredEvents returned message with unknown signature

** (zenity:19): WARNING **: 13:34:56.843: AT-SPI: Could not obtain desktop path or name

** (zenity:19): WARNING **: 13:34:56.844: atk-bridge: get_device_events_reply: unknown signature

** (zenity:19): WARNING **: 13:34:56.844: atk-bridge: get_device_events_reply: unknown signature

** (zenity:19): WARNING **: 13:34:56.844: atk-bridge: GetRegisteredEvents returned message with unknown signature Using Bash Launcher 2.5.0

Checking if Zenity is installed: `

` ERROR: ld.so: object '/home/deck/.local/share/Steam/ubuntu12_32/gameoverlayrenderer.so' from LD_PRELOAD cannot be preloaded (wrong ELF class: ELFCLASS32): ignored. ERROR: ld.so: object '/home/deck/.local/share/Steam/ubuntu12_32/gameoverlayrenderer.so' from LD_PRELOAD cannot be preloaded (wrong ELF class: ELFCLASS32): ignored. ERROR: ld.so: object '/home/deck/.local/share/Steam/ubuntu12_32/gameoverlayrenderer.so' from LD_PRELOAD cannot be preloaded (wrong ELF class: ELFCLASS32): ignored. ERROR: ld.so: object '/home/deck/.local/share/Steam/ubuntu12_32/gameoverlayrenderer.so' from LD_PRELOAD cannot be preloaded (wrong ELF class: ELFCLASS32): ignored. ERROR: ld.so: object '/home/deck/.local/share/Steam/ubuntu12_32/gameoverlayrenderer.so' from LD_PRELOAD cannot be preloaded (wrong ELF class: ELFCLASS32): ignored. ERROR: ld.so: object '/home/deck/.local/share/Steam/ubuntu12_32/gameoverlayrenderer.so' from LD_PRELOAD cannot be preloaded (wrong ELF class: ELFCLASS32): ignored. ERROR: ld.so: object '/home/deck/.local/share/Steam/ubuntu12_32/gameoverlayrenderer.so' from LD_PRELOAD cannot be preloaded (wrong ELF class: ELFCLASS32): ignored. 3.32.0 ERROR: ld.so: object '/home/deck/.local/share/Steam/ubuntu12_32/gameoverlayrenderer.so' from LD_PRELOAD cannot be preloaded (wrong ELF class: ELFCLASS32): ignored.

Running launch command for Death Stranding: STEAM_COMPAT_CLIENT_INSTALL_PATH=/home/deck/.var/app/com.heroicgameslauncher.hgl/.steam/steam STEAM_COMPAT_DATA_PATH=/DeathStranding /app/bin/heroic/resources/app.asar.unpacked/build/bin/linux/legendary launch Boga --no-wine --wrapper "/home/deck/.steam/steam/steamapps/common/Proton 7.0/proton run" ERROR: ld.so: object '/home/deck/.local/share/Steam/ubuntu12_32/gameoverlayrenderer.so' from LD_PRELOAD cannot be preloaded (wrong ELF class: ELFCLASS32): ignored. ERROR: ld.so: object '/home/deck/.local/share/Steam/ubuntu12_32/gameoverlayrenderer.so' from LD_PRELOAD cannot be preloaded (wrong ELF class: ELFCLASS32): ignored. ERROR: ld.so: object '/home/deck/.local/share/Steam/ubuntu12_32/gameoverlayrenderer.so' from LD_PRELOAD cannot be preloaded (wrong ELF class: ELFCLASS32): ignored. [Core] WARNING: Could not determine locale, falling back to en-US [cli] INFO: Logging in... [Core] INFO: Trying to re-use existing login session... [cli] INFO: Checking for updates... [Core] INFO: Getting authentication token... [Core] INFO: Getting ownership token. [cli] INFO: Launching Boga... Traceback (most recent call last): File "legendary/cli.py", line 3004, in File "legendary/cli.py", line 2919, in main File "legendary/cli.py", line 685, in launch_game File "subprocess.py", line 858, in init File "subprocess.py", line 1704, in _execute_child FileNotFoundError: [Errno 2] No such file or directory: '/home/deck/.steam/steam/steamapps/common/Proton' [21] Failed to execute script 'cli' due to unhandled exception! ---CANNOT CONNECT TO NETWORK. RUNNING IN OFFLINE MODE--- ERROR: ld.so: object '/home/deck/.local/share/Steam/ubuntu12_32/gameoverlayrenderer.so' from LD_PRELOAD cannot be preloaded (wrong ELF class: ELFCLASS32): ignored. ERROR: ld.so: object '/home/deck/.local/share/Steam/ubuntu12_32/gameoverlayrenderer.so' from LD_PRELOAD cannot be preloaded (wrong ELF class: ELFCLASS32): ignored. [Core] WARNING: Could not determine locale, falling back to en-US [cli] INFO: Launching Boga... Traceback (most recent call last): File "legendary/cli.py", line 3004, in File "legendary/cli.py", line 2919, in main File "legendary/cli.py", line 685, in launch_game File "subprocess.py", line 858, in init File "subprocess.py", line 1704, in _execute_child FileNotFoundError: [Errno 2] No such file or directory: '/home/deck/.steam/steam/steamapps/common/Proton' [27] Failed to execute script 'cli' due to unhandled exception! pid 25 != 18, skipping destruction (fork without exec?) pid 19 != 18, skipping destruction (fork without exec?) ERROR: ld.so: object '/home/deck/.local/share/Steam/ubuntu12_32/gameoverlayrenderer.so' from LD_PRELOAD cannot be preloaded (wrong ELF class: ELFCLASS32): ignored. Using Bash Launcher 2.5.0

Checking if Zenity is installed: `
opened by crusardri 19

Steam Deck Script Crash

HeroicBashLauncher-2.2.3_AppImage.zip Heroic-2.2.6.AppImage

Console Output:

Checking if Zenity is installed:

(process:3647): Gtk-WARNING **: 17:54:47.437: Locale not supported by C library.
        Using the fallback 'C' locale.
3.32.0

Cleaning left over game files if any...
[cli] INFO: Cleanup complete! Removed 0.00 MiB.


Done! Now creating launch files for your Epic Games library ...

Traceback (most recent call last):
  File "HeroicBashLauncher.py", line 21, in <module>
  File "listinstalled.py", line 67, in listinstalled
  File "json/__init__.py", line 293, in load
  File "encodings/ascii.py", line 26, in decode
UnicodeDecodeError: 'ascii' codec can't decode byte 0xe2 in position 1991: ordinal not in range(128)
[3646] Failed to execute script 'HeroicBashLauncher' due to unhandled exception!

SteamOS:

Operating System: SteamOS snapshot
KDE Plasma Version: 5.23.5
KDE Frameworks Version: 5.90.0
Qt Version: 5.15.2
Kernel Version: 5.13.0-valve10.1-1-neptune-02144-g7fffaf925dfb (64-bit)
Graphics Platform: X11
Processors: 8 × AMD Custom APU 0405
Memory: 14,5 GiB of RAM
Graphics Processor: AMD Custom GPU 0405

bug steam deck

opened by Battleangel 19

Heroic games not added to steam automatically - Steam Deck

Script was able to find the installed game and created the launch script, however the game was not automatically added to steam. The launch script was created at the same level as the BashLauncer and not in the GamesFiles directory.

Output from terminal:

([email protected] HeroicBashLauncher-2.2.0)$ ./HeroicBashLauncher 
Checking if Zenity is installed:
3.32.0

Cleaning left over game files if any...
sh: line 1: /run/media/mmcblk0p1/heroic/HeroicBashLauncher-2.2.0/binaries/legendary: No such file or directory


Done! Now creating launch files for your Epic Games library ...

Enter the Gungeon [Garlic]...


...Process finished. Launch files stored in GameFiles folder.
Have fun gaming!

bug

opened by BoxenOfDonuts 19

[Bug] Install script exits saying that it isn't in `~/Games/Heroic` when it is.
I've read the Issues section in the Readme and the Flatpak/Steam-Deck guide.

Describe the bug Install script exits saying that it isn't in ~/Games/Heroic when it is.

To Reproduce (First Screenshot)

Expected behavior Begin installation

Screenshots

Details

Platform: Desktop

OS: Arch

Heroic Version: heroic-games-launcher-bin 2.3.9-2 (from AUR)

Bash Launcher Version: v2.8.0

Additional context I have my heroic directory placed in /opt/games/heroic/javalsai, but I tried two things:

Creating a symlink (~/Games/Heroic -> /opt/games/heroic/javalsai)

Creating and empty directory in ~/Games/Heroic

Both failed with the same error (in the screenshot I tried symlink method).
opened by javalsai 18
[bug] Error message when trying to run HeroicBashLauncher binary with GoG games installed
Description

When attempting to run the HeroicBashLauncher with a GoG game installed in the Heroic Games Launcher, I get prompted with a Make sure you are running Heroic and try again prompt. Once I uninstall the GoG game, it runs without any issues. No GOG .sh files are present in the GameFiles directory

Launcher info

Heroic Games Launcher v2.2.1 AppImage (Legendary binary manually specified in settings) HeroicBashLauncher v2.0 Legendary 0.20.25

Machine Info

PopOS 21.10, kernel 5.16 Ryzen 5980hs, Nvidia 3050ti

When run in Terminal

$ ./HeroicBashLauncher Checking if Zenity is installed: 3.32.0 Cleaning left over game files if any... sh: 1: /opt/Heroic/resources/app.asar.unpacked/build/bin/linux/legendary: not found Done! Now creating launch files for your Epic Games library ... Cris Tales [e7d92786abe54fae9319c1ddb94ae271]... Done! Now creating launch files for your GOG library ... Journey to the Savage Planet [1519147341]... # error prompt here, after clicking ok in error prompt, it exits

Video of bug

CrisTales is from Epic Games Journey to the Savage Planet is from GOG

https://user-images.githubusercontent.com/9145965/156679150-89e41b39-955b-421c-a05d-a002c032d558.mp4
bug
opened by aarron-lee 18
Flatpak generated sh files do not run on Steam Deck

I am using 2.2.0-Flatpak. I manually added the sh files to Steam because they were not automatically added (Issue #18).

Running them in the Deck UI fails after pressing the Play button.

Running the sh file from Dolphin does not show any actions.

Running the sh file from by right clicking and running in terminal gives the error:

bwrap: execvp ./HeroicBashLauncher: No such file or directory
bug

opened by outphase 17
[Bug] Failed to launch Fall Guys Please check the game log under GameFiles/logs/ in the HeroicBashLauncher folder for the error and consider reporting it as an issue on GitHub.

Hi, i'm on POP OS, I have this when i try to start Fall Guys : Failed to launch Fall Guys

Please check the game log under GameFiles/logs/ in the HeroicBashLauncher folder for the error and consider reporting it as an issue on GitHub.

and log file is :

ERROR: ld.so: object '/home/dorian/.steam/ubuntu12_32/gameoverlayrenderer.so' from LD_PRELOAD cannot be preloaded (wrong ELF class: ELFCLASS32): ignored. ERROR: ld.so: object '/home/dorian/.steam/ubuntu12_32/gameoverlayrenderer.so' from LD_PRELOAD cannot be preloaded (wrong ELF class: ELFCLASS32): ignored. ERROR: ld.so: object '/home/dorian/.steam/ubuntu12_32/gameoverlayrenderer.so' from LD_PRELOAD cannot be preloaded (wrong ELF class: ELFCLASS32): ignored. ERROR: ld.so: object '/home/dorian/.steam/ubuntu12_32/gameoverlayrenderer.so' from LD_PRELOAD cannot be preloaded (wrong ELF class: ELFCLASS32): ignored. 3.42.1 ERROR: ld.so: object '/home/dorian/.steam/ubuntu12_32/gameoverlayrenderer.so' from LD_PRELOAD cannot be preloaded (wrong ELF class: ELFCLASS32): ignored. ERROR: ld.so: object '/home/dorian/.steam/ubuntu12_32/gameoverlayrenderer.so' from LD_PRELOAD cannot be preloaded (wrong ELF class: ELFCLASS32): ignored. ERROR: ld.so: object '/home/dorian/.steam/ubuntu12_32/gameoverlayrenderer.so' from LD_PRELOAD cannot be preloaded (wrong ELF class: ELFCLASS32): ignored. ERROR: ld.so: object '/home/dorian/.steam/ubuntu12_32/gameoverlayrenderer.so' from LD_PRELOAD cannot be preloaded (wrong ELF class: ELFCLASS32): ignored. Using Bash Launcher v2.7.5 NOTE - This is an independent project and not affiliated with Heroic Games Launcher.

Checking if Zenity is installed... ERROR: ld.so: object '/home/dorian/.steam/ubuntu12_32/gameoverlayrenderer.so' from LD_PRELOAD cannot be preloaded (wrong ELF class: ELFCLASS32): ignored. ERROR: ld.so: object '/home/dorian/.steam/ubuntu12_32/gameoverlayrenderer.so' from LD_PRELOAD cannot be preloaded (wrong ELF class: ELFCLASS32): ignored. ERROR: ld.so: object '/home/dorian/.steam/ubuntu12_32/gameoverlayrenderer.so' from LD_PRELOAD cannot be preloaded (wrong ELF class: ELFCLASS32): ignored. ERROR: ld.so: object '/home/dorian/.steam/ubuntu12_32/gameoverlayrenderer.so' from LD_PRELOAD cannot be preloaded (wrong ELF class: ELFCLASS32): ignored. ./launchflatpakgame.sh: line 12: /home/dorian/Games/Heroic/HeroicBashLauncher-2.7.5/binaries/legendary: No such file or directory pid 4 != 2, skipping destruction (fork without exec?) ---CANNOT CONNECT TO NETWORK. RUNNING IN OFFLINE MODE--- ./launchflatpakgame.sh: line 12: /home/dorian/Games/Heroic/HeroicBashLauncher-2.7.5/binaries/legendary: No such file or directory pid 6 != 2, skipping destruction (fork without exec?) pid 5 != 2, skipping destruction (fork without exec?) pid 3 != 2, skipping destruction (fork without exec?) ERROR: ld.so: object '/home/dorian/.steam/ubuntu12_32/gameoverlayrenderer.so' from LD_PRELOAD cannot be preloaded (wrong ELF class: ELFCLASS32): ignored. Gtk-Message: 23:45:39.148: Failed to load module "appmenu-gtk-module" Gtk-Message: 23:45:39.205: Failed to load module "canberra-gtk-module" Gtk-Message: 23:45:39.205: Failed to load module "canberra-gtk-module"

(zenity:8): Gdk-CRITICAL **: 23:47:13.790: gdk_cursor_new_from_pixbuf: assertion 'GDK_IS_PIXBUF (pixbuf)' failed pid 7 != 2, skipping destruction (fork without exec?) ERROR: ld.so: object '/home/dorian/.steam/ubuntu12_32/gameoverlayrenderer.so' from LD_PRELOAD cannot be preloaded (wrong ELF class: ELFCLASS32): ignored. ERROR: ld.so: object '/home/dorian/.steam/ubuntu12_32/gameoverlayrenderer.so' from LD_PRELOAD cannot be preloaded (wrong ELF class: ELFCLASS32): ignored. wineserver stopped Fall Guys stopped

This is a bug or it's me ?

Thx

opened by dodolereporter 15
Improve checkbinary to attempt to find heroic binary on PATH
Hello, thanks for this great tool. I've been using it for awhile now on my Fedora Linux system to quickly launch games from Steam while using the RPM-packaged version of Heroic Games Launcher from the recommended COPR repo (atim/heroic-games-launcher).

Unfortunately, due to the hard-coding of the expected paths of Heroic in HeroicBashLauncher, it wasn't working on my system at first because the RPM version of Heroic is installed to /usr/lib64/heroic-games-launcher-bin/.

This PR attempts to fix this issue and allow for more "diverse" Heroic installations in the future by:

Attempting to find heroic on the PATH before going back to the old defaulting logic.

Including unit tests for checkbinary.py to confirm that each of the correct paths are returned in a few different scenarios.

These can be invoked with python -m unittest tests/*.py

A side-effect of making the modules testable required reorganizing the main HeroicBashLauncher.py to nest its code under an if __name__ == "__main__": block and converting a few of the checks in settings.py to be functions that are now called from this main method.
opened by afwolfe 1

[Bug] When FSR is enabled fails to generate AddToSteam.sh

Before posting this issue, make sure you've read the Issues section in the Readme and the Flatpak/Steam-Deck guide.

Describe the bug When Using Heroic Games Launcher Flatpak 2.5.1 the Bash launcher fails after generating game files.

[INFO] Using Bash Launcher v3.1.1
NOTE - This is an independent project and not affiliated with Heroic Games Launcher.

[DEBUG] Starting new HTTPS connection (1): api.github.com:443
[DEBUG] https://api.github.com:443 "GET /repos/redromnon/HeroicBashLauncher/releases/latest HTTP/1.1" 200 1325
[INFO] Done! Now creating launch files for your Epic Games library ...
[INFO] Wonder Boy The Dragons Trap [4c30fe9841264abfb120b581d061a8fd]...
[INFO] Evoland Legendary Edition [530f09c9ac834a7bbc98056c69b44471]...
[INFO] Hell is other demons [5ade01bafec54a148024665ce978b2a4]...
[INFO] DOOM 64 [5b60142e120c4f2d88027595c21d4a04]...
[INFO] Cook Serve Delicious 3 [680599141dc14accb456887a2be3ac0c]...
[INFO] Sonic Mania [818447bb519b46d48d365d5753362796]...
[INFO] Torchlight II [8e425d507bd6473dbb927f0fea8ef4f6]...
[INFO] Among Us [963137e4c29d4c79a81323b8fab03a40]...
[INFO] Towerfall Ascension [Bichir]...
[INFO] Ape Out [Coley]...
[INFO] Enter the Gungeon [Garlic]...
[INFO] The Messenger [Jay]...
[INFO] Hyper Light Drifter [Parakeet]...
[INFO] Neon Abyss [a26f991a5e6c4e9c9572fc200cbea47f]...
[INFO] Amnesia: A Machine for Pigs [d7db33dfe7634d6b8a188c708f2caa3c]...
[CRITICAL] Traceback (most recent call last):
  File "func/checkparameters.py", line 80, in checkparameters
KeyError: 'maxSharpness'

Steps to reproduce the behavior:

Set autoaddtosteam to false
Start HeroicBashLauncher
Process Failed

Expected behavior Generate AddToSteam.sh

Details

Platform: Desktop Linux
OS: Fedora Linux 37
Heroic Version: v2.5.1 Flatpak
Bash Launcher Version: 3.1.1
Steam : RPM

Additional context The generated game .sh files still work

opened by Aninuscsalas 1

[Help] Find new command-line arguments in Heroic
Description: As Heroic improves and matures over time, its complexity of handling game launching also increases.

Under the hood, Heroic runs a launch command with a set of arguments for running a game. This is precisely what Bash Launcher aims to do through bash scripts.

With every new release, new arguments may be added to the launch command. Some of these arguments are applied via options in the settings while others are included to avoid errors or to improve compatibility.

Solution: You can contribute to this project is by

Identifying new launch arguments implemented in Heroic

Noting how and why they are included

If you find one, feel free to create a new Feature Request or Pull Request!
help wanted
opened by redromnon 0
Support symlinks
Is your feature request related to a problem? Please describe.

I have my games symlinked to sdcard, which works fine in Heroic Games Launcher, but not the launchers made with this.

ls -al ~/Games/ total 8 drwxr-xr-x 2 deck deck 4096 Oct 30 18:58 . drwx------ 19 deck deck 4096 Oct 30 19:01 .. lrwxrwxrwx 1 deck deck 28 Oct 30 18:58 Heroic -> /run/media/mmcblk0p1/Heroic/

Describe the solution you'd like

I'd like if the scripts accepted the resolved ~/Games/Heroic/ as the correct dir.

Describe alternatives you've considered

Maybe some sort of setting that let me point to the correct dir.

Additional context

I'm going to work on a PR for it, if anyone else is interested (otherwise it's what I will use for myself.)
opened by konsumer 7

[Bug] Games Will not run from Lutris or .Desktop Shortcuts (GOG and Epic)

I have read the guides and had a scroll through reports. Appears similar to #90, but the troubleshooting went over my head. I assume something is misconfigured, by my fault but have no idea how to fix!

Describe the bug I can not get games to launch through Lutris, or from .desktop shortcuts. When using Lutris, logs will either say incorrectly that it isn't in ~/Games/Heroic/ when it is, or else return the following, if I set my working directory to ~/Games/Heroic/HeroicBashLauncher it will return:

Started initial process 128086 from /home/user/Games/Heroic/HeroicBashLauncher/GameFiles/HITMAN3_Heroic.sh
Start monitoring process.
/home/user/Games/Heroic/HeroicBashLauncher/GameFiles/HITMAN3_Heroic.sh: line 4: logs/HITMAN3_Heroic.log: No such file or directory
zenity: symbol lookup error: /lib/x86_64-linux-gnu/libatk-bridge-2.0.so.0: undefined symbol: atk_component_scroll_to
ERROR:root:Zenity not installed. Please consider doing so and try again.
Using Bash Launcher v2.9.2
NOTE - This is an independent project and not affiliated with Heroic Games Launcher.

flatpak: symbol lookup error: /lib/x86_64-linux-gnu/libassuan.so.0: undefined symbol: gpgrt_malloc, version GPG_ERROR_1.0
Monitored process exited.
Initial process has exited (return code: 32512)
All processes have quit
Exit with return code 32512

To Reproduce Using HGL - Flatpack, Flatseal looks like this:

Lutris is installed as a .deb.

Install game.
Use HBL - Test .sh script in terminal - The scripts will work when executed from the directory by double-clicking them
Add .sh file to Lutris using the instructions provided.
Attempt to launch game - will not load.

Platform: Pop! OS w/ Xanmod Kernel Stable - Laptop AMD Ryzen / RTX 3080m.
Heroic Version: Latest, Flatpak
Bash Launcher Version: Latest Zip from releases section - no explicit Flatpak version is there, so I used HeroicBashLauncher-2.9.2.zip

Chasing the Logs a bit

Zenity is installed
zenity is already the newest version (3.42.1-0ubuntu1). zenity set to manually installed.
If I give HGL permissions to see absolutely everything on my system, Lutris will return:

Started initial process 147512 from /home/user/Games/Heroic/HeroicBashLauncher/GameFiles/HITMAN3_Heroic.sh
Start monitoring process.
/home/user/Games/Heroic/HeroicBashLauncher/GameFiles/HITMAN3_Heroic.sh: line 4: logs/HITMAN3_Heroic.log: No such file or directory
zenity: symbol lookup error: /lib/x86_64-linux-gnu/libatk-bridge-2.0.so.0: undefined symbol: atk_component_scroll_to
ERROR:root:Zenity not installed. Please consider doing so and try again.
Using Bash Launcher v2.9.2
NOTE - This is an independent project and not affiliated with Heroic Games Launcher.

flatpak: symbol lookup error: /lib/x86_64-linux-gnu/libassuan.so.0: undefined symbol: gpgrt_malloc, version GPG_ERROR_1.0
Monitored process exited.
Initial process has exited (return code: 32512)
All processes have quit
Exit with return code 32512

opened by malcolmturnbull 7

[Bug] Deleted Heroic Flatpak version gets detected
Describe the bug I installed heroic flatpak but after some tweaking i realized that it is not for me so i installed the .pacman version. Now the problem is that HBL is not detection .pacman but only flatpak.

To Reproduce Install and delete flatpak version Install any other version Wont detect games

Expected behavior If there are more heroic launchers then maybe detect everyone of them and display all games

Details

Platform: desktop

OS: HoloOS arch

Heroic Version: latest 2.4.3 .pacman

Bash Launcher Version: 2.9.2

Additional context So a work around for this is to go to ~/.var/app and delete heroic launcher from there. I would like this to be added to troubleshoot wiki if you think it is a not so common issue. I personally don't see a reason for people to have more heroic launchers so hope this helps anyone.
bug
opened by itzpere 1

Releases(v3.1.1)

v3.1.1(Dec 4, 2022)
This release includes a major bug fix.

Bug Fix

[Fix] Absent logo art for some Epic games led to a crash when downloading artwork for Steam - #115

Note for Flatpak & Steam Deck users

Make sure to read the Flatpak guide before you proceed using Bash Launcher.

Download Instructions

Heroic AppImage users are required to download the respective AppImage.zip file. Heroic Flatpak, AUR and .DEB users are required to download the base (just .zip) file. Make sure to place the HeroicBashLauncher folder in ~/Games/Heroic and enable executable permission for the application.

Full Changelog: https://github.com/redromnon/HeroicBashLauncher/compare/v3.1.0...v3.1.1
Source code(tar.gz)
Source code(zip)
HeroicBashLauncher-3.1.1.zip(6.56 MB)
HeroicBashLauncher-3.1.1_AppImage.zip(19.56 MB)
v3.1.0(Nov 26, 2022)
Added support for a Heroic feature that may impact game performance that was pending for quite some time. Also updated Legendary & gogdl binaries.

New Changes

Implement support for the preferSystemLibs checkbox found in Heroic's Game Settings - Issue #113

Adds the following parameters for custom wine versions if the checkbox is disabled :

LD_LIBRARY_PATH, GST_PLUGIN_SYSTEM_PATH_1_0 & WINEDLLPATH

[AppImage users] Update Legendary to v0.20.31

[AppImage users] Update gogdl to v0.4

Note for Flatpak & Steam Deck users

Make sure to read the Flatpak guide before you proceed using Bash Launcher.

Download Instructions

Heroic AppImage users are required to download the respective AppImage.zip file. Heroic Flatpak, AUR and .DEB users are required to download the base (just .zip) file. Make sure to place the HeroicBashLauncher folder in ~/Games/Heroic and enable executable permission for the application.

Full Changelog: https://github.com/redromnon/HeroicBashLauncher/compare/v3.0.1...v3.1.0
Source code(tar.gz)
Source code(zip)
HeroicBashLauncher-3.1.0.zip(6.56 MB)
HeroicBashLauncher-3.1.0_AppImage.zip(19.56 MB)
v3.0.1(Oct 18, 2022)
Hotfix

Bug Fix

Fix artwork not downloaded/added via AddToSteam.sh

Full Changelog: https://github.com/redromnon/HeroicBashLauncher/compare/v3.0.0...v3.0.1

Refer to the v3.0.0 release for details on other additions and fixes

Note for Flatpak & Steam Deck users

Make sure to read the Flatpak guide before you proceed using Bash Launcher.

Download Instructions

Heroic AppImage users are required to download the respective AppImage.zip file. Heroic Flatpak, AUR and .DEB users are required to download the base (just .zip) file. Make sure to place the HeroicBashLauncher folder in ~/Games/Heroic and enable executable permission for the application.
Source code(tar.gz)
Source code(zip)
HeroicBashLauncher-3.0.1.zip(6.57 MB)
HeroicBashLauncher-3.0.1_AppImage.zip(20.18 MB)
v3.0.0(Oct 7, 2022)
New Silent Mode and an option to Disable Steam Syncing

Bug Fixes

Set --offline parameter if there's no internet connection detected - #105

Fix "game launch failed" error for GOG games (See below) - #110 & #81

New Changes

[Deck] Users can now disable the default addition of game scripts to Steam by changing autoaddtosteam to false in settings.config, the AddToSteam.sh script will be generated instead like desktop users - #104

[Refactor] Implement structured command-line arguments

Users can disable GUI popups while running the program with the new --silent argument - #103

Discard "game launch failed" error dialog completely - #110

Full Changelog: https://github.com/redromnon/HeroicBashLauncher/compare/v2.9.2...v3.0.0

Note for Flatpak & Steam Deck users

Make sure to read the Flatpak guide before you proceed using Bash Launcher.

Download Instructions

Heroic AppImage users are required to download the respective AppImage.zip file. Heroic Flatpak, AUR and .DEB users are required to download the base (just .zip) file. Make sure to place the HeroicBashLauncher folder in ~/Games/Heroic and enable executable permission for the application.
Source code(tar.gz)
Source code(zip)
HeroicBashLauncher-3.0.0.zip(6.57 MB)
HeroicBashLauncher-3.0.0_AppImage.zip(20.18 MB)
v2.9.2(Sep 2, 2022)
A minor fix for users using anti-cheat runtimes for Windows games and bundled the latest Legendary release to solve Epic login issues.

Bug Fix

Fix the anti-cheat runtime parameters - #101

Changes

Update Legendary to v0.20.28

Refer to the v2.9.1 release for details on other additions and fixes

Full Changelog: https://github.com/redromnon/HeroicBashLauncher/compare/v2.9.1...v2.9.2

Note for Flatpak & Steam Deck users

Make sure to read the Flatpak guide before you proceed using Bash Launcher.

Download Instructions

Heroic AppImage users are required to download the respective AppImage.zip file. Heroic Flatpak, AUR and .DEB users are required to download the base (just .zip) file. Make sure to place the HeroicBashLauncher folder in ~/Games/Heroic and enable executable permission for the application.
Source code(tar.gz)
Source code(zip)
HeroicBashLauncher-2.9.2.zip(6.56 MB)
HeroicBashLauncher-2.9.2_AppImage.zip(20.17 MB)
v2.9.1(Aug 26, 2022)
Few new additions to help run games better with Proton.

Changes

[Proton] Force Steam AppID

[Proton] Add STEAM_COMPAT_APP_ID

[Proton] Change executable path for Steam Runtime Soldier to run from _v2-entry-point

Add build.sh file

Full Changelog: https://github.com/redromnon/HeroicBashLauncher/compare/v2.9.0...v2.9.1

Refer to the v2.9.0 release for details on other additions and fixes

Note for Flatpak & Steam Deck users

Make sure to read the Flatpak guide before you proceed using Bash Launcher.

Download Instructions

Heroic AppImage users are required to download the respective AppImage.zip file. Heroic Flatpak, AUR and .DEB users are required to download the base (just .zip) file. Make sure to place the HeroicBashLauncher folder in ~/Games/Heroic and enable executable permission for the application.
Source code(tar.gz)
Source code(zip)
HeroicBashLauncher-2.9.1.zip(6.56 MB)
HeroicBashLauncher-2.9.1_AppImage.zip(20.17 MB)
v2.9.0(Aug 12, 2022)
Brings support for Heroic v2.4.0 release. Do note that I am still yet to implement (and test) Heroic's new GOG saves feature, thus you should expect it in the next release.

Additions & Changes:

[Script] Remove offline launch command

This launched the game in offline mode if no network connectivity or an issue was detected

Now only displays the "Failed to launch" dialog

Add tabular Advanced Options support

Add tabular Wrappers parameter support

Add anti-cheat runtime support (EAC & BattleEye)

Implement PROTON_NO_ESYNC/FSYNC parameter

Small refactor for GOG Linux games

Updated Legendary to v0.20.27

Updated gogdl to v0.3

Full Changelog: https://github.com/redromnon/HeroicBashLauncher/compare/v2.8.1...v2.9.0

Note for Flatpak & Steam Deck users

Make sure to read the Flatpak guide before you proceed using Bash Launcher.

Download Instructions

Heroic AppImage users are required to download the respective AppImage.zip file. Heroic Flatpak, AUR and .DEB users are required to download the base (just .zip) file. Make sure to place the HeroicBashLauncher folder in ~/Games/Heroic and enable executable permission for the application.
Source code(tar.gz)
Source code(zip)
HeroicBashLauncher-2.9.0.zip(6.56 MB)
HeroicBashLauncher-2.9.0_AppImage.zip(20.17 MB)
v2.8.1(Jul 23, 2022)
Minor changes and a message fix.

Fix:

Fix installation path in error message by @nirvdrum

Changes:

Improve Heroic Flatpak detection

Alert user if no games have been launched from Heroic (timestamp.json absent)

[Script] Correct offline mode message to avoid confusion about network connectivity

Thanks @nirvdrum for your contribution! - https://github.com/redromnon/HeroicBashLauncher/pull/89

Full Changelog: https://github.com/redromnon/HeroicBashLauncher/compare/v2.8.0...v2.8.1

Refer to the v2.8.0 release for details on other additions and fixes

Note for Flatpak & Steam Deck users

Make sure to read the Flatpak guide before you proceed using Bash Launcher.

Download Instructions

Heroic AppImage users are required to download the respective AppImage.zip file. Heroic Flatpak, AUR and .DEB users are required to download the base (just .zip) file. Make sure to place the HeroicBashLauncher folder in ~/Games/Heroic and enable executable permission for the application.
Source code(tar.gz)
Source code(zip)
HeroicBashLauncher-2.8.1.zip(6.57 MB)
HeroicBashLauncher-2.8.1_AppImage.zip(20.99 MB)
v2.8.0(Jul 14, 2022)
Few New Additions + Settings

In addition to the new changes featured in the beta release published recently, I've implemented user-configurable settings. Users can edit the settings.config file and disable an option by changing a value from true to false

The setup.sh has been completely discarded so you can start the program by running the executable directly. The new --language parameter has also been introduced to play games in your preferred language (requires Heroic v2.4.0 Beta+).

Lastly, users will be required to place the HeroicBashLauncher folder in ~/Games/Heroic to avoid permission issues. There's also a brief how-to-guide.txt that acts as a light manual.

Bug Fixes

Fix 'library' key spelling for Epic that lead to crash

Changes

Implement user-configurable settings.config file - #72

Prompt user to launch newly installed game from Heroic at least once

[Legendary] Add language parameter - #87

Prompt user to place HeroicBashLauncher in ~/Games/Heroic to avoid permission issues

Skip notification if new version is a pre-release

Implement logging

Skip artwork checking for games already added to Steam

Discard setup.sh

Make binaries executable

Note for Flatpak & Steam Deck users

Make sure to read the Flatpak guide before you proceed using Bash Launcher.

Download Instructions

Heroic AppImage users are required to download the respective AppImage.zip file. Heroic Flatpak, AUR and .DEB users are required to download the base (just .zip) file. Make sure to place the HeroicBashLauncher folder in ~/Games/Heroic and enable executable permission for the application.

Full Changelog: https://github.com/redromnon/HeroicBashLauncher/compare/v2.7.5...v2.8.0
Source code(tar.gz)
Source code(zip)
HeroicBashLauncher-2.8.0.zip(6.58 MB)
HeroicBashLauncher-2.8.0_AppImage.zip(20.99 MB)
v2.8.0-beta(Jul 12, 2022)
A few changes here and there to help avoid simple issues related to permissions and launching (newly installed games). The code has undergone some refactoring and thus I've decided to publish this release as a beta. Plus, users should be able to play games in their preferred language that's set in Heroic.

Feel free to test this out and report any issues!

Changes

Prompt user to launch newly installed game from Heroic at least once

[Legendary] Add language parameter - #87

Prompt user to place HeroicBashLauncher in ~/Games/Heroic to avoid permission issues

Skip notification if new version is a pre-release

Implement logging

Skip artwork checking for games already added to Steam

Discard setup.sh

Make binaries executable

Note for Flatpak & Steam Deck users

Make sure to read the Flatpak guide before you proceed using Bash Launcher.

Download Instructions

Heroic AppImage users are required to download the respective AppImage.zip file. Heroic Flatpak, AUR and .DEB users are required to download the base (just .zip) file. Make sure to unzip the file to ~/Games/Heroic

Full Changelog: https://github.com/redromnon/HeroicBashLauncher/compare/v2.7.5...v2.8.0-beta
Source code(tar.gz)
Source code(zip)
HeroicBashLauncher-2.8.0-beta.zip(6.57 MB)
HeroicBashLauncher-2.8.0-beta_AppImage.zip(20.99 MB)
v2.7.5(Jun 23, 2022)
Bug Fix Release for v2.7.4

Fix 'requests' module not found error - #85

Fix glibc_2.35 not found error - #84

Refer to the v2.7.4 release for details on other additions and fixes

Note for Flatpak & Steam Deck users

Make sure to read the Flatpak guide before you proceed using Bash Launcher.

Download Instructions

Heroic AppImage users are required to download the respective AppImage.zip file. Heroic Flatpak, AUR and .DEB users are required to download the base (just .zip) file.

Full Changelog: https://github.com/redromnon/HeroicBashLauncher/compare/v2.7.4...v2.7.5
Source code(tar.gz)
Source code(zip)
HeroicBashLauncher-2.7.5.zip(6.57 MB)
HeroicBashLauncher-2.7.5_AppImage.zip(20.99 MB)
v2.7.4(Jun 23, 2022)
Please avoid downloading this release. Use v2.7.5 instead.

Bug Fixes

Fix incorrect Steam shortcut.vdf format used when adding games ( Essential fix for Steam Rom Manager users ) - #78

Changes:

Notify users whenever a newer version is available

Refer to the v2.7.3 release for details on other additions and fixes

Note for Flatpak & Steam Deck users

Make sure to read the Flatpak guide before you proceed using Bash Launcher.

Download Instructions

Heroic AppImage users are required to download the respective AppImage.zip file. Heroic Flatpak, AUR and .DEB users are required to download the base (just .zip) file.

Full Changelog: https://github.com/redromnon/HeroicBashLauncher/compare/v2.7.3...v2.7.4
Source code(tar.gz)
Source code(zip)
v2.7.3(Jun 13, 2022)
More Essential Fixes

Bug Fixes

Use global wine version (if stated) for newly installed games to avoid crash - #82, #75

[AppImage] Fix wrong binaries path

Wrap non-static/user-defined paths like wine prefix and alternative executable in double quotes to avoid errors - #76, #80

[GOG] Correct zenity error dialog typo

Changes:

Ignore ac and 0 folders in Steam's userdata directory

Refer to the v2.7.2 release for details on other additions and fixes

Note for Flatpak & Steam Deck users

Make sure to read the Flatpak guide before you proceed using Bash Launcher.

Download Instructions

Heroic AppImage users are required to download the respective AppImage.zip file. Heroic Flatpak, AUR and .DEB users are required to download the base (just .zip) file.

Full Changelog: https://github.com/redromnon/HeroicBashLauncher/compare/v2.7.2...v2.7.3
Source code(tar.gz)
Source code(zip)
HeroicBashLauncher-2.7.3.zip(6.12 MB)
HeroicBashLauncher-2.7.3_AppImage.zip(20.54 MB)
v2.7.2(May 30, 2022)
Minor Changes & a Bug Fix

Bug Fix:

Fix addition of duplicate entries for games having an apostrophe in their names - #71

Changes:

[Refactor] Prevent unnecessary checking for Steam entry (or add to script) and downloading artwork when running from game launch scripts

Discard gamemoderun path check

Refer to the v2.7.1 release for details on other additions and fixes

Note for Flatpak & Steam Deck users

Make sure to read the Flatpak guide before you proceed using Bash Launcher.

Download Instructions

Heroic AppImage users are required to download the respective AppImage.zip file. Heroic Flatpak, AUR and .DEB users are required to download the base (just .zip) file.

Full Changelog: https://github.com/redromnon/HeroicBashLauncher/compare/v2.7.1...v2.7.2
Source code(tar.gz)
Source code(zip)
HeroicBashLauncher-2.7.2.zip(6.30 MB)
HeroicBashLauncher-2.7.2_AppImage.zip(20.72 MB)
v2.7.1(May 24, 2022)
Bug Fix for 2.7.0

Bug Fixes:

Fix crash if wineVersion or winePrefix is not specified during setup

Discard totalplaytime implementation which caused crash for newly installed games

Changes:

Discard alert dialog that asked user to launch newly installed game from Heroic

Refer the v2.7.0 release for details on other additions and fixes

Note for Flatpak & Steam Deck users

Make sure to read the Flatpak guide before you proceed using Bash Launcher.

Download Instructions

AppImage users are required to download the respective AppImage.zip file. Flatpak, AUR and .DEB users are required to download the base (just .zip) file.
Source code(tar.gz)
Source code(zip)
HeroicBashLauncher-2.7.1.zip(6.30 MB)
HeroicBashLauncher-2.7.1_AppImage.zip(20.72 MB)
v2.7.0(May 23, 2022)
Few New Features

This release accompanies Heroic's v2.3.3 where Steam Runtime with Proton was intoduced. Plus, a couple of new additions.

Additions

Implement Steam Runtime (Soldier) for games running with Steam Proton/Proton-GE

Ask user to launch newly installed games from Heroic to avoid facing launch errors

This is because Heroic performs some pre-launch setups like creating the wine prefix.

[Epic] Download Logo Art for games if available

Note for Flatpak & Steam Deck users

Make sure to read the Flatpak guide before you proceed using Bash Launcher.

Download Instructions

AppImage users are required to download the respective AppImage.zip file. Flatpak, AUR and .DEB users are required to download the base (just .zip) file.
Source code(tar.gz)
Source code(zip)
HeroicBashLauncher-2.7.0.zip(6.30 MB)
HeroicBashLauncher-2.7.0_AppImage.zip(20.72 MB)
v2.6.1(May 20, 2022)
Few More Fixes and Improvements

A couple of issues needed to be addressed due to refactoring done in the v2.6.0 beta release. It's also safe to say that this release will finally work on the Deck and distros having the glibc package version > 2.31.

Edit: Forgot to enable permission for the executable.

Bug Fixes:

Fix wrong launch script path which led to duplicate artwork

Fix addition of duplicate games if the game is already manually added to Steam

Changes:

Enable upload saves functionality in pre-game cloud sync for newer local saves

Move shebang to the start for launch scripts to avoid errors - #65

Refer the v2.6.0 release for details on other additions and fixes

Note for Flatpak & Steam Deck users

Make sure to read the Flatpak guide before you proceed using Bash Launcher.

Download Instructions

AppImage users are required to download the respective AppImage.zip files. Flatpak, AUR and .DEB users are required to download the base (just .zip) file.
Source code(tar.gz)
Source code(zip)
HeroicBashLauncher-2.6.1.zip(6.30 MB)
HeroicBashLauncher-2.6.1_AppImage.zip(20.72 MB)
v2.6.0(May 18, 2022)
Crucial Fixes and Improvements

This release primarily focuses on bug fixes and some major improvements. The post-game cloud save syncing for Epic games should now work properly and sync only after the game exits. On the other hand, game/folder names and account usernames that include special characters should no longer face any issues.

EDIT - Currently, this release DOESN'T WORK on the Deck (Steam OS 3.2) or any Linux distro using glibc 2.33 and below as of now. These users are requested to use the older v2.5.0 release for now or wait till their distro updates the glibc version.

Bug Fixes:

Check gamemoderun path - #51

Forgot to make launch scripts executable

Forgot to add the executable path in AddToSteam.sh

Fix path to executable in launch script - #58

Fix wrong launch script path when adding to Steam

Fix Steam Proton path bug that caused games to crash - #60 & #63

Fix post-game save syncing implementation for Epic games (again)

Changes:

Elaborated error dialogs to specify location of logs

Create config folder in every Steam account subfolder if absent to prevent crash - #55 and #54

Add UTF-8 Encoding to support non-ascii characters (special symbols and non-English letters) and avoid crash - many issues

[Refactor Game Launch] Games now launch directly from the script i.e. the old & original method

[Refacor Game Launch] [Flatpak] Seperate launch script - launchflatpakgame.sh - handles game launching

Single version for .DEB, AUR and Flatpak users

Note for Flatpak & Steam Deck users

Make sure to read the Flatpak guide before you proceed using Bash Launcher.

Download Instructions

AppImage users are required to download the respective AppImage.zip files. Flatpak, .DEB and AUR users are required to download the base (just .zip) file.
Source code(tar.gz)
Source code(zip)
HeroicBashLauncher-2.6.0.zip(7.42 MB)
HeroicBashLauncher-2.6.0_AppImage.zip(21.84 MB)
v2.6.0-beta(May 16, 2022)
Improvements and Fixes

This release is particular for testers and those curious. I've brought back the old method of launching games from the scripts. I've also implemented a check that executes post-game save syncing after the game's exe process ends for Epic games.

NOTE - This release may not work with Flatpak and the Steam Deck, because an older version of glibc (v2.33 instead of v2.35) is used by Flatpak. If you know a workaround, feel free to let me know.

Thus Flatpak and Steam Deck users are requested to use the previous stable release v2.5.0 instead.

Bug Fixes:

Check gamemoderun path - #51

Better post-game save syncing implementation for Epic games

Changes:

Create config folder in every Steam account subfolder if absent to prevent crash - #55 and #54

Add UTF-8 Encoding to support non-ascii characters (special symbols and non-English letters) and avoid crash - many issues

Fixed path to executable in launch script - #58

[Refactor game launch] Games now launch directly from the script i.e. the old method

Single version for .DEB, AUR and Flatpak users

Note for Flatpak & Steam Deck users

Make sure to read the Flatpak guide before you proceed using Bash Launcher.

Download Instructions

AppImage users are required to download the respective AppImage.zip files. Flatpak, .DEB and AUR users are required to download the base (just .zip) file.

New Contributor

Thanks a lot, @clemthi for your contribution! - #56
Source code(tar.gz)
Source code(zip)
HeroicBashLauncher-2.6.0-beta.zip(7.42 MB)
HeroicBashLauncher-2.6.0-beta_AppImage.zip(21.84 MB)
v2.5.0(Apr 28, 2022)
Now Supports Multiple Steam Accounts and Fixes Post-Game Cloud Save Sync

Bug Fixes:

Checks for existing Steam artwork in .png format and skips downloading new artwork - #46

Add games to all logged-in Steam accounts - #41

Fixed Post-Game Cloud Save Sync

Changes:

Creates shorcuts.vdf file if not present to avoid crash

Select and add multiple games to Steam from the GUI list via AddToSteam.sh [Non-Deck]

Added Steam Runtime (Scout) parameter support [GOG Linux]

Specifies log location in error dialogs

Launch scripts do not include the launch command; game launching is now handled by the executable

Note for Existing Users

Users who've already downloaded previous versions of Bash Launcher can choose to only download the HeroicBashLauncher executable (first in the Assets) and replace it with the old executable.

Note for Flatpak & Steam Deck users

Make sure to read the Flatpak guide before you proceed using Bash Launcher.

Download Instructions

AppImage and Flatpak Heroic users are required to download the respective AppImage/Flatpak.zip files. .DEB and AUR users are required to download the base (just .zip) file.
Source code(tar.gz)
Source code(zip)
HeroicBashLauncher(6.66 MB)
HeroicBashLauncher-2.5.0.zip(6.58 MB)
HeroicBashLauncher-2.5.0_AppImage.zip(21.00 MB)
HeroicBashLauncher-2.5.0_Flatpak.zip(6.58 MB)
v2.4.3(Apr 16, 2022)
Improved Support for Steam Artwork (See 2.4.2)

Crucial bug fix for Flatpak users

Bug Fixes:

Launch scripts failed to run for Flatpak users due to no binary specified in launch command - #40

Note for Existing Users

Users who've already downloaded previous versions of Bash Launcher can choose to only download the HeroicBashLauncher executable (first in the Assets) and replace it with the old executable.

Note for Flatpak & Steam Deck users

Make sure to read the Flatpak guide before you proceed using Bash Launcher.

Note for AppImage

AppImage users no longer need to specify alternative binaries in the Heroic app (they can if they want to) or keep Heroic running anymore!

AppImage and Flatpak Heroic users are required to download the respective AppImage/Flatpak.zip files.
Source code(tar.gz)
Source code(zip)
HeroicBashLauncher(6.61 MB)
HeroicBashLauncher-2.4.3.zip(6.53 MB)
HeroicBashLauncher-2.4.3_AppImage.zip(20.95 MB)
HeroicBashLauncher-2.4.3_Flatpak.zip(6.53 MB)
v2.4.2(Apr 15, 2022)
Improved Support for Steam Artwork

Additional artwork and bug fixes

Bug Fixes:

Create 'grid' folder if not present to avoid crash - #34 & #35

Skip checking alternate binaries' (legendary & gogdl) keys if not present - #35

Fixed bug that displayed "Heroic not installed" for users who've uninstalled Heroic Flatpak

Changes:

Added background art support for Steam client & Deck UI Mode

[Non-Deck users] Produce log for AddToSteam.sh in the separate AddToSteam.log file

Display Bash Launcher version in log

Note for Existing Users

Users who've already downloaded previous versions of Bash Launcher can choose to only download the HeroicBashLauncher executable (first in the Assets) and replace it with the old executable.

Note for Flatpak & Steam Deck users

Make sure to read the Flatpak guide before you proceed using Bash Launcher.

Note for AppImage

AppImage users no longer need to specify alternative binaries in the Heroic app (they can if they want to) or keep Heroic running anymore!

AppImage and Flatpak Heroic users are required to download the respective AppImage/Flatpak.zip files.

New Contributor

Thanks @xhoneybear for your contribution! - #37
Source code(tar.gz)
Source code(zip)
HeroicBashLauncher(6.61 MB)
HeroicBashLauncher-2.4.2.zip(6.53 MB)
HeroicBashLauncher-2.4.2_AppImage.zip(20.95 MB)
HeroicBashLauncher-2.4.2_Flatpak.zip(6.53 MB)
v2.4.1(Apr 13, 2022)
Initial Support for Artwork (Cover Art - Steam)

This release aims to make displaying errors and debugging more accurate. Users facing issues with the artwork or any other errors are highly recommended to download this release.

Do note that a bug fix release will be arriving soon depending on any upcoming issue reports.

Changes:

Notify user with an error dialog if downloading or adding artwork fails

[Non-Deck users] Produce log for AddToSteam.sh in the same HeroicBashLauncher.log

Now correctly displays relevant errors (traceback) in the logs for easier debugging

Important Note for Flatpak & Steam Deck users

Make sure to read the Flatpak guide before you proceed using Bash Launcher.

Note for AppImage

AppImage users no longer need to specify alternative binaries in the Heroic app (they can if they want to) or keep Heroic running anymore!

AppImage and Flatpak Heroic users are required to download the respective AppImage/Flatpak.zip files.

New Contributor

Thanks @Supreeeme for your contribution! - #36
Source code(tar.gz)
Source code(zip)
HeroicBashLauncher-2.4.1.zip(6.53 MB)
HeroicBashLauncher-2.4.1_AppImage.zip(20.95 MB)
HeroicBashLauncher-2.4.1_Flatpak.zip(6.53 MB)
v2.4.0(Apr 9, 2022)
Initial Support for Artwork (Cover Art - Steam)

A small but significant release.

Bug Fix:

Fix and include missing special characters in game names

Changes:

Notify Non-Deck users with a dialog box if game is already added to Steam

Download and add cover art for Heroic games added to Steam

Important Note for Flatpak & Steam Deck users

Make sure to read the Flatpak guide before you proceed using Bash Launcher.

Note for AppImage

AppImage users no longer need to specify alternative binaries in the Heroic app (they can if they want to) or keep Heroic running anymore!

AppImage and Flatpak Heroic users are required to download the respective AppImage/Flatpak.zip files.
Source code(tar.gz)
Source code(zip)
HeroicBashLauncher-2.4.0.zip(6.53 MB)
HeroicBashLauncher-2.4.0_AppImage.zip(20.95 MB)
HeroicBashLauncher-2.4.0_Flatpak.zip(6.53 MB)
v2.3.0(Apr 2, 2022)
Now Produces Logs & Syncs the Entire Heroic Library for Deck Users

Bug Fix:

Improved reading from .json files - #28

Prevent adding duplicate games to Steam

Changes:

New setup.sh script now runs the program

Removed unnecessary legendary clean

Generate logs for easier debugging

Skip creating the AddToSteam.sh script for Deck

Sync the entire Heroic library to Steam for Deck

Important Note for Flatpak & Steam Deck users

Make sure to read the Flatpak guide before you proceed using Bash Launcher.

New Note for AppImage

AppImage users no longer need to specify alternative binaries in the Heroic app (they can if they want to) or keep Heroic running anymore!

AppImage and Flatpak Heroic users are required to download the respective AppImage/Flatpak.zip files.
Source code(tar.gz)
Source code(zip)
HeroicBashLauncher-2.3.0.zip(6.52 MB)
HeroicBashLauncher-2.3.0_AppImage.zip(20.94 MB)
HeroicBashLauncher-2.3.0_Flatpak.zip(6.52 MB)
v2.2.5(Mar 24, 2022)
Two New Features have been added - Flatpak support and Syncing Heroic games with Steam!

A couple of bug fixes and an addition

Bug Fixes:

Skip creating Epic game launch scripts for GOG-only users - #27

Fixed launch command for games using Wine-GE-Proton - #26

Changes:

Implemented post-game cloud save syncing

Important Note for Flatpak users

Make sure to read the FAQ before you proceed using Bash Launcher.

New Note for AppImage

AppImage users no longer need to specify alternative binaries in the Heroic app (they can if they want to) or keep Heroic running anymore!

AppImage and Flatpak Heroic users are required to download the respective AppImage/Flatpak.zip files.
Source code(tar.gz)
Source code(zip)
HeroicBashLauncher-2.2.5.zip(6.52 MB)
HeroicBashLauncher-2.2.5_AppImage.zip(20.93 MB)
HeroicBashLauncher-2.2.5_Flatpak.zip(6.52 MB)
v2.2.4(Mar 18, 2022)
Two New Features have been added - Flatpak support and Syncing Heroic games with Steam!

A nasty bug fix and some improvements

Bug Fixes:

Fixed bug that prevented reading .json file for some users - #22

Changes:

Auto-select the Steam user_id that contains shortcuts.vdf file for users with multiple Steam accounts

Skip installed GOG DLCs

Important Note for Flatpak users

Make sure to read the FAQ before you proceed using Bash Launcher.

New Note for AppImage

AppImage users no longer need to specify alternative binaries in the Heroic app (they can if they want to) or keep Heroic running anymore!

AppImage and Flatpak Heroic users are required to download the respective AppImage/Flatpak.zip files.

Thanks @JoshuaHasNoClue for your contribution! - #25
Source code(tar.gz)
Source code(zip)
HeroicBashLauncher-2.2.4.zip(6.52 MB)
HeroicBashLauncher-2.2.4_AppImage.zip(20.93 MB)
HeroicBashLauncher-2.2.4_Flatpak.zip(6.52 MB)
v2.2.3(Mar 17, 2022)
Two New Features have been added - Flatpak support and Syncing Heroic games with Steam!

So ever since Heroic was released as a Flatpak, it has been quite a ride for me. Bringing Flatpak support to Bash Launcher wasn't an easy task, so here we are with 3 bug-fix releases in just a day. There might be a few minor issues, but I believe that the major ones have been taken care of.

Bug Fixes:

Forgot to add "/" in the game's exe shortcut path when adding to Steam - #18

Important Note for Flatpak users

Make sure to read the FAQ before you proceed using Bash Launcher.

New Note for AppImage

AppImage users no longer need to specify alternative binaries in the Heroic app (they can if they want to) or keep Heroic running anymore!

AppImage and Flatpak Heroic users are required to download the respective AppImage/Flatpak.zip files.
Source code(tar.gz)
Source code(zip)
HeroicBashLauncher-2.2.3.zip(6.52 MB)
HeroicBashLauncher-2.2.3_AppImage.zip(20.93 MB)
HeroicBashLauncher-2.2.3_Flatpak.zip(6.52 MB)
v2.2.2(Mar 17, 2022)
Two New Features have been added - Flatpak support and Syncing Heroic games with Steam!

A few more bug-fixes...

Bug Fixes:

Forgot to replace 'debian-installation' with 'steam' path in write operation that prevented games from being added to Steam - #18

Fixed bug that skipped numbers in games' launch script names (Like RiseoftheTombRaider20YearCelebration)

New Note for AppImage and Flatpak users

AppImage users no longer need to specify alternative binaries in the Heroic app (they can if they want to) or keep Heroic running anymore! Moreover, AppImage and Flatpak Heroic users are required to download the respective AppImage/Flatpak.zip files.
Source code(tar.gz)
Source code(zip)
HeroicBashLauncher-2.2.2.zip(6.52 MB)
HeroicBashLauncher-2.2.2_AppImage.zip(20.93 MB)
HeroicBashLauncher-2.2.2_Flatpak.zip(6.52 MB)
v2.2.1(Mar 16, 2022)
Two New Features have been added - Flatpak support and Syncing Heroic games with Steam!

This is more of a bug-fix release for the Flatpak version

Bug Fixes:

Forgot to change the directory to "GameFiles" folder in AddToSteam - #18

Fixed STEAM_COMPAT_CLIENT_INSTALL_PATH - #19

Replaced 'debian-installation' with 'steam' path for syncing games to Steam - #18

Change:

Added alternative launch command in game launch scripts that contains full path from the home directory - #19

New Note for AppImage and Flatpak users

AppImage users no longer need to specify alternative binaries in the Heroic app (they can if they want to) or keep Heroic running anymore! Moreover, AppImage and Flatpak Heroic users are required to download the respective AppImage/Flatpak.zip files.
Source code(tar.gz)
Source code(zip)
HeroicBashLauncher-2.2.1.zip(6.52 MB)
HeroicBashLauncher-2.2.1_AppImage.zip(20.93 MB)
HeroicBashLauncher-2.2.1_Flatpak.zip(6.52 MB)