HeroicBashLauncher

Ever wanted to launch your Epic Games Store and GOG games installed through Heroic Games Launcher directly from the terminal, Lutris, Steam or any other frontend game launcher? Heroic Bash Launcher lets you do this very easily.

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 or write your own launch script with Legendary! Thus saving your time!

Pre-requisites

• Heroic 2.2.2+
• Zenity

Building & Testing

Since the program makes use of an executable, you will need Python version 3.8+ and PyInstaller to build the code.

To test the program, open the terminal in the func directory and use the following command to build -

pyinstaller HeroicBashLauncher.py --onefile -p <fullpath>/HeroicBashLauncher/func

This will generate an executable stored in the dist folder. Copy the executable, paste it in HeroicBashLauncher and run it.

Installation

Head over to the Releases page. Then download and extract the .zip file of the latest release.

Usage

Running the Program

Execute the program by simply double-clicking the HeroicBashLancher executable. You should be greeted by the Process Finished dialog at the end.

Running Games

You can run your game by executing the game's launch script using the terminal like ./RocketLeague.sh or using your preferred game launcher/manager, just point the executable path to the game's launch script. Simple!

Here's a guide on Adding Heroic games to Steam, Lutris and GameHub.

Don't copy or move the game files and launch scripts anywhere else, it won't work.

Working

Heroic Bash Launcher automatically detects installed games and creates a launch script for each game. It basically reads the .json files stored in ~/.config/heroic/GamesConfig.

The launch script is created using the bash shell script, i.e. .sh files. For example, if I have Rocket League installed, it will create the launch script titled "RocketLeague.sh". All these launch scripts will be available in the GameFiles folder.

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

Here's an example below of "RocketLeague.sh" -

#!/bin/bash 

#Game Name = Rocket League (EPIC) 

#App Name = Sugar

#Overrides launch parameters
cd .. && ./HeroicBashLauncher "Rocket League" "Sugar" "/home/redromnon/.config/heroic/GamesConfig/Sugar.json" "epic" 



(WINE_FULLSCREEN_FSR=1 WINE_FULLSCREEN_FSR_STRENGTH=2 WINEESYNC=1 mangohud --dlsym /opt/Heroic/resources/app.asar.unpacked/build/bin/linux/legendary launch Sugar --wine '/home/redromnon/.config/heroic/tools/wine/Wine-7.2-GE-2/bin/wine64' --wine-prefix '/home/redromnon/.wine' || (echo "---CANNOT CONNECT TO NETWORK. RUNNING IN OFFLINE MODE---" ; WINE_FULLSCREEN_FSR=1 WINE_FULLSCREEN_FSR_STRENGTH=2 WINEESYNC=1 mangohud --dlsym /opt/Heroic/resources/app.asar.unpacked/build/bin/linux/legendary launch Sugar --offline --wine '/home/redromnon/.config/heroic/tools/wine/Wine-7.2-GE-2/bin/wine64' --wine-prefix '/home/redromnon/.wine' )) || (zenity --error --title="Error" --text="Failed to launch games. Consider posting the log as an issue" --width=200 --timeout=3)

Features Planned

• Ask user for a default path for saving game launch scripts
• Add launch scripts to Steam
• Additional game launch options support (Eg. ARK)
• Flatpak Support
• GUI

Issues

If the program doesn't produce the game bash files (launch scripts), update the launch parameters or displays an error dialog, consider running the program from the terminal like ./HeroicBashLauncher and post the log as an issue.

License

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

You can check out the Wiki for FAQs and Changelog