Heroic Games Launcher
Heroic is an Open Source Game Launcher for Linux, Windows and macOS.
Right now it supports launching games from the Epic Games Store using Legendary, GOG Games using our custom implementation with gogdl and Amazon Games using Nile.
Heroic is built with Web Technologies:
Index
- Heroic Games Launcher
- Index
- Features available right now
- Planned features
- Supported Operating Systems
- Language Support
- Help with Translations Here
- Installation
- Linux
- Windows
- macOS
- Development environment
- Building Heroic Binaries
- Building with VS Code
- Quickly testing/debugging Heroic on your own system
- Development Using a Container
- Testing with Docker
- Sponsors
- Screenshots
- Credits
Features available right now
- Login with an existing Epic Games, GOG or Amazon account
- Install, uninstall, update, repair and move Games
- Import an already installed game
- Play Epic games online [AntiCheat on macOS and on Linux depends on the game]
- Play games using Wine or Proton [Linux]
- Play games using Crossover [macOS]
- Download custom Wine and Proton versions [Linux]
- Access to Epic and GOG stores directly from Heroic
- Search for the game on ProtonDB for compatibility information [Linux]
- Show ProtonDB and Steam Deck compatibility information [Linux]
- Sync installed games with an existing Epic Games Store installation
- Sync saves with the cloud
- Custom Theming Support
- Download queue
- Add Games and Applications outside GOG, Epic Games and Amazon Games
Planned features
- Support Other Store (IndieGala, etc)
- Play GOG games online
Supported Operating Systems
- Linux:
- Ubuntu 20.04LTS or newer
- Fedora 33 or newer
- Arch Linux & derivatives (Manjaro, Garuda, EndeavourOS)
- Heroic will still work on most distros, but it is up to you to get it to work Chances are though that someone on our Discord can help you
- SteamOS (downloading using Discover only)
- Windows 10 & 11
- macOS 12 or newer
Language Support
Expand
Thanks to the community, Heroic was translated to almost 40 different languages so far: - English - Azerbaijani - Basque - Belarussian - Bosnian - Bulgarian - Catalan - Czech - Croatian - Simplified Chinese - Traditional Chinese - Dutch - Estonian - Finnish - French - German - Greek - Japanese - Korean - Hungarian - Italian - Indonesian - Malayalam - Norwegian Bokmål - Persian - Polish - Portuguese - Portuguese (Brazil) - Romanian - Russian - Spanish - Slovak - Swedish - Tamil - Turkish - Ukrainian - VietnameseHelp with Translations Here
Installation
Linux
Flatpak
Heroic is available on Flathub, so you should be able to easily install it on most distros with Software Centers (Pop!_Shop, Discover, etc.)
Debian, Ubuntu and Derivatives
Download the file ending in .deb from the latest release.
Double-click it to open it up in your Software Manager, or run sudo dpkg -i heroic_*_amd64.deb to install it directly:
Arch (AUR)
We have two AUR packages available:
(stable release, recommended)
(beta release, contains newer features but might be unstable)
Please see the Arch Wiki on how to install them
Fedora
COPR repo
Heroic for Fedora is available on this COPR repo.
Enable it with sudo dnf copr enable atim/heroic-games-launcher, then install Heroic with sudo dnf install heroic-games-launcher-bin
Binary package from the releases page
You can alternatively download the file ending in .rpm from the latest release and install it with sudo dnf install ./heroic-*.x86_64.rpm
Other Distributions (AppImage and TAR.XZ)
Since these two distribution formats don't have a form of dependency management, make sure the curl command is available. You might run into weird issues if it's not.
AppImage
- Download the file ending in .AppImage from the latest release
- Make it executable (
chmod +x Heroic*.AppImage) - Run it (double-click in most file managers, or run
./Heroic*.AppImage)
.tar.xz
- Download the file ending in .tar.xz from the latest release
- Extract it anywhere
- Run the
heroicfile in the folder you extracted it to (double-click in most file managers, or run./heroic)
Windows
WinGet
If you use WinGet (installed by default on Windows 11 and modern versions of 10), you can run winget install Heroic in a terminal to install Heroic.
Manual installl
Download the Heroic Installer (Heroic-x.x.x-Setup.exe) or the portable version (Heroic-x.x.x-Portable.exe) from the latest release. Run the executable you downloaded to install/run Heroic.
The Setup will create shortcuts to Heroic on your Desktop and in your Start Menu.
macOS
If you use Homebrew, you can run brew install --cask --no-quarantine heroic to install Heroic.
Otherwise, download the file ending in .dmg from the latest release, double-click it to mount it, and drag the "Heroic" application into the "Applications" folder.
Development environment
This part will walk you through setting up a development environment so you can build Heroic binaries yourself or make changes to the code.
-
Make sure Git, NodeJS, and Yarn are installed
-
Clone the repo and enter the cloned folder, for example with these commands:
git clone https://github.com/Heroic-Games-Launcher/HeroicGamesLauncher.git --recurse-submodules cd HeroicGamesLauncher -
Make sure all dependencies are installed by running
yarn
Building Heroic Binaries
Run the appropriate command for your OS:
-
Build for Linux:
yarn dist:linux # Optionally specify a package to create (eg: deb, pacman, tar.xz, rpm, AppImage); default: AppImage -
Build for Windows:
yarn dist:win -
Build for Mac:
yarn dist:mac
Building with VS Code
Instead of using the above commands to build Heroic, you can also use the Tasks in VSCode to build. To do that, open up the command palette (Ctrl + P), type in "task" and press Space. You will then see 3 build tasks, "Build for Linux", "Build for Windows", and "Build for MacOS". Click the one you want to run.
Quickly testing/debugging Heroic on your own system
If you want to quickly test a change, or you're implementing features that require a lot of restarts, you can use Vite's development server to speed up the process:
Go to the "Run and Debug" tab of VSCode and start the "Launch Heroic (HMR & HR)" task (alternatively, if you're not using VSCode or just prefer the terminal, run yarn start). Heroic will start up after a short while, and once you make any change to the code, it'll reload/restart.
Note: If you do not need the React developer tools while testing changes, you can skip their install by setting the HEROIC_NO_REACT_DEVTOOLS environment variable before running yarn start (for example with HEROIC_NO_REACT_DEVTOOLS=1 yarn start).
Development Using a Container
Expand
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:linux 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: ```bash docker build -t heroicdevcontainer -f Dockerfile . ``` 2. Assuming all went well, you can now enter the container: ```bash 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/heroic ``` And you should be good to go, code and build away!Testing with Docker
It is recommended to run end to end tests with Docker so you don't alter your local config files or have your local config files interfere with the tests.
To run e2e tests on the unpackaged app running in dev mode. From the root of your local Heroic directory, run:
yarn test:e2eTo run e2e tests on the packaged app. From the root of your local Heroic directory, run:
yarn test:e2ePackagedSponsors
Thanks Weblate for hosting our translations
Thanks Signpath for providing free signing of Windows binaries
