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
2022-05-01 00:57:19 +12:00
## Why Rare?
- Runs natively, and supports most of the major platforms
- Gets out of your way when you don't need it, allowing you to enjoy your games
- Tries to be as lightweight as we can make it while still offering a feature-full experience
- Integrates seamlessly with legendary as both projects are developed in Python
- Packages, packages everywhere
## Issues
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
## Installation
2022-10-20 00:19:57 +13:00
### Linux
2022-02-28 10:30:08 +13:00
2022-10-20 00:19:57 +13:00
#### Flatpak
2022-02-28 10:30:08 +13:00
2022-10-20 00:19:57 +13:00
Rare is available as a flatpak. See [rare ](https://flathub.org/apps/details/io.github.dummerle.rare ).
2022-02-28 10:30:08 +13:00
2022-10-20 00:19:57 +13:00
Install it via:
2022-02-28 10:30:08 +13:00
2022-10-20 00:19:57 +13:00
`flatpak install flathub io.github.dummerle.rare`
2022-02-28 10:30:08 +13:00
2022-10-20 00:19:57 +13:00
Run it via:
2021-11-30 05:34:45 +13:00
2022-10-20 00:19:57 +13:00
`flatpak run io.github.dummerle.rare`
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**:
2022-01-28 06:39:18 +13:00
- pypresence is an optional package. You can install it
2022-02-28 10:30:08 +13:00
from [DUR ](https://mpr.hunterwittenborn.com/packages/python3-pypresence ) or with pip.
2022-01-06 03:57:13 +13:00
- Do not wonder if some icons look strange, because the official python3-qtawesome package is too old. Many icons were
2022-02-28 10:30:08 +13:00
replaced.
2021-12-23 06:55:06 +13:00
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-02-28 10:30:08 +13:00
**Note**: When you launch it, you will see an error, that the package is from an unknown source. You have to enable it
2022-01-06 03:57:13 +13:00
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
2022-10-20 00:19:57 +13:00
### Windows
2022-09-09 06:38:59 +12:00
2023-11-28 08:53:10 +13:00
- Rare is available as a [Winget package ](https://github.com/microsoft/winget-pkgs/tree/master/manifests/d/Dummerle/Rare )
2023-11-21 01:27:43 +13:00
You can install Rare with the following one-liner:
`winget install rare`
2022-12-21 10:29:27 +13:00
2023-11-21 01:27:43 +13:00
- Rare is available as a [Chocolatey package ](https://community.chocolatey.org/packages/rare ).
You can install Rare with the following one-liner:
2022-09-09 06:38:59 +12:00
2022-12-21 10:29:27 +13:00
`choco install rare`
2022-09-09 06:38:59 +12:00
2023-11-21 01:27:43 +13:00
- There is a small beta tool for Windows: [Rare Updater ](https://github.com/Dummerle/RareUpdater ), which installs and updates rare with a single click
*NOTE*: On recent Windows you should have MSVC 2015 installed, you can get it from [here ](https://learn.microsoft.com/en-US/cpp/windows/latest-supported-vc-redist?view=msvc-170#visual-studio-2015-2017-2019-and-2022 )
2021-09-02 08:12:27 +12:00
### Packages
2022-02-28 10:30:08 +13:00
In [releases page ](https://github.com/Dummerle/Rare/releases ), AppImages are available for Linux, a .msi file for windows and a .dmg
file for macOS.
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
2022-10-20 00:19:57 +13:00
### Installation via pip (platform independent)
Execute `pip install Rare` for all users, or `pip install Rare --user` for the current user only.
2023-07-16 19:03:59 +12:00
Linux, Mac and FreeBSD: execute `rare` in your terminal.
2022-10-20 00:19:57 +13:00
Windows: execute `pythonw -m rare` in cmd
It is possible to create a desktop link, or a start menu link. Execute the command above with `--desktop-shortcut`
or `--startmenu-shortcut` option, alternatively you can create them in the settings.
**Note about $PATH**:
On Linux:
`/home/user/.local/bin` must be in your PATH.
On Windows:
`PythonInstallationDirectory\Scripts` must be in your PATH.
On Mac:
`/Users/user/Library/Python/3.x/bin` must be in your PATH.
2021-09-02 08:12:27 +12:00
### Run from source
2021-11-30 05:34:45 +13:00
2022-09-05 08:55:37 +12:00
1. Clone the repo: `git clone https://github.com/Dummerle/Rare
2021-11-30 07:01:16 +13:00
2. Change your working directory to the project folder: `cd Rare`
2022-05-01 00:49:40 +12:00
3. Run `pip install -r requirements.txt` to install all required dependencies.
2023-08-06 05:31:16 +12:00
If you want to be able to use the automatic login and Discord pypresence, run `pip install -r requirements-full.txt`
2022-09-05 08:55:37 +12:00
If you are on Arch you can
2023-08-06 05:31:16 +12:00
run `sudo pacman --needed -S python-wheel python-setuptools python-pyqt5 python-qtawesome python-requests python-typing_extensions` and `yay -S legendary`
2023-07-16 19:03:59 +12:00
If you are on FreeBSD you have to install py39-qt5 from the packages: `sudo pkg install py39-qt5`
2022-09-05 08:55:37 +12:00
4. Run `python3 -m rare`
2021-04-08 05:03:12 +12: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
2022-02-28 10:30:08 +13:00
- If you know Python and PyQt, you can implement new features (Some ideas are in the projects tab).
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 )