Heroic is an Open Source Game Launcher for Linux, Windows and MacOS (for both Native and Windows Games using 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.

• 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

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

• 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

• Add Games outside Epic Games
• Integration with GOG)

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

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

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

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!

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

sudo dpkg -i heroic_x.x.x_amd64.deb

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

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.

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

If you use WinGet, just type: winget install heroic. otherwise 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.

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

• 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