Skip to content

Commit 3f3366c

Browse files
committed
Bump version to 0.20.2 and Update README
1 parent 3e6e173 commit 3f3366c

2 files changed

Lines changed: 113 additions & 49 deletions

File tree

README.md

Lines changed: 111 additions & 47 deletions
Original file line numberDiff line numberDiff line change
@@ -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
140142
Legendary v0.X.X - "Codename"
141143
142144
optional 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
148150
Commands:
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
166169
Individual command help:
167170
168171
Command: 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
171175
optional 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:
188195
optional 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
219247
Command: uninstall
220-
usage: legendary uninstall [-h] <App Name>
248+
usage: legendary uninstall [-h] [--keep-files] <App Name>
221249
222250
positional arguments:
223-
<App Name> Name of the app
251+
<App Name> Name of the app
224252
225253
optional 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
229258
Command: launch
@@ -236,16 +265,21 @@ positional arguments:
236265
237266
optional 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
256290
Command: 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
259294
optional 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
269306
Command: 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
272310
optional arguments:
273311
-h, --help show this help message and exit
@@ -279,7 +317,10 @@ optional arguments:
279317
280318
281319
Command: 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
284325
positional 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
320362
Command: 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
323368
positional 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
346392
Command: 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
349396
positional arguments:
350397
<App Name> Name of the app
@@ -353,24 +400,33 @@ positional arguments:
353400
354401
optional 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
359408
Command: 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
362414
optional 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
376432
Command: 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

legendary/__init__.py

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
11
"""Legendary!"""
22

3-
__version__ = '0.20.1'
4-
__codename__ = 'Endgame'
3+
__version__ = '0.20.2'
4+
__codename__ = 'Point Insertion'

0 commit comments

Comments
 (0)