免费和开源的Epic Games Launcher替代产品，可从Linux和Windows上的Epic Games平台下载并安装游戏

Legendary是一款开源游戏启动器，可以从Linux和Windows上的Epic Games平台下载并安装游戏。它的名称是许多MMORPG中稀有物品等级上的嘲讽之词。

目前，Legendary尚处于测试阶段，功能尚不完善。您可能会遇到一些错误或问题。如果您这样做，请在GitHub上创建一个问题，以便我们进行修复。

注意： Legendary当前是一个没有图形用户界面的CLI（命令行界面）应用程序，必须从终端（例如PowerShell）运行

什么有效：

• 使用Epic的服务进行身份验证
• 下载并安装游戏及其DLC
• 已安装游戏的Delta补丁/更新
• 通过在线身份验证启动游戏（适用于多人游戏/ DRM）
• 同步云保存（与EGL兼容）
• 在Linux上使用WINE运行游戏
• 从Epic Games Launcher导入/导出已安装的游戏

计划：

• 简单的GUI，用于管理/启动游戏
• 更好的界面，供其他开发人员在其项目中使用Legendary
• 大量的错误修复，优化和重构…

要求

• Linux或Windows（64位）
• python 3.8+（在Windows上为64位）
• PyPI软件包：requests，可选setuptools，wheel用于设置/构建

如何运行/安装

包装经理

一些发行版已经有可用的软件包，请查看Available Linux Packages Wiki页面以获取详细信息。

当前，这包括 Arch， Fedora， openSUSE和 Gentoo， 但是将来会有更多可用。

请注意，由于软件包是由第三方维护的，因此将它们更新到最新版本可能需要一些时间。如果您始终希望拥有最新的功能和修补程序，则建议使用PyPI发行版。

单机版

从最新版本下载legendary或legendary.exe二进制文件， 然后将其移至/中的某个位置。在Linux上不要忘记它。$PATH%PATH%chmod +x

Windows .exe和Linux可执行文件是使用PyInstaller创建的，即使没有安装python也可以独立运行。请注意，在Linux上，需要glibc> = 2.25，因此较旧的发行版（如Ubuntu 16.04或Debian Stretch）将无法工作。

Python包

先决条件

为防止安装过程中出现权限问题，请pip通过运行升级您的python -m pip install -U pip --user。

提示：在Linux或Windows上，您可能需要用python上述命令替换。python3.8py -3.8

从PyPI安装（推荐）

Legendary在PyPI上可用，只需运行即可安装：

pip install legendary-gl

从仓库手动

• 安装python3.8，setuptools，wheel和request
• 克隆git存储库并cd到其中
• 跑 pip install .

Ubuntu 20.04示例

Ubuntu 20.04的标准存储库包括安装传奇版本所需的一切：

sudo apt install python3 python3-requests python3-setuptools-git
git clone https://github.com/derrod/legendary.git
cd legendary
pip install .

如果legendary安装后可执行文件不可用，则可能需要PATH正确配置。您可以通过运行以下命令来执行此操作：

echo 'export PATH=$PATH:~/.local/bin' >> ~/.profile && source ~/.profile

直接从仓库（用于开发/测试）

• 安装python3.8和请求（可选地在venv中）
• cd进入仓库
• 输入pip install -e .

这legendary将以“可编辑”模式安装-对源代码的任何更改将在legendary可执行文件下次运行时生效。

快速开始

提示：将PowerShell与独立可执行文件一起使用时，可能需要在以下命令中替换legendary为.\legendary。

登录：

legendary auth

身份验证有点挑剔，因为我们必须通过Epic网站。登录页面应在浏览器中打开，登录后将显示一个包含代码的JSON响应，只需将代码复制并粘贴到终端中即可登录。在Windows上，您可以使用该--import标志从以下位置导入身份验证史诗游戏启动器。请注意，这将使您退出Epic Launcher。

列出您的游戏

legendary list-games

这将获取您帐户中可用游戏的列表，第一次可能需要一段时间，具体取决于您拥有的游戏数量。

安装游戏

legendary install Anemone

重要提示：这些命令使用的名称是应用程序名称，而不是游戏名称！应用程序名称在游戏列表中游戏名称后面的括号中。

