base on A games launcher for GOG, Amazon and Epic Games for Linux, Windows and macOS. # Heroic Games Launcher [](https://github.com/Heroic-Games-Launcher/HeroicGamesLauncher/releases/latest) [](https://github.com/Heroic-Games-Launcher/HeroicGamesLauncher/releases/) [](https://flathub.org/apps/details/com.heroicgameslauncher.hgl) [](https://github.com/Heroic-Games-Launcher/HeroicGamesLauncher/blob/main/COPYING) [](https://discord.gg/rHJ2uqdquK) [](https://patreon.com/heroicgameslauncher) [](https://www.paypal.me/heroiclauncher) [](https://ko-fi.com/heroicgames) 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](https://github.com/derrod/legendary), GOG Games using our custom implementation with [gogdl](https://github.com/Heroic-Games-Launcher/heroic-gogdl) and Amazon Games using [Nile](https://github.com/imLinguin/nile). Heroic is built with Web Technologies: [](https://www.typescriptlang.org/) [](https://reactjs.org/) [](https://mui.com/) [](https://nodejs.org/) [](https://www.electronjs.org/) [](https://www.electron.build/) [](https://jestjs.io/) [](https://vitejs.dev/) ## Index - [Heroic Games Launcher](#heroic-games-launcher) - [Index](#index) - [Features available right now](#features-available-right-now) - [Planned features](#planned-features) - [Supported Operating Systems](#supported-operating-systems) - [Language Support](#language-support) - [Help with Translations Here](#help-with-translations-here) - [Installation](#installation) - [Linux](#linux) - [Flatpak](#flatpak) - [Debian, Ubuntu and Derivatives](#debian-ubuntu-and-derivatives) - [Arch (AUR)](#arch-aur) - [Fedora](#fedora) - [Other Distributions (AppImage and TAR.XZ)](#other-distributions-appimage-and-tarxz) - [Windows](#windows) - [macOS](#macos) - [Development environment](#development-environment) - [Building Heroic Binaries](#building-heroic-binaries) - [Building with VS Code](#building-with-vs-code) - [Quickly testing/debugging Heroic on your own system](#quickly-testingdebugging-heroic-on-your-own-system) - [Testing with Docker](#testing-with-docker) - [Sponsors](#sponsors) - [Screenshots](#screenshots) - [Credits](#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, GOG and Amazon Games 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 - Define your categories to organize your collection ## Planned features - Support Other Store (IndieGala, etc) ## 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](https://discord.gg/rHJ2uqdquK) can help you - SteamOS (downloading using Discover only) - Windows 10 & 11 - macOS 12 or newer ## Language Support <details> <summary>Expand</summary> 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 - Hebraic - Japanese - Korean - Hungarian - Italian - Indonesian - Malayalam - Norwegian Bokmål - Persian - Polish - Portuguese - Portuguese (Brazil) - Romanian - Russian - Serbian - Spanish - Slovak - Swedish - Tamil - Turkish - Ukrainian - Vietnamese </details> ### Help with Translations [Here](https://hosted.weblate.org/projects/heroic-games-launcher) ## Installation ### Linux #### Flatpak [<img src="https://flathub.org/assets/badges/flathub-badge-en.png" alt="Flathub Badge" width="10%" />](https://flathub.org/apps/details/com.heroicgameslauncher.hgl) 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](https://github.com/lutris/docs/blob/master/WineDependencies.md). #### Debian, Ubuntu and Derivatives Download the file ending in .deb from the [latest release](https://github.com/Heroic-Games-Launcher/HeroicGamesLauncher/releases/latest). 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. - [](https://aur.archlinux.org/packages/heroic-games-launcher-bin) (stable release, recommended) Please see [the Arch Wiki](https://wiki.archlinux.org/title/Arch_User_Repository#Installing_and_upgrading_packages) on how to install them #### Fedora ##### COPR repo Heroic for Fedora is available on [this COPR repo](https://copr.fedorainfracloud.org/coprs/atim/heroic-games-launcher/). 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](https://github.com/Heroic-Games-Launcher/HeroicGamesLauncher/releases/latest) 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](https://github.com/Heroic-Games-Launcher/HeroicGamesLauncher/releases/latest) - 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](https://github.com/Heroic-Games-Launcher/HeroicGamesLauncher/releases/latest) - 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](https://github.com/Heroic-Games-Launcher/HeroicGamesLauncher/releases/latest). 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](https://github.com/Heroic-Games-Launcher/HeroicGamesLauncher/releases/latest), 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. 1. Make sure Git, NodeJS, and pnpm 9 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 2. Clone the repo and enter the cloned folder, for example with these commands: ```bash git clone https://github.com/Heroic-Games-Launcher/HeroicGamesLauncher.git --recurse-submodules cd HeroicGamesLauncher ``` 3. Make sure all dependencies are installed by running `pnpm install` ### Building Heroic Binaries Run the appropriate command for your OS: - Build for Linux: ```bash pnpm dist:linux # Optionally specify a package to create (eg: deb, pacman, tar.xz, rpm, AppImage); default: AppImage ``` - Build for Windows: ```bash pnpm dist:win ``` - Build for Mac: ```bash 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. ## Sponsors Thanks [Weblate](https://weblate.org/en/) for hosting our translations  Thanks [Signpath](https://signpath.io/?utm_source=foundation&utm_medium=github&utm_campaign=heroicgameslauncher) for providing free signing of Windows binaries [](https://signpath.io/?utm_source=foundation&utm_medium=github&utm_campaign=heroicgameslauncher) ## Screenshots <details> <summary>Expand</summary>        </details> ## Credits ### Weblate: Localization platform - URL: https://weblate.org/en/ ### Those Awesome Guys: Gamepad prompts images - URL: https://thoseawesomeguys.com/prompts/ [](#heroic-games-launcher) ", Assign "at most 3 tags" to the expected json: {"id":"3240","tags":[]} "only from the tags list I provide: [{"id":77,"name":"3d"},{"id":89,"name":"agent"},{"id":17,"name":"ai"},{"id":54,"name":"algorithm"},{"id":24,"name":"api"},{"id":44,"name":"authentication"},{"id":3,"name":"aws"},{"id":27,"name":"backend"},{"id":60,"name":"benchmark"},{"id":72,"name":"best-practices"},{"id":39,"name":"bitcoin"},{"id":37,"name":"blockchain"},{"id":1,"name":"blog"},{"id":45,"name":"bundler"},{"id":58,"name":"cache"},{"id":21,"name":"chat"},{"id":49,"name":"cicd"},{"id":4,"name":"cli"},{"id":64,"name":"cloud-native"},{"id":48,"name":"cms"},{"id":61,"name":"compiler"},{"id":68,"name":"containerization"},{"id":92,"name":"crm"},{"id":34,"name":"data"},{"id":47,"name":"database"},{"id":8,"name":"declarative-gui "},{"id":9,"name":"deploy-tool"},{"id":53,"name":"desktop-app"},{"id":6,"name":"dev-exp-lib"},{"id":59,"name":"dev-tool"},{"id":13,"name":"ecommerce"},{"id":26,"name":"editor"},{"id":66,"name":"emulator"},{"id":62,"name":"filesystem"},{"id":80,"name":"finance"},{"id":15,"name":"firmware"},{"id":73,"name":"for-fun"},{"id":2,"name":"framework"},{"id":11,"name":"frontend"},{"id":22,"name":"game"},{"id":81,"name":"game-engine "},{"id":23,"name":"graphql"},{"id":84,"name":"gui"},{"id":91,"name":"http"},{"id":5,"name":"http-client"},{"id":51,"name":"iac"},{"id":30,"name":"ide"},{"id":78,"name":"iot"},{"id":40,"name":"json"},{"id":83,"name":"julian"},{"id":38,"name":"k8s"},{"id":31,"name":"language"},{"id":10,"name":"learning-resource"},{"id":33,"name":"lib"},{"id":41,"name":"linter"},{"id":28,"name":"lms"},{"id":16,"name":"logging"},{"id":76,"name":"low-code"},{"id":90,"name":"message-queue"},{"id":42,"name":"mobile-app"},{"id":18,"name":"monitoring"},{"id":36,"name":"networking"},{"id":7,"name":"node-version"},{"id":55,"name":"nosql"},{"id":57,"name":"observability"},{"id":46,"name":"orm"},{"id":52,"name":"os"},{"id":14,"name":"parser"},{"id":74,"name":"react"},{"id":82,"name":"real-time"},{"id":56,"name":"robot"},{"id":65,"name":"runtime"},{"id":32,"name":"sdk"},{"id":71,"name":"search"},{"id":63,"name":"secrets"},{"id":25,"name":"security"},{"id":85,"name":"server"},{"id":86,"name":"serverless"},{"id":70,"name":"storage"},{"id":75,"name":"system-design"},{"id":79,"name":"terminal"},{"id":29,"name":"testing"},{"id":12,"name":"ui"},{"id":50,"name":"ux"},{"id":88,"name":"video"},{"id":20,"name":"web-app"},{"id":35,"name":"web-server"},{"id":43,"name":"webassembly"},{"id":69,"name":"workflow"},{"id":87,"name":"yaml"}]" returns me the "expected json"