Heroic is an Open Source Game Launcher for Linux, Windows (Beta) and MacOS (Limited to Windows games using Wine/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 is an open-source game launcher designed to simplify gaming on Linux, Windows (beta), and macOS. It supports launching games from popular platforms like the Epic Games Store using Legendary, a lightweight CLI alternative to the official Epic Games Launcher.
Key Features:
Multi-Platform Support: Play games on Linux, Windows, and macOS, with limited support for macOS via Wine or Crossover.
Epic Games Store Integration: Seamlessly launch games purchased from the Epic Games Store using Legendary.
Customizable UI: Enjoy a sleek, modern interface with customizable themes and layouts.
Performance Monitoring: Track game performance with built-in benchmarking and FPS monitoring tools.
Audience & Benefit:
Ideal for gamers on Linux, Windows, or macOS who seek an open-source alternative to proprietary launchers. Heroic offers a seamless way to manage games across platforms while providing powerful customization and performance tracking features. It can be installed via winget for easy setup.
README
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 available on Flathub, so you should be able to easily install it on most distros with Software Centers (Pop!_Shop, Discover, etc.)
Distribution-specific instructions
If you're not using the Flatpak version, make sure you have all Wine dependencies installed:
Wine Dependencies.
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 currently only support one AUR package: heroic-games-launcher-bin. Although you might find other packages there, do not ask support for them on this Github or on our Discord, ask their maintainers directly.
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
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 heroic file 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 pnpm 10 are installed NOTE: On Windows, due to an issue with electron-builder, you'll need the standalone version of pnpm (@pnpm/exe)
to build packages
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 pnpm install
Download all helper binaries using pnpm download-helper-binaries
Building Heroic Binaries
Run the appropriate command for your OS:
Build for Linux:
pnpm dist:linux # Optionally specify a package to create (eg: deb, pacman, tar.xz, rpm, AppImage); default: AppImage
Build for Windows:
pnpm dist:win
Build for Mac:
pnpm 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 pnpm start). Heroic will start up after a short while, and once you make any change to the code, it'll reload/restart.
Development on Nix
After cloning the repository, Nix users can use nix-shell to make Node.JS/pnpm available and automatically run installation step 3 and 4. See shell.nix for more information.
