<p align="center"> <img width="100px" src="data/img/icon.webp" align="center" alt="OpenLauncher" /> <h2 align="center">OpenLauncher</h2> <p align="center">An open-source Minecraft launcher for Windows and Linux.</p> </p> <p align="center"> <img alt="Python" src="https://img.shields.io/badge/Python-0078d4?style=flat&logo=python&logoColor=white" /> <img alt="Windows" src="https://img.shields.io/badge/Windows-0078d4?style=flat&logo=data:image/svg+xml;base64,PCFET0NUWVBFIHN2ZyBQVUJMSUMgIi0vL1czQy8vRFREIFNWRyAxLjEvL0VOIiAiaHR0cDovL3d3dy53My5vcmcvR3JhcGhpY3MvU1ZHLzEuMS9EVEQvc3ZnMTEuZHRkIj4KDTwhLS0gVXBsb2FkZWQgdG86IFNWRyBSZXBvLCB3d3cuc3ZncmVwby5jb20sIFRyYW5zZm9ybWVkIGJ5OiBTVkcgUmVwbyBNaXhlciBUb29scyAtLT4KPHN2ZyB3aWR0aD0iNjRweCIgaGVpZ2h0PSI2NHB4IiB2aWV3Qm94PSIwIDAgMjAgMjAiIHZlcnNpb249IjEuMSIgeG1sbnM9Imh0dHA6Ly93d3cudzMub3JnLzIwMDAvc3ZnIiB4bWxuczp4bGluaz0iaHR0cDovL3d3dy53My5vcmcvMTk5OS94bGluayIgZmlsbD0iIzAwMDAwMCI+Cg08ZyBpZD0iU1ZHUmVwb19iZ0NhcnJpZXIiIHN0cm9rZS13aWR0aD0iMCIvPgoNPGcgaWQ9IlNWR1JlcG9fdHJhY2VyQ2FycmllciIgc3Ryb2tlLWxpbmVjYXA9InJvdW5kIiBzdHJva2UtbGluZWpvaW49InJvdW5kIi8+Cg08ZyBpZD0iU1ZHUmVwb19pY29uQ2FycmllciI+IDx0aXRsZT53aW5kb3dzIFsjZmZmZmZmXTwvdGl0bGU+IDxkZXNjPkNyZWF0ZWQgd2l0aCBTa2V0Y2guPC9kZXNjPiA8ZGVmcz4gPC9kZWZzPiA8ZyBpZD0iUGFnZS0xIiBzdHJva2U9Im5vbmUiIHN0cm9rZS13aWR0aD0iMSIgZmlsbD0ibm9uZSIgZmlsbC1ydWxlPSJldmVub2RkIj4gPGcgaWQ9IkRyaWJiYmxlLUxpZ2h0LVByZXZpZXciIHRyYW5zZm9ybT0idHJhbnNsYXRlKC02MC4wMDAwMDAsIC03NDM5LjAwMDAwMCkiIGZpbGw9IiNmZmZmZmYiPiA8ZyBpZD0iaWNvbnMiIHRyYW5zZm9ybT0idHJhbnNsYXRlKDU2LjAwMDAwMCwgMTYwLjAwMDAwMCkiPiA8cGF0aCBkPSJNMTMuMTQ1ODY0Nyw3Mjg5LjQzNDI2IEMxMy4xNTA4NzcyLDcyOTEuNDMzMTYgMTMuMTU2ODkyMiw3Mjk0LjgyOTI5IDEzLjE2MTkwNDgsNzI5Ny40Njg4NCBDMTYuNzc1OTM5OCw3Mjk3Ljk1NzU3IDIwLjM4OTk3NDksNzI5OC40NjEzIDIzLjk5Nzk5NSw3Mjk5IEMyMy45OTc5OTUsNzI5NS44NDg3MyAyNC4wMDIwMDUsNzI5Mi43MTE0NiAyMy45OTc5OTUsNzI4OS43MTMxMSBDMjAuMzgwOTUyNCw3Mjg5LjcxMzExIDE2Ljc2NDkxMjMsNzI4OS40MzQyNiAxMy4xNDU4NjQ3LDcyODkuNDM0MjYgTTQsNzI4OS40MzUyNiBMNCw3Mjk2LjIyMTUzIEM2LjcyNTgxNDU0LDcyOTYuNTg5MzMgOS40NTE2MjkwNyw3Mjk2Ljk0MTEzIDEyLjE3MjQzMTEsNzI5Ny4zNDI5MSBDMTIuMTc3NDQzNiw3Mjk0LjcxNzM2IDEyLjE3MDQyNjEsNzI5Mi4wOTA4IDEyLjE3MDQyNjEsNzI4OS40NjUyNCBDOS40NDY2MTY1NCw3Mjg5LjQ3MDI0IDYuNzIzODA5NTIsNzI4OS40MjYyNyA0LDcyODkuNDM1MjYgTTQsNzI4MS44NDM0NCBMNCw3Mjg4LjYxMDcxIEM2LjcyNTgxNDU0LDcyODguNjE3NzEgOS40NTE2MjkwNyw3Mjg4LjU3NjczIDEyLjE3NzQ0MzYsNzI4OC41Nzk3MyBDMTIuMTc1NDM4Niw3Mjg1Ljk2MDE3IDEyLjE3NTQzODYsNzI4My4zNDM2MSAxMi4xNzI0MzExLDcyODAuNzI0MDUgQzkuNDQ0NjExNTMsNzI4MS4wNjQ4NiA2LjcxNjc5MTk4LDcyODEuNDI1NjcgNCw3MjgxLjg0MzQ0IE0yNCw3Mjg4LjQ3MTc5IEMyMC4zODc5Njk5LDcyODguNDg1NzggMTYuNzc1OTM5OCw3Mjg4LjU0MDc1IDEzLjE2MTkwNDgsNzI4OC41NTE3NSBDMTMuMTU5ODk5Nyw3Mjg1Ljg4OTIxIDEzLjE1OTg5OTcsNzI4My4yMjk2NyAxMy4xNjE5MDQ4LDcyODAuNTY5MTQgQzE2Ljc2ODkyMjMsNzI4MC4wMTg0NCAyMC4zODM5NTk5LDcyNzkuNTAwNzIgMjMuOTk3OTk1LDcyNzkgQzI0LDcyODIuMTU4MjYgMjMuOTk3OTk1LDcyODUuMzEzNTMgMjQsNzI4OC40NzE3OSIgaWQ9IndpbmRvd3MtWyNmZmZmZmZdIj4gPC9wYXRoPiA8L2c+IDwvZz4gPC9nPiA8L2c+Cg08L3N2Zz4=" /> <img alt="Linux" src="https://img.shields.io/badge/Linux-0078d4?style=flat&logo=linux&logoColor=white" /> <img alt="GitHub Stars" src="https://img.shields.io/github/stars/CesarGarza55/OpenLauncher?style=flat&logo=github&labelColor=0078d4&color=0078d4" /> </p> <br>

