explaingit

heroic-games-launcher/heroicgameslauncher

★ 11,368TypeScriptAudience · generalComplexity · 2/5LicenseSetup · easy

TLDR

Open-source desktop app for Linux, Windows, and macOS that lets you install and play games from Epic Games, GOG, and Amazon Games in one unified launcher.

Mindmap

mindmap
  root((repo))
    What it does
      Multi-store launcher
      Linux game support
      Wine Proton setup
    Stores
      Epic Games
      GOG
      Amazon Games
    Platforms
      Linux distros
      Windows 10 11
      macOS 14 plus
    Features
      Cloud save sync
      Download queue
      ProtonDB lookup
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Play Epic Games Store titles on Linux where the official launcher does not run natively.

USE CASE 2

Manage GOG, Epic, and Amazon Games libraries from a single app instead of juggling three separate launchers.

USE CASE 3

Run Windows-only games on Linux using Wine or Proton compatibility layers configured through the Heroic UI.

USE CASE 4

Sync cloud saves and manage a download queue for games across multiple stores in one place.

Tech stack

TypeScriptElectronReactWineProton

Getting it running

Difficulty · easy Time to first run · 5min
Free to use and modify, but any version you distribute must also be released under the same GPL license.

In plain English

Heroic Games Launcher is an open source application that lets you play games from three stores, Epic Games, GOG, and Amazon Games, on Linux, Windows, and macOS. It is an alternative to each store's own official launcher, built for people who want to manage games from multiple stores in one place or who need features the official launchers do not provide on Linux. On Linux in particular, Heroic fills a significant gap: the Epic Games Launcher does not run natively on Linux at all, but Heroic uses a community tool called Legendary under the hood to communicate with Epic's servers. Similarly, it uses gogdl for GOG and Nile for Amazon. Heroic then lets you run those games using Wine or Proton compatibility layers, which translate Windows game code to run on Linux. You can also look up a game's Linux compatibility information from ProtonDB directly inside the launcher. Features include logging in with your existing Epic, GOG, or Amazon accounts, installing, updating, uninstalling, repairing, or moving games, importing games you have already installed elsewhere, cloud save syncing, a download queue, custom themes, and the ability to add games from outside these three stores. The app also has built-in access to each store's browse and purchase page. The application works on Ubuntu, Fedora, Arch Linux, SteamOS, Windows 10 and 11, and macOS 14 or newer. On Linux it can be installed from Flathub (the most straightforward method), a .deb or .rpm package, the AUR on Arch, or as an AppImage. The interface has been translated into nearly 40 languages by community volunteers. The project is GPL-licensed and supported through Patreon and donations.

Copy-paste prompts

Prompt 1
Walk me through installing Heroic Games Launcher on Ubuntu via Flatpak, logging into Epic Games, and downloading a game.
Prompt 2
How do I change the Wine or Proton version for a specific game in Heroic to improve compatibility on my Linux machine?
Prompt 3
I already have Epic Games installed on Windows and want to switch to Heroic, how do I import my existing game installations without re-downloading?
Prompt 4
Show me how to look up ProtonDB compatibility ratings for a game directly inside the Heroic launcher on SteamOS.
Open on GitHub → Explain another repo

← heroic-games-launcher on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.