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 downloads and installs games from your Epic library directly to your file system, without the Epic Games Launcher. The core install command handles fresh installs, updates, and repairs all in one place — it automatically detects whether a game is already present and performs a delta update instead of a full re-download when possible.
Basic Installation
To install a game, pass its App Name as shown in legendary list:
legendary install <App Name>
# Full title match
legendary install "world of goo"
# Abbreviation
legendary install wog
Run legendary list first to see the app names and titles of all games on your account. The first run may take a moment to fetch your full game library.
Common Install Options
Install Location
DLC
Platform Override
Download Only
By default Legendary installs games to ~/Games (Linux/macOS) or a platform default on Windows. To specify a different base directory:legendary install <App Name> --base-path /mnt/games
legendary install <App Name> --base-path /mnt/games --game-folder MyGame
Legendary will ask whether to install DLC interactively. To skip the prompt:# Install the game with all available DLC
legendary install <App Name> --with-dlcs
# Skip DLC entirely (install base game only)
legendary install <App Name> --skip-dlcs
Some games have builds available for multiple platforms (for example, a macOS version alongside Windows). To install a specific platform build:legendary install <App Name> --platform Mac
Windows and Mac. The default is Windows on all platforms. To download game files without writing them to the final install location (useful for staging):legendary install <App Name> --download-only
Updating Games
The install command doubles as an update command — running it against an already-installed game performs a delta update:
legendary install <App Name>
legendary update <App Name>
legendary install <App Name> --update-only
legendary install <App Name> --disable-patching
legendary install <App Name> --disable-delta-manifests
Repairing Installations
To verify and re-download any missing or corrupted files:
legendary install <App Name> --repair
legendary install <App Name> --repair-and-update
Memory & Workers
CDN & Network
Control how much shared memory the download manager uses and how many parallel worker processes run:# Set shared memory buffer in MiB (config default: 2048)
legendary install <App Name> --max-shared-memory 4096
# Set number of download workers (default: min(cpu_count * 2, 16))
legendary install <App Name> --max-workers 8
legendary install <App Name> --enable-reordering
Pin downloads to a specific CDN hostname:legendary install <App Name> --preferred-cdn cdn.example.com
legendary install <App Name> --no-https
legendary install <App Name> --bind 192.168.1.10,192.168.1.11
Other Install Flags
| Flag | Description |
|---|
--force | Re-download all files even if they appear up to date |
--ignore-free-space | Skip the pre-flight free disk space check |
--dl-timeout <sec> | Per-chunk download timeout in seconds |
Managing Installed Games
List installed games:
Check for available updates while listing:
legendary list-installed --check-updates
--csv, --tsv, and --json are also supported. To include installation directories in the output:
legendary list-installed --show-dirs
legendary uninstall <App Name>
legendary uninstall <App Name> --keep-files
legendary move <App Name> /new/path
legendary move relocates the game folder to a new base path and updates Legendary’s install record. To update the record without physically moving files (if you have already moved them manually), add --skip-move.