Skip to main content

Open source alternative for Epic Games Launcher, using Legendary

Project description

Rare

A frontend for legendary, the open source Epic Games Launcher alternative

Rare is a graphical interface for Legendary, a command line alternative to Epic Games launcher, written in PySide6

Logo

Logo by @MultisampledNight available here, licensed under CC BY-SA 4.0

Discord Shield

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

Reporting issues

If you run into any issues, you can report them by creating an issue on GitHub: https://github.com/RareDevs/Rare/issues/new/choose

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\<username>\AppData\Local\Rare\Rare\cache\logs
Linux /home/<username>/.cache/Rare/Rare/logs
masOS /Users/<username>/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.

  • RareLauncher_f4e0c1dff48749fa9145c1585699e276_23-12-17--19-53.log

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

Installation

Windows

There is an .msi installer available in releases page.

There is also a semi-portable .zip archive in releases page that lets you run Rare without installing it.

Important: On recent version of Windows you should have MSVC 2015 installed, you can get it from here

Packages

  • Rare is available as a Winget package. You can install Rare with the following one-liner:

    winget install rare
    
  • Rare is available as a Chocolatey package. You can install Rare with the following one-liner:

    choco install rare
    

Linux

Flatpak

Rare is available as a flatpak. See rare.

Install it via:

flatpak install flathub io.github.dummerle.rare

Run it via:

flatpak run io.github.dummerle.rare

Alternatively, you can download the flatpak package from our repository

AppImage

Available in releases page.

Arch based

There are some AUR packages available:

  • rare - for stable releases
  • rare-git - for the latest development version

Debian based

Note:

  • pypresence is an optional package. You can install it from DUR or with pip.
  • Some icons might look strange on Debian based distributions. The official python3-qtawesome package is too old.

macOS

There is a .dmg file available in releases page.

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

sudo xattr -dr com.apple.quarantine /Applications/Rare.app

which will allow the application to run normally.

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 <python_installation_folder>\Scripts
Linux /home/<username>/.local/bin
masOS /Users/<username>/Library/Python/3.x/bin

Run from source

  1. Clone the repo: git clone https://github.com/RareDevs/Rare
  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 want to be able to use the automatic login and Discord pypresence, run
      pip install -r requirements-full.txt
      
    • If you are on Arch you can run
      sudo pacman --needed -S python-wheel python-setuptools python-setuptools-scm python-pyside6 python-qtawesome python-requests python-orjson
      
      yay -S legendary python-vdf
      
    • If you are on FreeBSD you have to install py39-qt5 from the packages
      sudo pkg install py39-qt5
      
  4. Run python3 -m rare

Contributing

There are several options to contribute.

  • If you know Python and PyQt, you can implement new features (Some ideas are in the projects tab).
  • You can translate the application in your language: Check our transifex page for that.

More information is available in CONTRIBUTING.md.

Screenshots

Game covers Vertical list
alt text alt text
Game details Game settings
alt text alt text
Downloads Application settings
alt text alt text

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

rare-1.11.3.0.tar.gz (5.2 MB view details)

Uploaded Source

Built Distribution

Rare-1.11.3.0-py3-none-any.whl (2.5 MB view details)

Uploaded Python 3

File details

Details for the file rare-1.11.3.0.tar.gz.

File metadata

  • Download URL: rare-1.11.3.0.tar.gz
  • Upload date:
  • Size: 5.2 MB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.0.1 CPython/3.12.8

File hashes

Hashes for rare-1.11.3.0.tar.gz
Algorithm Hash digest
SHA256 fee4d51d6fbd55570228bb568f473230b859cede6757c0446b064ffa8278c503
MD5 d29f8dba7e4b3d27af7996d912dd5279
BLAKE2b-256 4fd9a1c60b7f7f98b4c72879dd9ea593f6d42bc11d3221e949bf51113f0b6ab0

See more details on using hashes here.

File details

Details for the file Rare-1.11.3.0-py3-none-any.whl.

File metadata

  • Download URL: Rare-1.11.3.0-py3-none-any.whl
  • Upload date:
  • Size: 2.5 MB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.0.1 CPython/3.12.8

File hashes

Hashes for Rare-1.11.3.0-py3-none-any.whl
Algorithm Hash digest
SHA256 054b8749332c7f22a5456c5bca0f6044163d0aa9ba1cd70657863b12c7b61d93
MD5 fa552bba20bb4f5a5fd7bbffb19f6c8e
BLAKE2b-256 2eb6a088ee579a13aeb4e468a8dbe2eb0cf4d3affa85fb34f8b25543ef4ae394

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page