1
0
Fork 0
mirror of synced 2024-05-14 01:22:56 +12:00

Update README.md a bit and add logo license note

This commit is contained in:
multisn8 2021-11-29 19:01:16 +01:00 committed by GitHub
parent 709eb30674
commit b52ba2639a
No known key found for this signature in database
GPG key ID: 4AEE18F83AFDEB23

View file

@ -1,30 +1,34 @@
# Rare
[![Discord Shield](https://discordapp.com/api/guilds/826881530310819914/widget.png?style=shield)](https://discord.gg/YvmABK9YSk)
## 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, based on PyQt5
<img src="https://github.com/Dummerle/Rare/blob/main/rare/resources/images/Rare.png?raw=true" alt="Logo" width="200"/>
[![Discord Shield](https://discordapp.com/api/guilds/826881530310819914/widget.png?style=shield)](https://discord.gg/YvmABK9YSk)
<div align="center">
<img src="https://github.com/Dummerle/Rare/blob/main/rare/resources/images/Rare.png?raw=true" alt="Logo" width="200"/>
<p><i>Logo by <a href="https://github.com/MultisampledNight">@MultisampledNight</a> available
<a href="https://github.com/Dummerle/Rare/blob/main/rare/resources/images/Rare.svg">here</a>,
licensed under CC BY-SA 4.0</i></p>
</div>
## Installation
### Installation via pip (recommend)
Execute `pip install Rare` for all users Or `pip install Rare --user` for only one user.
Execute `pip install Rare` for all users, or `pip install Rare --user` for the current user only.
To install latest git version use `pip install --upgrade https://github.com/Dummerle/Rare/archive/refs/heads/main.zip`
To install latest git version use `pip install --upgrade https://github.com/Dummerle/Rare/archive/refs/heads/main.zip`.
Linux and Mac: 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
or `--startmenu-shortcut` option, alternatively you can create them in the settings.
**Note**: On Linux must be `/home/user/.local/bin` in PATH and on Windows must be `PythonInstallationDirectory\Scripts`
in PATH. On Mac is the Path `/Users/user/Library/Python/3.x/bin`
in PATH. On Mac is the Path `/Users/user/Library/Python/3.x/bin`.
### Linux
@ -42,54 +46,55 @@ There are some AUR packages available:
#### Other
Install via `pip` or use the AppImage
Install via `pip` or use the AppImage.
### macOS
There is a .dmg file available in [releases page](https://github.com/Dummerle/Rare/releases).
**Note**: You have to enable it manually in settings. Otherwise, Gatekeeper will block Rare
**Note**: You have to enable it manually in settings. Otherwise, Gatekeeper will block Rare from running.
You can also use `pip`
You can also use `pip`.
### Packages
In [releases page](https://github.com/Dummerle/Rare/releases) are AppImages for Linux, an msi file for windows and a dmg
In [releases page](https://github.com/Dummerle/Rare/releases) are AppImages for Linux, a .msi file for windows and a .dmg
file for macOS available
### Latest packages
In [actions](https://github.com/Dummerle/Rare/actions) you find packages for the latest commits.
In the [actions](https://github.com/Dummerle/Rare/actions) tab you can find packages for the latest commits.
**Note**: they might be unstable
**Note**: They might be unstable.
### Run from source
1. Clone the repo with Submodule: `git clone https://github.com/Dummerle/Rare --recurse-submodules`.
2. Run `pip install -r requirements.txt` to get dependencies. If you are on Arch you can
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
run `sudo pacman --needed -S python-wheel python-setuptools python-pyqt5 python-qtawesome python-requests python-pillow`
3. Run `python3 rare`
3. Run `python3 -m rare`
## Why Rare?
- Rare only uses ~50MB of RAM which is much less than the electron
based [HeroicGamesLauncher](https://github.com/Heroic-Games-Launcher/HeroicGamesLauncher) uses.
- Rare supports all major platforms (Windows, Linux, Mac) unlike the alternatives.
- Rare supports most major platforms (Windows, Linux, Mac) unlike the alternatives.
## Issues
If you run into an issue, please report it by creating an issue on GitHub or on Discord: https://discord.gg/YvmABK9YSk
If you run into any issues, please report it by creating an issue on GitHub or on Discord: https://discord.gg/YvmABK9YSk
## Contributing
There are more options to contribute.
There are several options to contribute.
- If you can Python and PyQt you can implement new Features (Some ideas are in Projects).
- If you are a designer, you can add Stylesheets or create a logo or a banner
- If you are a designer, you can add Stylesheets or create a logo or a banner.
- You can translate the application in your language: Check our [transifex](https://www.transifex.com/rare-1/rare) page
to translate Rare in your language
for that.
More Information is in CONTRIBUTING.md
More information is available in CONTRIBUTING.md.
## Images