Heroic Games Launcher

Heroic is an Open Source Game Launcher for Linux, Windows and MacOS (Limited to Windows games using Wine/Crossover). Right now it supports launching games from the Epic Games Store using Legendary, a CLI alternative to the Epic Games Launcher. Heroic is built with Web Technologies like: TypeScript, React, NodeJS and Electron.

Index

• Heroic Games Launcher
  • Index
  • How to use it
  • Features available right now
  • Planned features
  • Language Support
    • Help with Translations Here
  • Installation
    • Any OS (development environment)
    • Building with VS Code
    • Development Using a Container
    • Linux
      • Debian, Ubuntu and Derivatives
      • Debian (third party apt repository)
      • Arch (AUR)
      • Fedora
      • Other Distributions (AppImage and TAR.XZ)
    • Windows
    • macOS
    • Build binaries locally (All platforms)
  • Screenshots

How to use it

• Download and Install the package for your distro, the universal AppImage for Linux or the executable for Windows on the Releases Page;
• If you used Legendary before, it loads your library and installed games. If not, it will ask you to login first. Just follow the instructions.

Features available right now

• Login with an existing Epic Games account
• Install/Uninstall Games
• Import an already installed game
• Play online [EAC not supported on Linux]
• Update installed Games
• Repair installed Games
• Move installed games to different folders
• Play games using the default wine and default prefix [Linux]
• Play game with custom wine and prefix [Linux]
• Check basic information about your Games
• Open game page on Epic Store
• Search for the game on ProtonDB [Linux]
• Sync installed games with an existing Epic Games instalation
• Sync saves with the cloud

Planned features

• Better Login System
• Add Games outside Epic Games
• Integration with other stores (GOG, ITCH.IO, Humble Bundle)

Language Support

• English
• Bulgarian
• Catalan
• Czech
• Croatian
• Simplified Chinese
• Traditional Chinese
• Dutch
• Estonian
• French
• German
• Greek
• Korean
• Hungarian
• Italian
• Malayalam
• Persian
• Polish
• Portuguese
• Portuguese (Brazil)
• Romanian
• Russian
• Spanish
• Swedish
• Tamil
• Turkish

Help with Translations Here

Installation

Any OS (development environment)

1. Download Yarn and Node.js
2. Download the dependencies with yarn
3. Go to the debug tab on vscode and start the two tasks, 'Start renderer process' and 'Debug main process' or yarn react-start && yarn electron

Building with VS Code

1. Download Yarn and Node.js
2. Download the dependencies with yarn
3. Open the tasks. Select "Build with [your OS]"

Development Using a Container

If you would prefer, we have a docker container defined to develop / build Heroic with (a potential reason being to avoid loading tons of dependencies on your host filesystem). There are two methods, based on whether you use VS Code.

VS Code

There is a .devcontainer directory containing a definition that VS Code will recognize for automatically opening your local Heroic directory in a container in VS Code.

NOTE: this requires that you install the 'Remote - Containers' extension.

1. Open the root of your local Heroic directory in VS Code.
2. You should get a prompt in the bottom right to build and open the project in the dev container.
3. If the above prompt does not occur, on the bottom left, there is a green icon that should be there if the remote extension is installed. Click on it, and select "Reopen in container".
4. The bottom left green icon should now say: "Dev Container: Heroic Games Launcher".

After the container's package manager runs, open a new terminal session and you should be able to run bash commands from within the container. Any yarn dist builds should also now show up on your host filesystem.

Manually Building the Docker Image

If you don't use VS Code or don't want it integrated with the container, you can build and run the container manually using either Docker or Podman.

1. From the root of your local Heroic directory, run:

docker build -t heroicdevcontainer -f Dockerfile .

2. Assuming all went well, you can now enter the container:

docker run -it -v ./:/tmp/heroic localhost/heroicdevcontainer:latest

3. The above command will mount your local Heroic dir to /tmp/heroic in the container (unless you used a different path).

cd /tmp/heoric

And you should be good to go, code and build away!

Linux

Debian, Ubuntu and Derivatives

Download the heroic_x.x.x_amd64.deb from the Releases section

sudo dpkg -i heroic_x.x.x_amd64.deb

Debian (third party apt repository)

You can add the MAD Linux apt repository:

bash <(wget -O- https://raw.githubusercontent.com/Heroic-Games-Launcher/HeroicGamesLauncher/main/madrepo.sh)

If you need support on it, get access to MAD Linux Guilded server.

Maybe you want to boost the download speed on updates with apt-fast:

sudo add-apt-repository -y ppa:apt-fast/stable
sudo apt install -y apt-fast
apt-fast install -y heroic

Arch (AUR)

AUR page: https://aur.archlinux.org/packages/heroic-games-launcher-bin/

To install it manually use:

git clone https://aur.archlinux.org/heroic-games-launcher-bin.git

cd heroic-games-launcher-bin

makepkg --cleanbuild --syncdeps --install --clean --rmdeps

Otherwise you can install it via your prefered AUR helper, e.g. yay.

Fedora

Heroic for Fedora is available on the COPR repo or as the binary on the releases page.

Other Distributions (AppImage and TAR.XZ)

Download the heroic-x.x.x.AppImage or heroic-x.x.x.tar.xz from the Releases section. Make sure you have Curl and Gawk, normally it comes with most distros but check for them if you have any issue.

To make the AppImage it executable use:

chmod +x heroic-x.x.x.AppImage

To run it use:

./heroic-x.x.x.AppImage

For the tar.xz file, you need first to extract it somewhere, enter the folder and run:

chmod +x heroic

To run it use:

./heroic

Windows

Download Heroic.Setup.x.x.x.exe or the Portable Heroic-x.x.x.exe file and run it. It will install it to the start menu and desktop, use those to run it.

macOS

Download Heroic-x.x.x.dmg and move the Heroic App to the Applications folder.

Build binaries locally (All platforms)

• All Platforms: Requires NodeJS to build
  Use yarn or npm

git clone https://github.com/Heroic-Games-Launcher/HeroicGamesLauncher.git

cd HeroicGamesLauncher

• Build for Linux:

yarn

yarn dist {package to create} (eg: deb, pacman, tar.xz, rpm, AppImage)

• Build for Windows (Beta):

yarn.cmd (or npm install)

yarn.cmd (or npm run) dist-win

• Build for Mac (Alpha):

yarn (or npm install)

yarn (or npm run) dist-mac

Screenshots