Skip to content
This repository has been archived by the owner on May 19, 2024. It is now read-only.
Rishabh M edited this page Mar 22, 2022 · 12 revisions

Welcome to the HeroicBashLauncher wiki!

What is Heroic Bash Launcher?

Heroic Bash Launcher is a simple program that automatically creates bash scripts to directly launch any Epic Games Store and GOG game using Heroic Games Launcher. This includes all the launch parameters set in Heroic Games Launcher. Thus, allowing you to launch any game from anywhere you want - terminal or any frontend game launcher/manager.

Moreover, an Epic game will automatically launch in offline mode if you can't connect to the Epic Servers or don't have an active internet connection.

How is it different from Legendary?

Legendary is a command-line-based alternative to the Epic Games Launcher. Heroic Games Launcher, another alternative but GUI-based, is itself based on Legendary.

Sure, you can use Legendary's commands to launch your games from the terminal or even create your own bash script. But Heroic Bash Launcher is for those who aren't comfortable with the terminal or want to launch their game in one go. Thus, there's no need to always open Heroic Games Launcher to launch your games.

Why is Bash Launcher not working? I'm using Heroic via Flatpak

If you're using Heroic as a Flatpak, firstly make sure to download the Flatpak.zip version of Bash Launcher.

Most users may face an issue when running the executable in the form of bwrap: execvp ./HeroicBashLauncher: No such file or directory or something similar to this.

The solution is to enable the All user files or set the path the HeroicBashLauncher directory in Other files under Filesystem for Heroic Games Launcher in Flatseal.

Why are my games not launching? I use Heroic via AppImage

The following only applies to Bash Launcher v2.0.2 and below

The implementation isn't straightforward as a temporary folder under /tmp/ gets created every time with a different name whenever the AppImage is executed. This folder contains the path to the legendary and gogdl binaries that are needed by Heroic Bash Launcher. Thus, Heroic needs to be kept running so that the program finds that temporary folder.

Fortunately, for users with an Epic Games library, this situation can be easily overcome if the user specifies an alternate Legendary binary. To do this -

  1. Go to Settings
  2. Select General
  3. Click the folder icon in Choose an Alternative Legendary Binary (restart required)
  4. Navigate to the preferred directory and select the Legendary binary

Unfortunately, there is no such way for GOG users as of now.

Basically, AppImage users (especially those with a GOG library) will be required to keep the Heroic app open or running in the background to launch their games from the launch files. Thus, it is recommended that AppImage users download the Legendary binary and force Heroic to use this binary by following the above steps. This method may also benefit Steam Deck users using Heroic via the AppImage until Flatpak support arrives.