Rare is a graphical interface for Legendary, a command line alternative to Epic Games launcher, based on PyQt5
Rare is a graphical interface designed to simplify game management for users of Legendary, an open-source alternative to the Epic Games Launcher. Built using PyQt5, Rare provides a user-friendly platform for gamers to access and manage their games without relying on command-line tools.
Key Features:
Multi-platform Support: Works seamlessly on both Windows and Linux.
Integration with Legendary: Offers a visual interface forLegendary's functionality.
Customizable UI: Users can tailor the interface to suit their preferences.
Offline Functionality: Once installed, the software operates without an internet connection.
Parental Controls: Includes features to restrict access based on age ratings.
Audience & Benefit:
Ideal for gamers seeking a simple and open-source alternative to the official Epic Games Launcher. Rare provides an intuitive interface that streamlines game management, supports customization, and ensures offline functionality while maintaining security through parental controls. It can be installed via winget, making it accessible to users familiar with package managers.
Rare's macOS binaries are currently not singed and because of that when you launch Rare, you will see an 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.
After installing Rare, if macOS complains that it is damaged, open a terminal and run the following command
Alternatively, you can install using pip/pipx or from source.
Latest development version
In the actions tab you can find packages for the latest commits.
Note: They might be unstable and likely broken.
Installation via pip (platform independent)
Execute pip install Rare for all users, or pip install Rare --user for the current user only.
Linux, macOS and FreeBSD: execute rare in your terminal.
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:
Depending on your operating system and the python distribution, the following paths might need to be in your
environment's PATH
OS
Path
Windows
\Scripts
Linux
/home//.local/bin
macOS
/Users//Library/Python/3.x/bin
Running from source (advanced)
Clone the repo: git clone https://github.com/RareDevs/Rare.
Change your working directory to the project folder: cd Rare.
Optional: keep Rare isolated from your local python installation.
Create a virtualenv to install Rare into using python -m venv venv
Active your virtualenv
Linux/MacOS: source ./venv/bin/activate
Windows: .\venv\scripts\activate.ps1
Optional: make sure all generated files are up to date.
Use pip install ruff PySide6-Essentials to install the packages required by the following scripts.
Use pip install . to install Rare and its runtime dependencies.
You can use pip install .[discordrpc] or pip install .[webview] instead to install optional dependencies for Discord Presence and Webview respectively.
Run the application with rare or python3 -m rare.
If you installed in a virtualenv, you need to activate it before running Rare.
Packaging is done in accordance to PEP-517. For that you need the build and
installer packages. After you ensure these are installed, Rare can be built and installed using
When reporting issues, it is helpful to also include the logs with your issue.
You can find the longs in the following locations depending on your operating system
OS
Path
Windows
C:\Users\\AppData\Local\Rare\Rare\cache\logs
Linux
/home//.cache/Rare/Rare/logs
macOS
/Users//Library/Caches/Rare/Rare/logs
In these folders you will find files named like below
Rare_23-12-19--11-14.log
These are the logs for the main Rare application. As such are importand when Rare itself is crashing.
These are the logs for each of the games you run through Rare. Rare uses a separate instance of itself
to launch games, and these are the logs of that instance.
If you don't have a GitHub account or you just want to chat, you also can contact us on Discord:
https://discord.gg/YvmABK9YSk
Common issues
If you are using multiple accounts, there is a chance that at some point you will not be able to log in into your account and see something like the following.
> Login failed. Decryption of EPIC launcher user information failed.
In that case navigate to one of the following directorories depending on your operating system and delete user.json