列出已安装的游戏并检查更新

legendary list-installed --check-updates

使用在线身份验证启动（运行）游戏

legendary launch Anemone

提示：大多数游戏都可以在离线（--offline）上正常运行，因此不需要通过传奇启动就可以进行在线身份验证。您可以运行legendary launch <App Name> --offline --dry-run以获取命令行，该命令行将使用Epic Launcher使用的所有参数启动游戏。然后，如果游戏需要它们，则可以将它们输入任何其他游戏启动器（例如Lutris / Steam）。

导入以前安装的游戏

legendary import-game Anemone /mnt/games/Epic/WorldOfGoo

注意：导入将需要完整的验证，因此Legendary可以在以后正确更新游戏。

与Epic Cloud同步保存游戏

legendary sync-saves

注意：在安装了受支持的游戏之后，第一次运行此命令时，它将要求您确认或提供保存游戏所在的路径。

使用Epic Games Launcher自动同步所有游戏

legendary -y egl-sync

用法

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,cleanup}
                 ...

Legendary v0.X.X - "Codename"

optional arguments:
  -h, --help            show this help message and exit
  -v, --debug           Set loglevel to debug
  -y, --yes             Default to yes for all prompts
  -V, --version         Print version and exit

Commands:
  {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}
    auth                Authenticate with EPIC
    install (download,update,repair)
                        Download a game
    uninstall           Uninstall (delete) a game
    launch              Launch a game
    list-games          List available (installable) games
    list-installed      List installed games
    list-files          List files in manifest
    list-saves          List available cloud saves
    download-saves      Download all cloud saves
    sync-saves          Sync cloud saves
    verify-game         Verify a game's local files
    import-game         Import an already installed game
    egl-sync            Setup or run Epic Games Launcher sync
    status              Show legendary status information
    cleanup             Remove old temporary, metadata, and manifest files

Individual command help:

Command: auth
usage: legendary auth [-h] [--import] [--code <exchange code>]
                      [--sid <session id>] [--delete]

optional arguments:
  -h, --help            show this help message and exit
  --import              Import Epic Games Launcher authentication data (logs
                        out of EGL)
  --code <exchange code>
                        Use specified exchange code instead of interactive
                        authentication
  --sid <session id>    Use specified session id instead of interactive
                        authentication
  --delete              Remove existing authentication (log out)


Command: install
usage: legendary install <App Name> [options]

Aliases: download, update

positional arguments:
  <App Name>            Name of the app

optional arguments:
  -h, --help            show this help message and exit
  --base-path <path>    Path for game installations (defaults to ~/legendary)
  --game-folder <path>  Folder for game installation (defaults to folder
                        specified in metadata)
  --max-shared-memory <size>
                        Maximum amount of shared memory to use (in MiB),
                        default: 1 GiB
  --max-workers <num>   Maximum amount of download workers, default: min(2 *
                        CPUs, 16)
  --manifest <uri>      Manifest URL or path to use instead of the CDN one
                        (e.g. for downgrading)
  --old-manifest <uri>  Manifest URL or path to use as the old one (e.g. for
                        testing patching)
  --delta-manifest <uri>
                        Manifest URL or path to use as the delta one (e.g. for
                        testing)
  --base-url <url>      Base URL to download from (e.g. to test or switch to a
                        different CDNs)
  --force               Download all files / ignore existing (overwrite)
  --disable-patching    Do not attempt to patch existing installation
                        (download entire changed files)
  --download-only, --no-install
                        Do not intall app and do not run prerequisite
                        installers after download
  --update-only         Only update, do not do anything if specified app is
                        not installed
  --dlm-debug           Set download manager and worker processes' loglevel to
                        debug
  --platform <Platform>
                        Platform override for download (also sets --no-
                        install)
  --prefix <prefix>     Only fetch files whose path starts with <prefix> (case
                        insensitive)
  --exclude <prefix>    Exclude files starting with <prefix> (case
                        insensitive)
  --install-tag <tag>   Only download files with the specified install tag
  --enable-reordering   Enable reordering optimization to reduce RAM
                        requirements during download (may have adverse results
                        for some titles)
  --dl-timeout <sec>    Connection timeout for downloader (default: 10
                        seconds)
  --save-path <path>    Set save game path to be used for sync-saves
  --repair              Repair installed game by checking and redownloading
                        corrupted/missing files
  --repair-and-update   Update game to the latest version when repairing
  --ignore-free-space   Do not abort if not enough free space is available
  --disable-delta-manifests
                        Do not use delta manifests when updating (may increase
                        download size)
  --reset-sdl           Reset selective downloading choices (requires repair
                        to download new components)