Note: Currently, OpenLauncher is designed only for Windows and Linux.

⚠️ Warning for Windows Users

Warning: On Windows, the launcher may be flagged as a false positive by antivirus software due to the absence of a valid certificate. Please be assured that this is a false alarm and the software is safe to use.

If you encounter issues downloading the installer, consider using the portable version as an alternative.

I have scanned the launcher with VirusTotal, and it was not detected by any antivirus engine. You can view the scan results below.

VirusTotal Scan

The installed executable of the launcher has also been scanned with VirusTotal and shows no issues.

VirusTotal Scan

⚠️ Warning for Linux Users

Warning: On Linux, you may need to install all the dependencies first. You can use the script dependencies.sh to install them, or run compile-linux.sh and select "Install dependencies only" to install them.

If you want to install the dependencies and download the compiled version from the releases, use this file. If you are going to compile it yourself, the process is included in compile-linux.sh.

🚀 Features

Microsoft Account Login: Supports logging in with an official Microsoft account.
Discord Rich Presence: Displays fun messages while you play.
Customizable Interface: Utilizes PyQt5 for a modern and customizable look.
Minecraft Compatibility: Manages Minecraft versions using the minecraft_launcher_lib library.
Open Source: Easily extendable and modifiable by the community.
Multiplatform: Available for Windows and Linux operating systems.
Multilanguage Support: Supports multiple languages for a better user experience.

📋 Requirements

Python 3.12 or higher
Java
pip (Python package manager)

🛠️ Installation

Windows

Clone the repository:

git clone https://github.com/CesarGarza55/OpenLauncher.git
cd OpenLauncher

Create a virtual environment (optional but recommended):
```
python -m venv venv
source venv/Scripts/activate
```
Compile:
1. Run the compile-windows.bat script to compile the project.
```
compile-windows.bat
```
1. Make installer (optional)
  1. Ensure NSIS is installed on your system. You can download NSIS from nsis.sourceforge.io.
  2. Open NSIS and click on "Compile NSI scripts":
  1. Click on "Load Script..." to load the script/compile.nsi script file.
  Alternatively, use the compile-compress.nsi script to reduce installer size by ~30 MB, though it will increase build time.
  1. Once the compilation is successful, open the output file OpenLauncher.exe to begin the installation.
You need to install Java to be able to play:

https://www.java.com/es/download/

Linux

Clone the repository:

git clone https://github.com/CesarGarza55/OpenLauncher.git
cd OpenLauncher

Compile:

Execute the script to start the compilation process:
```
./compile-linux.sh
```
Mark the file as an executable (For Generic Linux systems)

Executable

Or run:

chmod +x OpenLauncher.bin

Execute
1. For Generic Linux systems
```
./OpenLauncher.bin
```
1. For Debian based systems
```
openlauncher
```

📥 Download options

Windows Installer: .exe
Linux Installer (Debian/Ubuntu): .deb
Linux Generic (compiled): .bin

🕹️ Usage

When you open the application, a welcome window greets you. You can disable this feature using a checkbox.

The main interface shows different sections:

You can create, edit, and switch between multiple profiles. Each profile can be either a local profile or linked to a Microsoft account, and it stores its own configuration, including custom JVM arguments:

To install a version, use the following interface where you select the version and click install:

By default the following JVM arguments are used:

-Xmx2G -XX:+UnlockExperimentalVMOptions -XX:+UseG1GC -XX:G1NewSizePercent=20 -XX:G1ReservePercent=20 -XX:MaxGCPauseMillis=50 -XX:G1HeapRegionSize=32M

If you want to change something you need to do it from the settings window.

🔑 Sign in with Microsoft Account

To log in with your official Microsoft account, follow these steps:

Open the launcher.
Click on "Login with Microsoft"
Enter your Microsoft account with Minecraft purchased
Once the authentication process is complete, you will see your account appear in the launcher

Using your own Microsoft Entra Client ID

The official OpenLauncher builds use a hosted authentication API (a proxy) which is not published as open-source. If you fork this repository and want to use your own Microsoft App (Client ID) instead of a hosted API, a lightweight example flow is included at `data/no_api_mi

OpenLauncher

Install / Use

README