Black Lives Matter. Support the Equal Justice Initiative and read our statement here.
Heroic

Heroic

Fast epic games launcher for Linux, Windows and Mac.

Heroic Games Launcher

Discord GitHub release GitHub all releases GPLv3 license Patreon Donate kofi

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 and GOG Games using our custom implementation with gogdl. Heroic is built with Web Technologies like: TypeScript, React, NodeJS and Electron.

Index

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
  • Login with an existing GOG 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
  • Open game page on GOG.com
  • Search for the game on ProtonDB [Linux]
  • Sync installed games with an existing Epic Games instalation
  • Sync saves with the cloud [Epic]

Planned features

  • Theming Support
  • Download queue
  • Add Games outside GOG and Epic Games
  • Support Other Store (Amazon Gaming, IndieGala, etc)

Language Support

  • 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
  • Ukranian
  • Vietnamize

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

Linux

Flatpak

Heroic is available on Flathub, so should be on most distros when using Software Centers like Pop_OS! Store or Discover. But can also be accessed here

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.

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

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

macOS

If you use Homebrew, just type: brew install --cask heroic. Otherwise, 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

epic gog login stores wine-manager gamepage

jump

not_used

Something missing? Edit this app.

Keyboard Shortcuts

Key Action
/ Focus the search bar
Esc Focus the search bar and cleans it
Select the next search result
Select the previous search result
Enter Open the selected search result
cmdEnter Ctrl+Enter Open the selected search result in a new tab