LibreGaming

Python Program that downloads gaming required packages based on your Linux Distribution.

Table of contents

• Distributions
• Prerequisites
  • Dependencies
• Packages
  • Optional Packages
    • Other Packages
• Installation
• Usage
  • Protonup Commands
• VideoDemo
• Feedback
• Credits
• للعربية

للعربية

بسبب مشكلة إستخدام العربية في قيت_هوب قمت بعمل مقال يشرح كل تفاصيل البرنامج على مدونتي.

Distributions:

• I tested this script on these distributions. but it should also work on their derivatives too.

1. Ubuntu(Tested also on Linux Mint, Pop_OS!).
2. Arch Linux.
3. Fedora.
4. OpenSUSE Tumbleweed.

Prerequisites:

• You need your drivers installed beforehand for maximum performance under Linux. you can install them by going to this page

• To run this LibreGaming script you need python3 installed if not already. to install python3 click Here.

• Also you need to enable free and nonfree packages if you are using Fedora to install steam. You can find the commands to enable free and nonfree packages for Fedora here:

• For OpenSUSE Tumbleweed you need to enable packman repos to install Steam and other packages. You can find that here

• If you are using Arch Linux or an Arch based system you need to enable 32bit packages found in multilib repo you can enable it by going to this Arch wiki page.

Dependencies:

• git

1. Install git For Ubuntu:

sudo apt install git

2. Install git For Arch Linux:

sudo pacman -S git

3. Install git For Fedora:

sudo dnf install git

4. Install git For OpenSUSE Tumbleweed:

sudo zypper install git

• python3

1. Install Python3 For Ubuntu:

sudo apt install python3

3. Install Python3 For Arch Linux:

sudo pacman -S python

3. Install Python3 For Fedora:

sudo dnf install python3

4. Install Python3 For OpenSUSE Tumbleweed:

sudo zypper install python3

• python3-pip.

1. Install python3-pip For Ubuntu:

sudo apt install pipx

2. Install python3-pip For Arch Linux:

sudo pacman -S python-pipx

3. Install python3-pip For Fedora:

sudo dnf install pipx

4. Install python3-pip For OpenSUSE Tumbleweed:

sudo zypper install python-pipx

• Flatpak is needed for installing Athenaeum.

Packages:

• These Packages are installed using libregaming -b

1. Steam.
2. Wine-Staging.
3. Gamemode.

Optional_Packages

• These Packages + the ones above can be installed using libregaming -g

1. Lutris.
2. Heroic (Needs AUR enabled on Arch Linux)
3. mangohud and goverlay(Needs AUR enabled on Arch Linux).

Other_Packages

• These Packages have their own install option and they are not included in the above packages. They need to be installed seperatly, to know more click here

1. ProtonGE(You Must run Steam at least once before installing ProtonGE).
2. Athenaeum Launcher for FOSS games.
3. itch.io a Launcher for indie games.
4. Steam Tinker Launch(Only for Arch Linux).

Installation:

GUI

• To use the GUI interface you need to download the LibreGamingQt-x86_64.AppImage from the releases page and give it execute privileges and run it!

CLI

• You can install LibreGaming using pip if you have it installed. click Here to install pip3:

sudo pipx install LibreGaming

• Or you can install LibreGaming script by entering these commands:

git clone https://github.com/Ahmed-Al-Balochi/LibreGaming.git LibreGaming/ 
cd LibreGaming/
sudo python3 setup.py install --user

• To update LibreGaming when there is a new release enter this command:

sudo pipx install LibreGaming -U

• LibreGaming: command not found.

This error can be solved by setting up the PATH in your shell you can do this by creating an alias like so.

• Note that the LibreGaming Script is saved in /root/.local/bin directory by default.

alias libregaming="/root/.local/pipx/venvs/libregaming/bin/libregaming" 

Usage:

• Note: you can also run this script using libregaming command if you don't like LibreGaming. Both can be used, so choose what you prefer.
• To install all the Gaming packages mentioned in the packages section enter this command:

sudo libregaming -g

• To install Basic Packages(Wine, Steam, Gamemode):

sudo libregaming -b

• To install Lutris Launcher enter this command:

sudo libregaming --lutris 

• To install Heroic Launcher enter this command (Don't use sudo if you are using OpenSUSE):

sudo libregaming --heroic

• To install MangoHud & Goverlay enter this command:

sudo libregaming -o

• To install ProtonGE enter this command:

libregaming -p

• To install Athenaeum Launcher enter this command:

libregaming -ath

• To install itch.io Launcher enter this command:

libregaming --itch

• To install Minigalaxy Launcher enter this command:

libregaming --minigalaxy

• To install Steam Tinker Launch(For Arch Linux only) enter this command:

libregaming --stl

Protonup_Commands

• To list all the available releases of ProtonGE enter this command:

libregaming --release

• To list all the installed verions of ProtonGE enter this command:

libregaming -l

• To install a specfic release of ProtonGE enter this command: for example:

libregaming -t 6.13-GE-1

• To delete a specfic release of ProtonGE enter this command: for example:

libregaming -r 6.13-GE-1

VideoDemo:

• This a my video demonstrating LibreGaming in English. And click here for Arabic
• This is a video demonstrating LibreGaming made by TechHut: https://www.youtube.com/watch?v=2f2zdViFDYg
• This is a video demonstrating LibreGaming made by @BrodieRobertson: https://www.youtube.com/watch?v=sOch-qZMLq0&t=309s

Feedback:

• Tell me what distro to add if yours is not available. And what features you'd like to see.
• Also please report if there are any bugs in the script.
• Your feedback is always welcome.

Credits:

• Thanks to GloriousEggroll for ProtonGE.
• Thanks to AUNaseef protonup for making it easier to install ProtonGE.
• Thanks to flightlessmango for mangohud.
• Thanks to benjamimgois for goverlay.
• Thanks to anyone who downloads this script, and to everyone who gives me feedback.