Skip to main content

Documentation Index

Fetch the complete documentation index at: https://mintlify.com/legendary-gl/legendary/llms.txt

Use this file to discover all available pages before exploring further.

Legendary is a free, open-source command-line replacement for the Epic Games Launcher, built for players and power users who want full control over their Epic Games library without a heavyweight GUI application. It lets you authenticate with Epic’s platform, download and install your games, manage DLC, sync cloud saves, and launch titles with online authentication — all from the terminal. The name is a tongue-in-cheek nod to the legendary tier of item rarity found in many MMORPGs. Licensed under the GPL-3.0, Legendary is community-driven and runs on Linux, Windows 8.1+, and macOS 12.0+.
Legendary is currently a CLI (command-line interface) application without a graphical user interface. It must be run from a terminal such as Bash, Zsh, or PowerShell. A simple GUI for managing and launching games is planned for a future release.

​
Supported Platforms

PlatformMinimum Version
LinuxAny modern distro (glibc ≥ 2.25 for prebuilt binary)
Windows8.1+ (64-bit)
macOS12.0+ (64-bit)
32-bit operating systems are not supported on any platform.

​
Key Features

Authentication

Log in to your Epic Games account via browser, webview (with pywebview), authorization code, or by importing credentials directly from the Epic Games Launcher.

Download & Install

Download and install games and their DLC with delta patching, selective downloading, multi-worker support, and resume capability.

Cloud Saves

Sync, upload, and download cloud saves fully compatible with the Epic Games Launcher’s save format.

Wine & Linux Support

Run Windows-only Epic titles on Linux and macOS using Wine or CrossOver, with per-game WINE prefix configuration.

EGL Sync

Import and export installed games between Legendary and the Epic Games Launcher, with optional automatic bidirectional sync.

EOS Overlay

Install, update, enable, or disable the Epic Online Services overlay for compatible multiplayer titles.

Aliases

Define short, memorable aliases for game app names in your config file, or let Legendary auto-generate them from game titles.

Third-Party Activation

Activate Ubisoft Connect (Uplay) and EA/Origin titles that are linked to your Epic Games account.

​
Requirements

Before installing Legendary, make sure your system meets the following requirements. Runtime:
  • Python 3.10+ (64-bit) — required for all installation methods except the prebuilt standalone binary
  • Windows users: Python must be below 3.14 due to a pythonnet incompatibility
PyPI dependencies (installed automatically via pip):
  • requests — HTTP client for Epic’s APIs
  • filelock — safe concurrent file access
  • pycryptodomex — cryptography for manifest handling
Optional dependencies:
  • pywebview (≥ 3.4) — enables an embedded browser window for a smoother login experience; not required if you prefer the manual authorization code flow
  • On Linux (Ubuntu), the pywebview GTK backend also requires python3-gi-cairo
Running Windows games on Linux or macOS requires Wine or CrossOver to be installed separately. Legendary handles the invocation — Wine itself must be present on your system.

​
License

Legendary is licensed under the GNU General Public License v3.0 or later (GPL-3.0-or-later). The full license text is included in the repository. Ready to get up and running? Head to the Installation guide to install Legendary on your platform.

Build docs developers (and LLMs) love

Get started for freeTalk to us