2021-02-10 23:53:48 +13:00
|
|
|
# Rare
|
2021-11-30 07:01:16 +13:00
|
|
|
[![Discord Shield](https://discordapp.com/api/guilds/826881530310819914/widget.png?style=shield)](https://discord.gg/YvmABK9YSk)
|
2021-02-27 07:28:54 +13:00
|
|
|
|
2021-03-14 23:18:13 +13:00
|
|
|
## A frontend for legendary, the open source Epic Games Launcher alternative
|
2021-02-10 23:53:48 +13:00
|
|
|
|
2021-11-30 05:34:45 +13:00
|
|
|
Rare is a graphical interface for Legendary, a command line alternative to Epic Games launcher, based on PyQt5
|
2021-04-01 10:06:13 +13:00
|
|
|
|
2021-11-30 07:01:16 +13:00
|
|
|
<div align="center">
|
2021-11-30 07:09:20 +13:00
|
|
|
<img src="https://github.com/Dummerle/Rare/blob/main/rare/resources/images/Rare_nonsquared.png?raw=true" alt="Logo" width="200"/>
|
2021-11-30 07:01:16 +13:00
|
|
|
<p><i>Logo by <a href="https://github.com/MultisampledNight">@MultisampledNight</a> available
|
2021-11-30 07:09:20 +13:00
|
|
|
<a href="https://github.com/Dummerle/Rare/blob/main/rare/resources/images/">here</a>,
|
2021-11-30 07:01:16 +13:00
|
|
|
licensed under CC BY-SA 4.0</i></p>
|
|
|
|
</div>
|
2021-04-01 10:06:13 +13:00
|
|
|
|
2021-03-14 23:18:13 +13:00
|
|
|
## Installation
|
|
|
|
|
|
|
|
### Installation via pip (recommend)
|
|
|
|
|
2021-11-30 07:01:16 +13:00
|
|
|
Execute `pip install Rare` for all users, or `pip install Rare --user` for the current user only.
|
2021-03-14 23:18:13 +13:00
|
|
|
|
2021-11-30 05:34:45 +13:00
|
|
|
Linux and Mac: execute `rare` in your terminal.
|
2021-03-19 00:45:59 +13:00
|
|
|
|
2021-06-12 10:04:09 +12:00
|
|
|
Windows: execute `pythonw -m rare` in cmd
|
2021-03-14 23:18:13 +13:00
|
|
|
|
2021-08-29 06:03:25 +12:00
|
|
|
It is possible to create a desktop link, or a start menu link. Execute the command above with `--desktop-shortcut`
|
2021-11-30 07:01:16 +13:00
|
|
|
or `--startmenu-shortcut` option, alternatively you can create them in the settings.
|
2021-03-14 23:18:13 +13:00
|
|
|
|
2021-06-12 10:04:09 +12:00
|
|
|
**Note**: On Linux must be `/home/user/.local/bin` in PATH and on Windows must be `PythonInstallationDirectory\Scripts`
|
2021-11-30 07:01:16 +13:00
|
|
|
in PATH. On Mac is the Path `/Users/user/Library/Python/3.x/bin`.
|
2021-11-30 05:34:45 +13:00
|
|
|
|
2021-03-27 06:40:13 +13:00
|
|
|
### Linux
|
2021-03-14 23:18:13 +13:00
|
|
|
|
2021-04-08 05:03:12 +12:00
|
|
|
#### Arch based
|
|
|
|
|
|
|
|
There are some AUR packages available:
|
2021-05-21 23:40:10 +12:00
|
|
|
|
|
|
|
- [rare](https://aur.archlinux.org/packages/rare) - for stable releases
|
|
|
|
- [rare-git](https://aur.archlinux.org/packages/rare-git) - for the latest features, which are not in a stable release
|
2021-04-08 05:03:12 +12:00
|
|
|
|
2021-11-30 05:34:45 +13:00
|
|
|
#### Debian based
|
|
|
|
|
|
|
|
- DUR package: [rare](https://mpr.hunterwittenborn.com/packages/rare)
|
|
|
|
- .deb file in [releases page](https://github.com/Dummerle/Rare/releases)
|
|
|
|
|
2022-01-06 03:57:13 +13:00
|
|
|
**Note**:
|
|
|
|
|
|
|
|
- pypresene is an optional package. You can install it
|
|
|
|
from [DUR](https://mpr.hunterwittenborn.com/packages/python3-pypresence) or with pip
|
|
|
|
- Do not wonder if some icons look strange, because the official python3-qtawesome package is too old. Many icons were
|
|
|
|
replaced
|
2021-12-23 06:55:06 +13:00
|
|
|
|
2021-04-08 05:03:12 +12:00
|
|
|
#### Other
|
|
|
|
|
2021-11-30 07:01:16 +13:00
|
|
|
Install via `pip` or use the AppImage.
|
2021-11-30 05:34:45 +13:00
|
|
|
|
|
|
|
### macOS
|
|
|
|
|
|
|
|
There is a .dmg file available in [releases page](https://github.com/Dummerle/Rare/releases).
|
|
|
|
|
2022-01-06 03:57:13 +13:00
|
|
|
**Note**: When you launch it, you will see and error, that the package is from an unknown source. You have to enable it
|
|
|
|
manually in `Settings -> Security and Privacy`. Otherwise, Gatekeeper will block Rare from running.
|
2021-11-30 05:34:45 +13:00
|
|
|
|
2021-11-30 07:01:16 +13:00
|
|
|
You can also use `pip`.
|
2021-04-08 05:03:12 +12:00
|
|
|
|
2021-09-02 08:12:27 +12:00
|
|
|
### Packages
|
|
|
|
|
2021-11-30 07:01:16 +13:00
|
|
|
In [releases page](https://github.com/Dummerle/Rare/releases) are AppImages for Linux, a .msi file for windows and a .dmg
|
2021-11-30 05:34:45 +13:00
|
|
|
file for macOS available
|
2021-09-02 08:12:27 +12:00
|
|
|
|
2021-09-21 07:13:38 +12:00
|
|
|
### Latest packages
|
|
|
|
|
2021-11-30 07:01:16 +13:00
|
|
|
In the [actions](https://github.com/Dummerle/Rare/actions) tab you can find packages for the latest commits.
|
2021-09-21 07:13:38 +12:00
|
|
|
|
2021-11-30 07:01:16 +13:00
|
|
|
**Note**: They might be unstable.
|
2021-09-21 07:13:38 +12:00
|
|
|
|
2021-09-02 08:12:27 +12:00
|
|
|
### Run from source
|
2021-11-30 05:34:45 +13:00
|
|
|
|
|
|
|
1. Clone the repo with Submodule: `git clone https://github.com/Dummerle/Rare --recurse-submodules`.
|
2021-11-30 07:01:16 +13:00
|
|
|
2. Change your working directory to the project folder: `cd Rare`
|
|
|
|
3. Run `pip install -r requirements.txt` to install all required dependencies. If you are on Arch you can
|
2022-01-06 03:57:13 +13:00
|
|
|
run `sudo pacman --needed -S python-wheel python-setuptools python-pyqt5 python-qtawesome python-requests python-psutil`
|
2021-11-30 07:01:16 +13:00
|
|
|
3. Run `python3 -m rare`
|
2021-04-08 05:03:12 +12:00
|
|
|
|
|
|
|
## Why Rare?
|
|
|
|
|
2021-05-21 23:40:10 +12:00
|
|
|
- Rare only uses ~50MB of RAM which is much less than the electron
|
|
|
|
based [HeroicGamesLauncher](https://github.com/Heroic-Games-Launcher/HeroicGamesLauncher) uses.
|
2021-11-30 07:01:16 +13:00
|
|
|
- Rare supports most major platforms (Windows, Linux, Mac) unlike the alternatives.
|
2021-05-21 23:40:10 +12:00
|
|
|
|
2021-11-30 05:34:45 +13:00
|
|
|
## Issues
|
2021-05-21 23:40:10 +12:00
|
|
|
|
2021-11-30 07:01:16 +13:00
|
|
|
If you run into any issues, please report it by creating an issue on GitHub or on Discord: https://discord.gg/YvmABK9YSk
|
2021-03-14 23:18:13 +13:00
|
|
|
|
2021-04-01 10:06:13 +13:00
|
|
|
## Contributing
|
2021-05-21 23:40:10 +12:00
|
|
|
|
2021-11-30 07:01:16 +13:00
|
|
|
There are several options to contribute.
|
2021-05-21 23:40:10 +12:00
|
|
|
|
2021-04-08 21:34:36 +12:00
|
|
|
- If you can Python and PyQt you can implement new Features (Some ideas are in Projects).
|
2021-11-30 07:01:16 +13:00
|
|
|
- If you are a designer, you can add Stylesheets or create a logo or a banner.
|
2021-11-30 05:34:45 +13:00
|
|
|
- You can translate the application in your language: Check our [transifex](https://www.transifex.com/rare-1/rare) page
|
2021-11-30 07:01:16 +13:00
|
|
|
for that.
|
2021-04-01 10:06:13 +13:00
|
|
|
|
2021-11-30 07:01:16 +13:00
|
|
|
More information is available in CONTRIBUTING.md.
|
2021-04-01 10:06:13 +13:00
|
|
|
|
2021-03-14 23:18:13 +13:00
|
|
|
## Images
|
|
|
|
|
|
|
|
![alt text](https://github.com/Dummerle/Rare/blob/main/Screenshots/Rare.png?raw=true)
|
|
|
|
![alt text](https://github.com/Dummerle/Rare/blob/main/Screenshots/GameInfo.png?raw=true)
|
|
|
|
![alt text](https://github.com/Dummerle/Rare/blob/main/Screenshots/RareSettings.png?raw=true)
|
2021-04-23 00:25:47 +12:00
|
|
|
![alt text](https://github.com/Dummerle/Rare/blob/main/Screenshots/RareDownloads.png?raw=true)
|
2021-11-30 05:34:45 +13:00
|
|
|
![alt text](https://github.com/Dummerle/Rare/blob/main/Screenshots/GameSettings.png?raw=true)
|