Command: uninstall
usage: legendary uninstall [-h] [--keep-files] <App Name>

positional arguments:
  <App Name>    Name of the app

optional arguments:
  -h, --help    show this help message and exit
  --keep-files  Keep files but remove game from Legendary database


Command: launch
usage: legendary launch <App Name> [options]

Note: additional arguments are passed to the game

positional arguments:
  <App Name>            Name of the app

optional arguments:
  -h, --help            show this help message and exit
  --offline             Skip login and launch game without online
                        authentication
  --skip-version-check  Skip version check when launching game in online mode
  --override-username <username>
                        Override username used when launching the game (only
                        works with some titles)
  --dry-run             Print the command line that would have been used to
                        launch the game and exit
  --language <two letter language code>
                        Override language for game launch (defaults to system
                        locale)
  --wrapper <wrapper command>
                        Wrapper command to launch game with
  --set-defaults        Save parameters used to launch to config (does not
                        include env vars)
  --reset-defaults      Reset config settings for app and exit
  --wine <wine binary>  Set WINE binary to use to launch the app
  --wine-prefix <wine pfx path>
                        Set WINE prefix to use
  --no-wine             Do not run game with WINE (e.g. if a wrapper is used)


Command: list-games
usage: legendary list-games [-h] [--platform <Platform>] [--include-ue] [--csv]
                            [--tsv] [--json]

optional arguments:
  -h, --help            show this help message and exit
  --platform <Platform>
                        Override platform that games are shown for (e.g.
                        Win32/Mac)
  --include-ue          Also include Unreal Engine content
                        (Engine/Marketplace) in list
  --csv                 List games in CSV format
  --tsv                 List games in TSV format
  --json                List games in JSON format


Command: list-installed
usage: legendary list-installed [-h] [--check-updates] [--csv] [--tsv] [--json]
                                [--show-dirs]

optional arguments:
  -h, --help       show this help message and exit
  --check-updates  Check for updates for installed games
  --csv            List games in CSV format
  --tsv            List games in TSV format
  --json           List games in JSON format
  --show-dirs      Print installation directory in output


Command: list-files
usage: legendary list-files [-h] [--force-download] [--platform <Platform>]
                            [--manifest <uri>] [--csv] [--tsv] [--json]
                            [--hashlist] [--install-tag <tag>]
                            [<App Name>]

positional arguments:
  <App Name>            Name of the app (optional)

optional arguments:
  -h, --help            show this help message and exit
  --force-download      Always download instead of using on-disk manifest
  --platform <Platform>
                        Platform override for download (disables install)
  --manifest <uri>      Manifest URL or path to use instead of the CDN one
  --csv                 Output in CSV format
  --tsv                 Output in TSV format
  --json                Output in JSON format
  --hashlist            Output file hash list in hashcheck/sha1sum -c
                        compatible format
  --install-tag <tag>   Show only files with specified install tag


Command: list-saves
usage: legendary list-saves [-h] [<App Name>]

positional arguments:
  <App Name>  Name of the app (optional)

optional arguments:
  -h, --help  show this help message and exit


Command: download-saves
usage: legendary download-saves [-h] [<App Name>]

positional arguments:
  <App Name>  Name of the app (optional)

optional arguments:
  -h, --help  show this help message and exit


Command: sync-saves
usage: legendary sync-saves [-h] [--skip-upload] [--skip-download]
                            [--force-upload] [--force-download]
                            [--save-path <path>] [--disable-filters]
                            [<App Name>]

positional arguments:
  <App Name>          Name of the app (optional)

