Was macht Epic Games CLI (Legendary)?

Legendary ist ein kostenloser und quelloffener Befehlszeilen-Ersatz für den Epic Games Launcher. Verwenden Sie diese Fertigkeit, wenn der Benutzer seine Epic Games-Bibliothek über das Terminal verwalten möchte – Spiele installieren, starten, Cloud-Speicher synchronisieren oder die Epic-Sammlung durchsuchen.

Installation

Voraussetzungen:

Python 3.9+ (64-Bit)
pip-Paketmanager

Installation über PyPI (empfohlen):

pip install legendary-gl

Für Browser-Login-Unterstützung:

pip install legendary-gl[webview]

Alternative: Installation aus dem Quellcode

git clone https://github.com/derrod/legendary.git
cd legendary
pip install .

Ersteinrichtung

Authentifizierung

Authentifizieren Sie sich zunächst mit Ihrem Epic Games-Konto:

# Standardauthentifizierung (öffnet Browser für Login)
legendary auth

# Vorhandene Sitzung aus dem Epic Games Launcher importieren (meldet Sie vom EGL ab)
legendary auth --import

Die browserbasierte Authentifizierung:

Öffnet Ihren Standardbrowser für den Epic Games-Login
Fordert Sie auf, sich mit Ihren Epic-Anmeldedaten anzumelden
Zeigt einen Authentifizierungscode an
Speichert Ihre Sitzung automatisch, wenn Sie zum Terminal zurückkehren

Überprüfung

Überprüfen Sie, ob Sie angemeldet sind:

legendary whoami

Die Konfiguration wird in ~/.config/legendary/config.ini (Linux/macOS) oder %APPDATA%\legendary\config.ini (Windows) gespeichert.

Befehlsübersicht

Befehl	Beschreibung
`legendary auth`	Bei Epic Games authentifizieren
`legendary list`	Alle Spiele in Ihrer Bibliothek auflisten
`legendary list-installed`	Installierte Spiele auflisten und auf Updates prüfen
`legendary install <app>`	Ein Spiel installieren/herunterladen
`legendary launch <app>`	Ein Spiel starten/spielen
`legendary uninstall <app>`	Ein Spiel deinstallieren
`legendary sync-saves`	Cloud-Speicher synchronisieren
`legendary egl-sync`	Mit dem Epic Games Launcher synchronisieren

Häufige Anwendungsfälle

Spielebibliothek durchsuchen

# Alle Spiele in Ihrer Epic Games-Bibliothek auflisten
legendary list

# Mit detaillierten Informationen auflisten
legendary list --csv

# Metadaten zwangsweise aktualisieren (nützlich, wenn die Liste veraltet erscheint)
legendary list --force-refresh

# Nur Unreal Engine-Inhalte auflisten
legendary list --include-ue

Installierte Spiele verwalten

# Installierte Spiele auflisten
legendary list-installed

# Auf Updates für installierte Spiele prüfen
legendary list-installed --check-updates

# Ein bestimmtes Spiel aktualisieren
legendary update <app-name>

# Alle installierten Spiele aktualisieren
legendary update --skip-dlc

Spiele installieren

# Ein Spiel installieren (App-Namen aus dem listen-Befehl verwenden)
legendary install Anemone

# In ein benutzerdefiniertes Verzeichnis installieren
legendary install <app-name> --base-path /pfad/zu/spielen

# Mit einer bestimmten Plattform installieren
legendary install <app-name> --platform Windows

# Spiel mit DLC installieren
legendary install <app-name> --include-dlc

# Ohne selektiven Download installieren (alle Komponenten herunterladen)
legendary install <app-name> --disable-sdl

# Stille Installation (keine Rückfragen)
legendary install <app-name> -y

Spiele starten

# Ein Spiel starten
legendary launch "World of Goo"

# Im Offline-Modus starten
legendary launch <app-name> --offline

# Startbefehl anzeigen, ohne ihn auszuführen
legendary launch <app-name> --dry-run

# Mit benutzerdefinierten Parametern starten
legendary launch <app-name> --override- exe "pfad/zu/exe" --working-dir "pfad/zu/verz"

Cloud-Speicherverwaltung

# Alle Cloud-Speicher synchronisieren (hoch- und herunterladen)
legendary sync-saves

# Nur Speicher herunterladen (nicht hochladen)
legendary sync-saves --skip-upload

# Download erzwingen, auch wenn lokal aktueller
legendary sync-saves --force-download

# Alte Cloud-Speicher bereinigen
legendary clean-saves

Spielinformationen

# Detaillierte Informationen zu einem Spiel abrufen
legendary info <app-name>

# Dateien in einem Spielmanifest auflisten
legendary list-files <app-name>

# Verfügbare Cloud-Speicher für ein Spiel auflisten
legendary list-saves <app-name>

Vorhandene Spiele importieren

Wenn Sie Spiele über den Epic Games Launcher installiert haben:

# Ein Spiel aus dem Epic Games Launcher importieren
legendary import-game <app-name> "/pfad/zum/epic/installationsverz"

# Einmalige Synchronisierung mit dem Epic Games Launcher
legendary egl-sync --one-shot

