@@ -135,18 +135,20 @@ legendary -y egl-sync
135135## Usage
136136
137137````
138- usage: legendary [-h] [-v] [-y] [-V] {auth,install,download,update,repair,uninstall,launch,list-games,list-installed,list-files,list-saves,download-saves,sync-saves,verify-game,import-game,egl-sync,status} ...
138+ usage: legendary [-h] [-v] [-y] [-V]
139+ {auth,install,download,update,repair,uninstall,launch,list-games,list-installed,list-files,list-saves,download-saves,sync-saves,verify-game,import-game,egl-sync,status,cleanup}
140+ ...
139141
140142Legendary v0.X.X - "Codename"
141143
142144optional arguments:
143145 -h, --help show this help message and exit
144- -v Set loglevel to debug
146+ -v, --debug Set loglevel to debug
145147 -y, --yes Default to yes for all prompts
146- -V Print version and exit
148+ -V, --version Print version and exit
147149
148150Commands:
149- {auth,install,download,update,repair,uninstall,launch,list-games,list-installed,list-files,list-saves,download-saves,sync-saves,verify-game,import-game,egl-sync,status}
151+ {auth,install,download,update,repair,uninstall,launch,list-games,list-installed,list-files,list-saves,download-saves,sync-saves,verify-game,import-game,egl-sync,status,cleanup }
150152 auth Authenticate with EPIC
151153 install (download,update,repair)
152154 Download a game
@@ -162,18 +164,23 @@ Commands:
162164 import-game Import an already installed game
163165 egl-sync Setup or run Epic Games Launcher sync
164166 status Show legendary status information
167+ cleanup Remove old temporary, metadata, and manifest files
165168
166169Individual command help:
167170
168171Command: auth
169- usage: legendary auth [-h] [--import] [--code <exchange code>] [--sid <session id>] [--delete]
172+ usage: legendary auth [-h] [--import] [--code <exchange code>]
173+ [--sid <session id>] [--delete]
170174
171175optional arguments:
172176 -h, --help show this help message and exit
173- --import Import Epic Games Launcher authentication data (logs out of EGL)
177+ --import Import Epic Games Launcher authentication data (logs
178+ out of EGL)
174179 --code <exchange code>
175- Use specified exchange code instead of interactive authentication
176- --sid <session id> Use specified session id instead of interactive authentication
180+ Use specified exchange code instead of interactive
181+ authentication
182+ --sid <session id> Use specified session id instead of interactive
183+ authentication
177184 --delete Remove existing authentication (log out)
178185
179186
@@ -188,42 +195,64 @@ positional arguments:
188195optional arguments:
189196 -h, --help show this help message and exit
190197 --base-path <path> Path for game installations (defaults to ~/legendary)
191- --game-folder <path> Folder for game installation (defaults to folder specified in metadata)
198+ --game-folder <path> Folder for game installation (defaults to folder
199+ specified in metadata)
192200 --max-shared-memory <size>
193- Maximum amount of shared memory to use (in MiB), default: 1 GiB
194- --max-workers <num> Maximum amount of download workers, default: min(2 * CPUs, 16)
195- --manifest <uri> Manifest URL or path to use instead of the CDN one (e.g. for downgrading)
196- --old-manifest <uri> Manifest URL or path to use as the old one (e.g. for testing patching)
197- --base-url <url> Base URL to download from (e.g. to test or switch to a different CDNs)
201+ Maximum amount of shared memory to use (in MiB),
202+ default: 1 GiB
203+ --max-workers <num> Maximum amount of download workers, default: min(2 *
204+ CPUs, 16)
205+ --manifest <uri> Manifest URL or path to use instead of the CDN one
206+ (e.g. for downgrading)
207+ --old-manifest <uri> Manifest URL or path to use as the old one (e.g. for
208+ testing patching)
209+ --delta-manifest <uri>
210+ Manifest URL or path to use as the delta one (e.g. for
211+ testing)
212+ --base-url <url> Base URL to download from (e.g. to test or switch to a
213+ different CDNs)
198214 --force Download all files / ignore existing (overwrite)
199- --disable-patching Do not attempt to patch existing installation (download entire changed files)
215+ --disable-patching Do not attempt to patch existing installation
216+ (download entire changed files)
200217 --download-only, --no-install
201- Do not intall app and do not run prerequisite installers after download
202- --update-only Only update, do not do anything if specified app is not installed
203- --dlm-debug Set download manager and worker processes' loglevel to debug
218+ Do not intall app and do not run prerequisite
219+ installers after download
220+ --update-only Only update, do not do anything if specified app is
221+ not installed
222+ --dlm-debug Set download manager and worker processes' loglevel to
223+ debug
204224 --platform <Platform>
205- Platform override for download (also sets --no-install)
206- --prefix <prefix> Only fetch files whose path starts with <prefix> (case insensitive)
207- --exclude <prefix> Exclude files starting with <prefix> (case insensitive)
225+ Platform override for download (also sets --no-
226+ install)
227+ --prefix <prefix> Only fetch files whose path starts with <prefix> (case
228+ insensitive)
229+ --exclude <prefix> Exclude files starting with <prefix> (case
230+ insensitive)
208231 --install-tag <tag> Only download files with the specified install tag
209- --enable-reordering Enable reordering optimization to reduce RAM requirements during download (may have adverse results for some titles)
210- --dl-timeout <sec> Connection timeout for downloader (default: 10 seconds)
232+ --enable-reordering Enable reordering optimization to reduce RAM
233+ requirements during download (may have adverse results
234+ for some titles)
235+ --dl-timeout <sec> Connection timeout for downloader (default: 10
236+ seconds)
211237 --save-path <path> Set save game path to be used for sync-saves
212- --repair Repair installed game by checking and redownloading corrupted/missing files
238+ --repair Repair installed game by checking and redownloading
239+ corrupted/missing files
213240 --repair-and-update Update game to the latest version when repairing
214241 --ignore-free-space Do not abort if not enough free space is available
215242 --disable-delta-manifests
216- Do not use delta manfiests when updating (may increase download size)
243+ Do not use delta manfiests when updating (may increase
244+ download size)
217245
218246
219247Command: uninstall
220- usage: legendary uninstall [-h] <App Name>
248+ usage: legendary uninstall [-h] [--keep-files] <App Name>
221249
222250positional arguments:
223- <App Name> Name of the app
251+ <App Name> Name of the app
224252
225253optional arguments:
226- -h, --help show this help message and exit
254+ -h, --help show this help message and exit
255+ --keep-files Keep files but remove game from Legendary database
227256
228257
229258Command: launch
@@ -236,16 +265,21 @@ positional arguments:
236265
237266optional arguments:
238267 -h, --help show this help message and exit
239- --offline Skip login and launch game without online authentication
268+ --offline Skip login and launch game without online
269+ authentication
240270 --skip-version-check Skip version check when launching game in online mode
241271 --override-username <username>
242- Override username used when launching the game (only works with some titles)
243- --dry-run Print the command line that would have been used to launch the game and exit
272+ Override username used when launching the game (only
273+ works with some titles)
274+ --dry-run Print the command line that would have been used to
275+ launch the game and exit
244276 --language <two letter language code>
245- Override language for game launch (defaults to system locale)
277+ Override language for game launch (defaults to system
278+ locale)
246279 --wrapper <wrapper command>
247280 Wrapper command to launch game with
248- --set-defaults Save parameters used to launch to config (does not include env vars)
281+ --set-defaults Save parameters used to launch to config (does not
282+ include env vars)
249283 --reset-defaults Reset config settings for app and exit
250284 --wine <wine binary> Set WINE binary to use to launch the app
251285 --wine-prefix <wine pfx path>
@@ -254,20 +288,24 @@ optional arguments:
254288
255289
256290Command: list-games
257- usage: legendary list-games [-h] [--platform <Platform>] [--include-ue] [--csv] [--tsv] [--json]
291+ usage: legendary list-games [-h] [--platform <Platform>] [--include-ue] [--csv]
292+ [--tsv] [--json]
258293
259294optional arguments:
260295 -h, --help show this help message and exit
261296 --platform <Platform>
262- Override platform that games are shown for (e.g. Win32/Mac)
263- --include-ue Also include Unreal Engine content (Engine/Marketplace) in list
297+ Override platform that games are shown for (e.g.
298+ Win32/Mac)
299+ --include-ue Also include Unreal Engine content
300+ (Engine/Marketplace) in list
264301 --csv List games in CSV format
265302 --tsv List games in TSV format
266303 --json List games in JSON format
267304
268305
269306Command: list-installed
270- usage: legendary list-installed [-h] [--check-updates] [--csv] [--tsv] [--json] [--show-dirs]
307+ usage: legendary list-installed [-h] [--check-updates] [--csv] [--tsv] [--json]
308+ [--show-dirs]
271309
272310optional arguments:
273311 -h, --help show this help message and exit
@@ -279,7 +317,10 @@ optional arguments:
279317
280318
281319Command: list-files
282- usage: legendary list-files [-h] [--force-download] [--platform <Platform>] [--manifest <uri>] [--csv] [--tsv] [--json] [--hashlist] [--install-tag <tag>] [<App Name>]
320+ usage: legendary list-files [-h] [--force-download] [--platform <Platform>]
321+ [--manifest <uri>] [--csv] [--tsv] [--json]
322+ [--hashlist] [--install-tag <tag>]
323+ [<App Name>]
283324
284325positional arguments:
285326 <App Name> Name of the app (optional)
@@ -293,7 +334,8 @@ optional arguments:
293334 --csv Output in CSV format
294335 --tsv Output in TSV format
295336 --json Output in JSON format
296- --hashlist Output file hash list in hashcheck/sha1sum -c compatible format
337+ --hashlist Output file hash list in hashcheck/sha1sum -c
338+ compatible format
297339 --install-tag <tag> Show only files with specified install tag
298340
299341
@@ -318,7 +360,10 @@ optional arguments:
318360
319361
320362Command: sync-saves
321- usage: legendary sync-saves [-h] [--skip-upload] [--skip-download] [--force-upload] [--force-download] [--save-path <path>] [--disable-filters] [<App Name>]
363+ usage: legendary sync-saves [-h] [--skip-upload] [--skip-download]
364+ [--force-upload] [--force-download]
365+ [--save-path <path>] [--disable-filters]
366+ [<App Name>]
322367
323368positional arguments:
324369 <App Name> Name of the app (optional)
@@ -329,7 +374,8 @@ optional arguments:
329374 --skip-download Only upload new saves from cloud, don't download
330375 --force-upload Force upload even if local saves are older
331376 --force-download Force download even if local saves are newer
332- --save-path <path> Override savegame path (requires single app name to be specified)
377+ --save-path <path> Override savegame path (requires single app name to be
378+ specified)
333379 --disable-filters Disable save game file filtering
334380
335381
@@ -344,7 +390,8 @@ optional arguments:
344390
345391
346392Command: import-game
347- usage: legendary import-game [-h] [--disable-check] <App Name> <Installation directory>
393+ usage: legendary import-game [-h] [--disable-check]
394+ <App Name> <Installation directory>
348395
349396positional arguments:
350397 <App Name> Name of the app
@@ -353,24 +400,33 @@ positional arguments:
353400
354401optional arguments:
355402 -h, --help show this help message and exit
356- --disable-check Disables completeness check of the to-be-imported game installation (useful if the imported game is a much older version or missing files)
403+ --disable-check Disables completeness check of the to-be-imported game
404+ installation (useful if the imported game is a much
405+ older version or missing files)
357406
358407
359408Command: egl-sync
360- usage: legendary egl-sync [-h] [--egl-manifest-path EGL_MANIFEST_PATH] [--egl-wine-prefix EGL_WINE_PREFIX] [--enable-sync] [--disable-sync] [--one-shot] [--import-only] [--export-only] [--unlink]
409+ usage: legendary egl-sync [-h] [--egl-manifest-path EGL_MANIFEST_PATH]
410+ [--egl-wine-prefix EGL_WINE_PREFIX] [--enable-sync]
411+ [--disable-sync] [--one-shot] [--import-only]
412+ [--export-only] [--unlink]
361413
362414optional arguments:
363415 -h, --help show this help message and exit
364416 --egl-manifest-path EGL_MANIFEST_PATH
365- Path to the Epic Games Launcher's Manifests folder, should point to /ProgramData/Epic/EpicGamesLauncher/Data/Manifests
417+ Path to the Epic Games Launcher's Manifests folder,
418+ should point to
419+ /ProgramData/Epic/EpicGamesLauncher/Data/Manifests
366420 --egl-wine-prefix EGL_WINE_PREFIX
367- Path to the WINE prefix the Epic Games Launcher is installed in
421+ Path to the WINE prefix the Epic Games Launcher is
422+ installed in
368423 --enable-sync Enable automatic EGL <-> Legendary sync
369424 --disable-sync Disable automatic sync and exit
370425 --one-shot Sync once, do not ask to setup automatic sync
371426 --import-only Only import games from EGL (no export)
372427 --export-only Only export games to EGL (no import)
373- --unlink Disable sync and remove EGL metadata from installed games
428+ --unlink Disable sync and remove EGL metadata from installed
429+ games
374430
375431
376432Command: status
@@ -380,6 +436,14 @@ optional arguments:
380436 -h, --help show this help message and exit
381437 --offline Only print offline status information, do not login
382438 --json Show status in JSON format
439+
440+
441+ Command: cleanup
442+ usage: legendary cleanup [-h] [--keep-manifests]
443+
444+ optional arguments:
445+ -h, --help show this help message and exit
446+ --keep-manifests Do not delete old manifests
383447````
384448
385449
0 commit comments