Heroic Games Launcher

Heroic is an Open Source Game Launcher for Linux, Windows and MacOS (Limited to Windows games using Wine/Crossover – tested only on Intel and on 10.14).
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.

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
  • Catalan
  • Czech
  • Croatian
  • Simplified Chinese
  • Traditional Chinese
  • Dutch
  • French
  • German
  • Greek
  • Korean
  • Hungarian
  • Italian
  • Malayalam
  • Polish
  • Portuguese
  • Portuguese (Brazil)
  • Russian
  • Spanish
  • Swedish
  • Tamil
  • Turkish

Help with Translations Here


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 .
  1. Assuming all went well, you can now enter the container:

docker run -it -v ./:/tmp/heroic localhost/heroicdevcontainer:latest
  1. 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!


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 version

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.


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

Other Distributions

Download the heroic-x.x.x.AppImage from the Releases section.

To make it executable use:

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

To run it use:



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


Download Heroic-x.x.x.dmg and install it.

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 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




View Github