# Kontinuierliche Synchronisierung mit dem EGL (nicht auf macOS verfügbar)
legendary egl-sync

Aliase für Komfort

Erstellen Sie Aliase in ~/.config/legendary/config.ini:

[Legendary.aliases]
; Alias = App-Name
HITMAN 3 = Eider
gtav = 9d2d0eb64d5c44529cece33fe2a46482

Verwenden Sie dann die Aliase in Befehlen:

legendary launch HITMAN 3
legendary install gtav

Befehlsreferenz

`legendary list [optionen]`

Option	Beschreibung
`--platform <p>`	Nach Plattform filtern (Windows/Mac)
`--include-ue`	Unreal Engine-Inhalte einschließen
`-T`	Terminal-Formatierung deaktivieren
`--csv`	Ausgabe im CSV-Format
`--tsv`	Ausgabe im TSV-Format
`--json`	Ausgabe im JSON-Format
`--force-refresh`	Alle Metadaten zwangsweise aktualisieren

`legendary install <app-name> [optionen]`

Option	Beschreibung
`--base-path <pfad>`	Benutzerdefiniertes Installationsverzeichnis
`--platform <p>`	Bestimmte Plattform
`--include-dlc`	DLC installieren
`--disable-sdl`	Selektiven Download deaktivieren
`--reset-sdl`	Auswahl des selektiven Downloads zurücksetzen
`--skip-dl`	Download überspringen, nur installieren
`-y`	Alle Rückfragen automatisch bestätigen
`--update`	Aktualisieren, falls bereits installiert

`legendary launch <app-name> [optionen]`

Option	Beschreibung
`--offline`	Im Offline-Modus starten
`--dry-run`	Befehl anzeigen, ohne ihn auszuführen
`--json`	Startinformationen als JSON ausgeben
`--override- exe <pfad>`	Benutzerdefinierte ausführbare Datei
`--working-dir <pfad>`	Benutzerdefiniertes Arbeitsverzeichnis

`legendary sync-saves [optionen]`

Option	Beschreibung
`--skip-upload`	Nur Speicher herunterladen
`--force-download`	Download erzwingen, lokale Dateien überschreiben
`--force-upload`	Upload erzwingen, entfernte Dateien überschreiben

Erweiterte Funktionen

Plattformübergreifendes Spielen

# Windows-Spiele unter Linux mit Proton/WINE ausführen
legendary install <app-name> --platform Windows
legendary launch <app-name> --wine

# Mit CrossOver (macOS) ausführen
legendary launch <app-name> --crossover-bottle <flaschenname>

Selektiver Download

Legendary unterstützt selektives Herunterladen, um Speicherplatz zu sparen:

# Mit aktiviertem selektiven Download installieren
legendary install <app-name>

# SDL-Auswahl zurücksetzen
legendary install <app-name> --reset-sdl

# SDL deaktivieren (alle Komponenten herunterladen)
legendary install <app-name> --disable-sdl

Konfiguration

Bearbeiten Sie ~/.config/legendary/config.ini:

[Legendary]
max_memory = 2048           ; Max. gemeinsam genutzter Speicher in MB
max_workers = 8             ; Max. Worker-Prozesse
install_dir = ~/Games       ; Standard-Installationsverzeichnis

Fehlerbehebung

Authentifizierungsprobleme

Falls die Authentifizierung fehlschlägt:

# Vorhandene Sitzung löschen
legendary auth --delete

# Erneut authentifizieren
legendary auth

Spiel startet nicht

Prüfen, ob das Spiel Online-Authentifizierung benötigt:
```
legendary launch <app-name>
```
Offline-Modus versuchen, falls DRM es zulässt:
```
legendary launch <app-name> --offline
```
--dry-run verwenden, um den Startbefehl anzuzeigen:
```
legendary launch <app-name> --dry-run
```

Langsame Downloads

Passen Sie die maximale Worker-Anzahl in der Konfiguration an:

[Legendary]
max_workers = 16
max_memory = 4096

Import aus dem Epic Games Launcher

Die macOS-Version des EGL unterstützt den Import nicht. Verwenden Sie:

# Unter Windows/Linux
legendary egl-sync

Ressourcen

Offizielles GitHub: https://github.com/derrod/legendary
Dokumentation: https://github.com/derrod/legendary#readme
PyPI-Paket: https://pypi.org/project/legendary-gl/
Lizenz: GPL-3.0

Einschränkungen

Kein Spielekauf (nur bereits besitzende Spiele können heruntergeladen werden)
Kostenlose Spiele können nicht beansprucht werden (Web-Store oder EGL erforderlich)
macOS-EGL-Synchronisierung wird nicht unterstützt (EGL-Einschränkung)
Erfordert Terminalnutzung (keine GUI)

Alternative Tools

Für eine grafische Oberfläche:

Heroic Games Launcher: https://heroicgameslauncher.com/ (GUI-Frontend für Legendary)
Lutris: https://lutris.net/ (Linux-Spieleverwaltung mit Legendary-Integration)

In Ihrer bevorzugten KI fragen

Dokumentation