optional arguments:
  -h, --help          show this help message and exit
  --skip-upload       Only download new saves from cloud, don't upload
  --skip-download     Only upload new saves from cloud, don't download
  --force-upload      Force upload even if local saves are older
  --force-download    Force download even if local saves are newer
  --save-path <path>  Override savegame path (requires single app name to be
                      specified)
  --disable-filters   Disable save game file filtering


Command: verify-game
usage: legendary verify-game [-h] <App Name>

positional arguments:
  <App Name>  Name of the app

optional arguments:
  -h, --help  show this help message and exit


Command: import-game
usage: legendary import-game [-h] [--disable-check]
                             <App Name> <Installation directory>

positional arguments:
  <App Name>            Name of the app
  <Installation directory>
                        Path where the game is installed

optional arguments:
  -h, --help            show this help message and exit
  --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)


Command: egl-sync
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]

optional arguments:
  -h, --help            show this help message and exit
  --egl-manifest-path EGL_MANIFEST_PATH
                        Path to the Epic Games Launcher's Manifests folder,
                        should point to
                        /ProgramData/Epic/EpicGamesLauncher/Data/Manifests
  --egl-wine-prefix EGL_WINE_PREFIX
                        Path to the WINE prefix the Epic Games Launcher is
                        installed in
  --enable-sync         Enable automatic EGL <-> Legendary sync
  --disable-sync        Disable automatic sync and exit
  --one-shot            Sync once, do not ask to setup automatic sync
  --import-only         Only import games from EGL (no export)
  --export-only         Only export games to EGL (no import)
  --unlink              Disable sync and remove EGL metadata from installed
                        games


Command: status
usage: legendary status [-h] [--offline] [--json]

optional arguments:
  -h, --help  show this help message and exit
  --offline   Only print offline status information, do not login
  --json      Show status in JSON format


Command: cleanup
usage: legendary cleanup [-h] [--keep-manifests]

optional arguments:
  -h, --help        show this help message and exit
  --keep-manifests  Do not delete old manifests

环境变量

Legendary支持通过环境变量覆盖某些事物，它还可以通过调用前设置的任何环境变量进行传递。

传奇的特定环境变量：

• LGDRY_WINE_BINARY -指定酒的二进制文件
• LGDRY_WINE_PREFIX -指定的酒名
• LGDRY_NO_WINE -禁用酒
• LGDRY_WRAPPER -指定包装程序二进制/命令行

请注意，多次出现的设置的优先级是：命令行>环境变量>配置变量。

配置文件

Legendary在以下方面支持某些选项以及游戏特定的配置~/.config/legendary/config.ini：

[Legendary]
log_level = debug
; maximum shared memory (in MiB) to use for installation
max_memory = 1024
; maximum number of worker processes when downloading (fewer workers will be slower, but also use fewer system resources)
max_workers = 8
; default install directory
install_dir = /mnt/tank/games
; locale override, must be in RFC 1766 format (e.g. "en-US")
locale = en-US
; whether or not syncing with egl is enabled
egl_sync = false
; path to the "Manifests" folder in the EGL ProgramData directory
egl_programdata = /home/user/Games/epic-games-store/drive_c/...

; default settings to use (currently limited to WINE executable)
[default]
; (linux) specify wine executable to use
wine_executable = wine
; wine prefix (alternative to using environment variable)
wine_prefix = /home/user/.wine

; default environment variables to set (overridden by game specific ones)
[default.env]
WINEPREFIX = /home/user/legendary/.wine

; Settings to only use for "AppName"
[AppName]
; launch game without online authentication by default
offline = true
; Skip checking for updates when launching this game
skip_update_check = true
; start parameters to use (in addition to the required ones)
start_params = -windowed
wine_executable = /path/to/proton/wine64
; override language with two-letter language code
language = fr

[AppName.env]
; environment variables to set for this game (mostly useful on linux)
WINEPREFIX = /mnt/tank/games/Game/.wine
DXVK_CONFIG_FILE = /mnt/tank/games/Game/dxvk.conf

[AppName2]
; Use a wrapper to run this script
; Note that the path might have to be quoted if it contains spaces
wrapper = "/path/to/Proton 5.0/proton" run
; Do not run this executable with WINE (e.g. when the wrapper handles that)
no_wine = true

下载地址：https://github.com/derrod/legendary