mirror of
https://github.com/derrod/legendary.git
synced 2024-12-22 17:55:27 +00:00
Update README
This commit is contained in:
parent
ecf6572e5f
commit
35db69997b
32
README.md
32
README.md
|
@ -1,25 +1,26 @@
|
||||||
# Legendary
|
# Legendary
|
||||||
## A free and open-source Epic Games Launcher replacement
|
## A free and open-source Epic Games Launcher alternative
|
||||||
![Logo](https://repository-images.githubusercontent.com/249938026/80b18f80-96c7-11ea-9183-0a8c96e7cada)
|
![Logo](https://repository-images.githubusercontent.com/249938026/80b18f80-96c7-11ea-9183-0a8c96e7cada)
|
||||||
|
|
||||||
[![Discord](https://discordapp.com/api/guilds/695233346627698689/widget.png?style=shield)](https://discord.gg/UJKBwPw) [![Twitter Follow](https://img.shields.io/twitter/follow/legendary_gl?label=Follow%20us%20for%20updates%21&style=social)](https://twitter.com/legendary_gl)
|
[![Discord](https://discordapp.com/api/guilds/695233346627698689/widget.png?style=shield)](https://discord.gg/UJKBwPw) [![Twitter Follow](https://img.shields.io/twitter/follow/legendary_gl?label=Follow%20us%20for%20updates%21&style=social)](https://twitter.com/legendary_gl)
|
||||||
|
|
||||||
Legendary is an open-source game launcher that can download and install games from the Epic Games Store on Linux and Windows.
|
Legendary is an open-source game launcher that can download and install games from the Epic Games platform on Linux and Windows.
|
||||||
It's name as a tongue-in-cheek play on tiers of [item rarity in many MMORPGs](https://wow.gamepedia.com/Quality).
|
It's name as a tongue-in-cheek play on tiers of [item rarity in many MMORPGs](https://wow.gamepedia.com/Quality).
|
||||||
|
|
||||||
Right now it is in an early public testing stage and still needs a lot of work to work. But it does work!
|
Right now Legendary is in beta and not feature-complete. You might run into some bugs or issues.
|
||||||
|
If you do please [create an issue on GitHub](https://github.com/derrod/legendary/issues/new) so we can fix it.
|
||||||
|
|
||||||
**What works:**
|
**What works:**
|
||||||
- Authenticating with Epic's service
|
- Authenticating with Epic's service
|
||||||
- Downloading and installing your games and their DLC
|
- Downloading and installing your games and their DLC
|
||||||
- Delta patching/updating of installed games
|
- Delta patching/updating of installed games
|
||||||
- Launching games with online authentication (for multiplayer)
|
- Launching games with online authentication (for multiplayer/DRM)
|
||||||
- Downloading existing cloud saves
|
- Syncing cloud saves (compatible with EGL)
|
||||||
- Running games with WINE on Linux
|
- Running games with WINE on Linux
|
||||||
|
|
||||||
**Planned:**
|
**Planned:**
|
||||||
- Simple GUI for managing/launching games
|
- Simple GUI for managing/launching games
|
||||||
- Importing installed games from the EGS launcher
|
- Importing/Exporting installed games from/to the Epic Games Launcher
|
||||||
- Better interfaces for other developers to use Legendary in their projects
|
- Better interfaces for other developers to use Legendary in their projects
|
||||||
- Lots and lots of bug fixes, optimizations, and refactoring...
|
- Lots and lots of bug fixes, optimizations, and refactoring...
|
||||||
|
|
||||||
|
@ -27,14 +28,13 @@ Right now it is in an early public testing stage and still needs a lot of work t
|
||||||
|
|
||||||
- Linux or Windows (64-bit)
|
- Linux or Windows (64-bit)
|
||||||
- python 3.8+ (64-bit on Windows)
|
- python 3.8+ (64-bit on Windows)
|
||||||
- requests
|
- PyPI packages: `requests`, optionally `setuptools` and `wheel` for setup/building
|
||||||
- setuptools (only when installing/building)
|
|
||||||
|
|
||||||
## How to run/install
|
## How to run/install
|
||||||
|
|
||||||
### Package Manager
|
### Package Manager
|
||||||
|
|
||||||
Some distros already have (unofficial) packages available, check out the [Available Linux Packages](https://github.com/derrod/legendary/wiki/Available-Linux-Packages) wiki page for details.
|
Several distros already have (unofficial) packages available, check out the [Available Linux Packages](https://github.com/derrod/legendary/wiki/Available-Linux-Packages) wiki page for details.
|
||||||
|
|
||||||
Currently this includes
|
Currently this includes
|
||||||
[Arch](https://github.com/derrod/legendary/wiki/Available-Linux-Packages#arch-aur),
|
[Arch](https://github.com/derrod/legendary/wiki/Available-Linux-Packages#arch-aur),
|
||||||
|
@ -43,7 +43,7 @@ Currently this includes
|
||||||
but more will be available in the future.
|
but more will be available in the future.
|
||||||
|
|
||||||
### Standalone
|
### Standalone
|
||||||
Download the latest `legendary` or `legendary.exe` binary from [the latest release](https://github.com/derrod/legendary/releases/latest)
|
Download the `legendary` or `legendary.exe` binary from [the latest release](https://github.com/derrod/legendary/releases/latest)
|
||||||
and move it to somewhere in your `$PATH`/`%PATH%`. Don't forget to `chmod +x` it on Linux.
|
and move it to somewhere in your `$PATH`/`%PATH%`. Don't forget to `chmod +x` it on Linux.
|
||||||
|
|
||||||
The Windows .exe and Linux executable were created with PyInstaller and will run standalone even without python being installed.
|
The Windows .exe and Linux executable were created with PyInstaller and will run standalone even without python being installed.
|
||||||
|
@ -51,14 +51,14 @@ Note that on Linux glibc >= 2.25 is required, so older distributions such as Ubu
|
||||||
|
|
||||||
### Python package
|
### Python package
|
||||||
|
|
||||||
The package is available on [PyPI](https://pypi.org/project/legendary-gl/), to install simply run:
|
Legendary is available on [PyPI](https://pypi.org/project/legendary-gl/), to install simply run:
|
||||||
```bash
|
```bash
|
||||||
pip install legendary-gl
|
pip install legendary-gl
|
||||||
```
|
```
|
||||||
|
|
||||||
Manually:
|
#### Manually from the repo
|
||||||
- Install python3.8, setuptools and requests
|
- Install python3.8, setuptools, wheel, and requests
|
||||||
- Clone the git repository
|
- Clone the git repository and cd into it
|
||||||
- Run `python3.8 setup.py install`
|
- Run `python3.8 setup.py install`
|
||||||
|
|
||||||
#### Ubuntu 20.04 example
|
#### Ubuntu 20.04 example
|
||||||
|
@ -86,6 +86,7 @@ To log in:
|
||||||
$ legendary auth
|
$ legendary auth
|
||||||
````
|
````
|
||||||
Authentication is a little finicky since we have to go through the Epic website. The login page should open in your browser and after logging in you should be presented with a JSON response that contains a code, just copy and paste the code into your terminal to log in.
|
Authentication is a little finicky since we have to go through the Epic website. The login page should open in your browser and after logging in you should be presented with a JSON response that contains a code, just copy and paste the code into your terminal to log in.
|
||||||
|
On Windows you can use the `--import` flag to import the authentication from the Epic Games Launcher. Note that this will log you out of the Epic Launcher.
|
||||||
|
|
||||||
Listing your games
|
Listing your games
|
||||||
````
|
````
|
||||||
|
@ -319,11 +320,10 @@ offline = true
|
||||||
skip_update_check = true
|
skip_update_check = true
|
||||||
; start parameters to use (in addition to the required ones)
|
; start parameters to use (in addition to the required ones)
|
||||||
start_params = -windowed
|
start_params = -windowed
|
||||||
wine_executable = proton
|
wine_executable = /path/to/proton/wine64
|
||||||
|
|
||||||
[AppName.env]
|
[AppName.env]
|
||||||
; environment variables to set for this game (mostly useful on linux)
|
; environment variables to set for this game (mostly useful on linux)
|
||||||
WINEPREFIX = /mnt/tank/games/Game/.wine
|
WINEPREFIX = /mnt/tank/games/Game/.wine
|
||||||
DXVK_CONFIG_FILE = /mnt/tank/games/Game/dxvk.conf
|
DXVK_CONFIG_FILE = /mnt/tank/games/Game/dxvk.conf
|
||||||
````
|
````
|
||||||
|
|
||||||
|
|
Loading…
Reference in a new issue