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 command-line replacement for the Epic Games Launcher. It lets you authenticate with your Epic Games account, download and install games, sync cloud saves, and launch titles — all from the terminal without installing the official launcher. It runs on Linux, macOS, and Windows, and supports running Windows games on Linux and macOS via Wine or CrossOver.

Installation

Install Legendary via PyPI, a prebuilt binary, or your distro’s package manager

Quickstart

Authenticate, list your games, and install your first title in minutes

Configuration

Customize global and per-game settings with the INI config file

Command Reference

Full reference for every Legendary CLI command and flag

What Legendary Can Do

Download & Install Games

Download Epic Games with delta patching, selective file downloads, and DLC support

Cloud Save Sync

Bidirectionally sync save games with the Epic cloud — compatible with EGL

Wine & Linux Gaming

Run Windows-only Epic titles on Linux using Wine or Proton wrappers

CrossOver (macOS)

Launch Windows games on macOS using CodeWeavers CrossOver

EGL Sync

Import and export game installations between Legendary and the Epic Games Launcher

EOS Overlay

Install and manage the Epic Online Services overlay for supported games

Getting Started

1

Install Legendary

Install via pip, a prebuilt binary, or your Linux distro’s package manager.
pip install legendary-gl
2

Authenticate

Log in to your Epic Games account. Legendary will open the Epic login page in your browser.
legendary auth
3

List your games

Fetch and display all games available on your account.
legendary list
4

Install a game

Download and install any game using its app name or a partial title match.
legendary install "world of goo"
Legendary is a CLI-only application. There is no graphical interface — all commands are run from a terminal or shell (e.g., Bash, Zsh, or PowerShell).

Build docs developers (and LLMs) love