Once Legendary is installed, you are only a handful of commands away from downloading and launching your Epic Games library entirely from the terminal. This guide walks you through authentication, browsing your library, installing a game, checking for updates, and launching a title — everything you need to be up and running in minutes.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.
Authenticate with Epic Games
Run the authentication command to log in to your Epic Games account:What happens next depends on your setup:
- With pywebview installed: An embedded browser window opens automatically. Log in and Legendary handles the rest.
- Without pywebview (standard browser flow): Legendary opens the Epic login page in your default browser. After logging in, you will see a JSON response in the browser. Copy the value of the
"authorizationCode"field and paste it into the terminal, then press Enter. - Importing from the Epic Games Launcher: If you already have EGL installed and want to reuse its session (note: this logs you out of EGL), run:
If your stored credentials are still valid from a previous session,
legendary auth will detect them and skip the login flow, reporting that the existing session is active.List Your Game Library
Fetch your full list of available games from Epic:The first run may take a while if you have a large library, as Legendary downloads and caches metadata for every title. Once complete, it prints each game’s app name (used for install/launch commands) alongside its display title.
Install a Game
Install a game using its app name from the list:As of version 0.20.12, Legendary also accepts partial title matches, so you do not need to know the exact app name. For example, both of the following work for World of Goo:Legendary will prompt you to confirm the install path and select any optional DLC or selective download components before downloading begins. Games are installed to
~/Games by default — this can be changed in the config file.Check Installed Games and Updates
See all your installed games and whether any updates are available:This prints a table of installed titles along with their installed version, and flags any that have a newer version available on Epic’s CDN. To update a game, run
legendary install <App Name> — the install command also serves as the update command.Launch a Game
Launch a game with full online authentication (required for multiplayer and DRM-protected titles):Offline mode — Most games run fine without contacting Epic’s servers. To skip online authentication:Dry run — To get the exact launch command without actually running the game (useful for integrating into Lutris, Steam, or other launchers):
What’s Next
Now that you have the basics down, explore the rest of the documentation to get the most out of Legendary:Configuration File
Customize Legendary’s behavior with per-game settings, WINE configuration, aliases, environment variables, and more.
Installing Games
Learn about selective downloads, DLC management, custom install paths, delta patching, and repairing installations.
Cloud Saves
Sync your save games to and from the Epic cloud, compatible with the Epic Games Launcher’s save format.
Commands Overview
Browse the full reference for every Legendary command, including EGL sync, EOS overlay, aliases, and third-party activation.