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 launch starts an installed Epic game, handling authentication with Epic’s backend, setting up the correct environment variables, and forwarding any extra arguments directly to the game executable. It supports online and offline modes, WINE and CrossOver on Linux/macOS, arbitrary wrapper commands (such as gamemoderun or mangohud), language overrides, and a dry-run mode that prints the full launch command without executing it — handy for copying launch parameters into Lutris or Steam.

​
Usage

legendary launch <App Name> [options]
Any additional arguments that follow the known Legendary flags are passed through directly to the game process. The <App Name> accepts the exact app name, a partial title match, or a configured alias.

​
Flags

​
Authentication & online behavior

​
--offline
flag
Skip the Epic login step and launch the game without online authentication. Most single-player titles work fine in offline mode.
​
--skip-version-check
flag
Skip the version check when launching in online mode. Useful if you intentionally have an older version installed and want to avoid the update prompt.
​
--override-username <username>
string
Override the username presented to the game at launch. Only works with titles that accept this parameter.

​
Launch control

​
--dry-run
flag
Print the exact command line that would be used to launch the game, then exit without running it. Ideal for extracting launch parameters to paste into other launchers such as Lutris or Steam.
​
--override-exe <exe path>
string
Override the default executable to launch, specified as a path relative to the game installation directory. Useful for launching alternative executables bundled with the game.
​
--origin
flag
Launch Origin/EA App to activate or run the game rather than launching it directly. Required for EA-managed titles.
​
--json
flag
Print all launch information (executable path, arguments, environment variables) as JSON and exit without launching the game.

​
Wrapper & environment

​
--wrapper <wrapper command>
string
Prefix the game’s launch command with the given wrapper. For example, --wrapper gamemoderun or --wrapper "mangohud". Separate multiple wrappers with spaces within the quoted string.
​
--language <two letter code>
string
Override the language passed to the game. Accepts a standard two-letter language code (e.g. fr, de, ja). Defaults to the system locale.

​
Persisting settings

​
--set-defaults
flag
Save the launch parameters used in this invocation to Legendary’s config file so they are applied automatically on future launches. Note: environment variables are not saved.
​
--reset-defaults
flag
Remove all saved config settings for this app and exit. The next launch will use default parameters.

​
WINE (Linux / macOS)

​
--wine <wine binary>
string
Path to the Wine binary to use when launching Windows games on Linux or macOS (e.g. /usr/bin/wine64).
​
--wine-prefix <wine pfx path>
string
Path to the Wine prefix directory to use (e.g. ~/.wine).
​
--no-wine
flag
Do not use Wine even if it is configured. Use this when running the game through a wrapper that manages Wine internally.

​
CrossOver (macOS)

​
--crossover
flag
Interactively configure CrossOver for this application, prompting you to select the CrossOver app and bottle to use.
​
--crossover-app <path to .app>
string
Specify the CrossOver .app to use (e.g. "/Applications/CrossOver.app").
​
--crossover-bottle <bottle name>
string
Specify which CrossOver bottle to run the game in.

​
Examples

# Launch a game with online authentication
legendary launch Anemone

# Launch a game in offline mode
legendary launch Anemone --offline

# Print the launch command without running it (for Lutris, Steam, etc.)
legendary launch Anemone --offline --dry-run

# Print full launch information as JSON
legendary launch Anemone --json

# Launch with a specific Wine binary and prefix
legendary launch Anemone --wine /usr/bin/wine64 --wine-prefix ~/.wine

# Launch with gamemode for better performance
legendary launch Anemone --wrapper gamemoderun

# Launch with multiple wrappers
legendary launch Anemone --wrapper "gamemoderun mangohud"

# Save Wine settings as defaults for future launches
legendary launch Anemone --wine /usr/bin/wine64 --wine-prefix ~/.wine --set-defaults

# Override the game language to French
legendary launch Anemone --language fr

# Launch in online mode but skip the version check
legendary launch Anemone --skip-version-check

# Use CrossOver on macOS with a specific bottle
legendary launch Anemone --crossover-app "/Applications/CrossOver.app" --crossover-bottle MyBottle

# Reset all saved launch defaults for a game
legendary launch Anemone --reset-defaults

​
Notes

Most single-player games work perfectly in --offline mode. Running legendary launch <App Name> --offline --dry-run gives you a ready-to-paste command line you can add directly to Lutris, Steam (as a non-Steam game), or any other launcher.
Additional arguments placed after the Legendary flags are passed through directly to the game process.
Use --set-defaults to permanently save your preferred Wine binary, prefix, wrapper, or language settings. After saving, you can launch the game with just legendary launch <App Name>.
The --crossover flag is only useful on macOS with CodeWeavers CrossOver installed. On Linux, use --wine and --wine-prefix to configure Wine directly.

Build docs developers (and LLMs) love

Get started for freeTalk to us