install

Additional install commands

macOS

Homebrew Caskverified · 100%

brew install --cask heroic

local Homebrew cask metadata

overview

Package summary

Game launcher

Project links

Commands and aliases

No executable aliases were found in the local package database.

history

Project history and usage

Heroic Games Launcher is a community-maintained, open-source launcher for Epic Games, GOG, and Amazon Games on Linux, Windows, and macOS.

Project history

Heroic Games Launcher began as a community-built, GPLv3 graphical alternative to proprietary game-store launchers. It developed from an Epic-oriented Legendary front end into a multi-store launcher covering Epic, GOG, and Amazon libraries across Linux, Windows, and macOS.

Adoption history

Heroic grew into a cross-platform launcher supporting Linux, Windows, and macOS. The official project reports support for Epic Games through Legendary, GOG through GOGdl, and Amazon Games through Nile, plus manually added games and websites. On Linux it is widely distributed through Flatpak and distribution packages.

How it is used

Users authenticate with supported storefronts, browse owned games, install and update them, manage compatibility layers, launch games, synchronize cloud saves, and add external games or websites. Linux users commonly pair Heroic with Wine or Proton runners for Windows titles.

Why package nerds care

Heroic is important in Linux gaming because it provides an open-source alternative to proprietary storefront launchers, especially where vendors do not ship native Linux clients. Its modular reliance on Legendary, GOGdl, Nile, Wine, Proton, and related compatibility components makes it a visible integration point for the modern Linux gaming stack.

Timeline

2020s: Heroic emerged as an open-source graphical front end for non-Steam game libraries.
2020s: Support expanded across Epic, GOG, and Amazon Games and across Linux, Windows, and macOS.
2025: The official wiki documented Heroic as a multi-launcher alternative maintained by a volunteer community.

Related projects

Legendary handles Epic Games authentication, downloads, and launching.
GOGdl provides GOG downloading support.
Nile provides Amazon Games support.
Wine, Proton, DXVK, VKD3D, and UMU form part of the compatibility stack used to run Windows games, especially on Linux.

Sources

security posture

No protected-tool coverage found yet

No matching local secret-handling manifest was found for heroic. Package metadata is still published here so future coverage has a stable package URL.

Install behavior

No Homebrew post-install hook is recorded in formula metadata.
No Homebrew bottle metadata was recorded.

Recommended review

Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.

local files

Configuration and credential file locations

These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.

Configuration files

Config paths the tool may read or write during local use.

Linux: ~/.config/heroic/config.json~/.config/legendary/
macOS: ~/Library/Application Support/heroic/~/.config/heroic/config.json~/.config/legendary/
Windows: %AppData%\heroic\%UserProfile%\.config\heroic\config.json%UserProfile%\.config\legendary\

executables

Installed executables

Command	Kind	Exposure	Note
No executable data was present.

freshness

Version and freshness

These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.

page generated2026-11-04

manager version2.22.4

manager updated

local dataok

upstreamnot checked

latest detectednot detected

https://github.com/Heroic-Games-Launcher/HeroicGamesLauncher

infoNo package-manager update timestamp was available.low confidence
infoNo cached GitHub release or tag data was available.https://github.com/Heroic-Games-Launcher/HeroicGamesLaunchernone confidence

install metadata

Package metadata

Package key	cask:heroic
Version	2.22.4
Package manager	Homebrew Cask
Package manager page	https://formulae.brew.sh/cask/heroic
Homepage	https://github.com/Heroic-Games-Launcher/HeroicGamesLauncher/
Repository	https://github.com/Heroic-Games-Launcher/HeroicGamesLauncher
Upstream docs	https://github.com/Heroic-Games-Launcher/HeroicGamesLauncher/
Source archive	https://github.com/Heroic-Games-Launcher/HeroicGamesLauncher/releases/download/v2.22.4/Heroic-2.22.4-macOS-arm64.dmg
SHA-256	29d5476a4bf1aea4dd3c907253a49ba3272223b420c5bac8c72995b36b57cd89
Bottle	not recorded
Homebrew post-install	not defined
Service	none declared

registry facts

Source database details

Source Database	Homebrew cask API
Tap	homebrew/cask
Full Token	heroic
Names	Heroic Games Launcher
Depends On	Macos >=: 12
Artifacts	App 1 Target 1 Zap 1
Auto Updates	yes
Deprecated	no
Disabled	no

package graph

Links come from deterministic package relationships, av.db category and tag curation, ecosystem matches, and package hub membership.

source trail

Generated from repository data

This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.

Combined YAML source

View the package source record on GitHub.

combined/heroic.yml

Used sources

cross-ecosystem install command graph
curated configuration and credential file locations
curated package history
package relationship graph
package version freshness
package-page enrichment

Install heroic with Homebrew Cask