This is a free/libre MC LCE Launcher written in python and Qt with Freedom and GNU/Linux support in mind.
  • Python 77.1%
  • HTML 12.9%
  • Shell 4.6%
  • Nix 3.4%
  • PowerShell 0.9%
  • Other 1.1%
Find a file
Repository files (latest commit first)
Filename Latest commit message Latest commit date
2026-06-24 14:50:56 -04:00
.github update site and fix error in skin and add git attributes 2026-06-11 12:57:44 -04:00
.vscode fix the windows build and remove useless print in __init__ 2026-05-30 01:31:09 -04:00
assets preparations do update 0.0.21.0a 2026-06-04 16:06:42 -04:00
data update news, noelegacy and add direct downlaod support 2026-06-24 11:40:26 -04:00
docs upgrade versions, docs and flatpak wip repo and try to fix nigthly build for app image 2026-06-02 00:05:36 -04:00
packages update the versions numbers to a alpha 2 and update dep to fix vulnerability and fix instance managers 2026-06-24 14:48:22 -04:00
schemas update news, noelegacy and add direct downlaod support 2026-06-24 11:40:26 -04:00
scripts update the wip flatpak repo packages, move the appstream on the root of the project, and remove it from packages and now the package and ntuitka packages no longer copy the whole assets and data folder since it is on qt ressoures and betters scripts and fix a error in echo in clean sript for windows and update deps 2026-06-02 12:35:17 -04:00
src update the versions numbers to a alpha 2 and update dep to fix vulnerability and fix instance managers 2026-06-24 14:48:22 -04:00
www update news, noelegacy and add direct downlaod support 2026-06-24 11:40:26 -04:00
.gitattributes update site and fix error in skin and add git attributes 2026-06-11 12:57:44 -04:00
.gitignore Refactor display manager and downloader with improved docstrings and error handling 2026-05-29 01:07:47 -04:00
CODE-DE-CONDUITE.md updated the code of conducts 2026-05-03 18:28:30 -04:00
code-of-conduct.md updated the code of conducts 2026-05-03 18:28:30 -04:00
default.nix update the versions numbers to a alpha 2 and update dep to fix vulnerability and fix instance managers 2026-06-24 14:48:22 -04:00
flake.nix remove old instanc,e better docs ,disabled automatc installer in nightly temporaliry due to some issue and fix revelations and disabled mclce until the launcher support remote git source 2026-05-24 14:17:05 -04:00
hatch_build.py Refactor instance UI and update version to 0.0.20b7 and worksflow fixes 2026-06-01 15:40:55 -04:00
io.github.xgui4.lce_qt_launcher.metainfo.xml readme update, nightly worflow 2026-06-04 23:28:19 -04:00
license.md April 16 updates 2026-04-16 23:31:21 -04:00
lisezmoi.md try to fix the workflow and add badges to readme 2026-06-05 16:52:49 -04:00
packages.py Refactor instance UI and update version to 0.0.20b7 and worksflow fixes 2026-06-01 15:40:55 -04:00
pyproject.toml update the versions numbers to a alpha 2 and update dep to fix vulnerability and fix instance managers 2026-06-24 14:48:22 -04:00
readme.md try to fix the workflow and add badges to readme 2026-06-05 16:52:49 -04:00
res.qrc add first version for skin manager,, and update site and more internal pagres to src/ instead of www/ and added noscript red error color in css 2026-06-07 14:01:08 -04:00
shell.nix update the versions numbers to a alpha 2 and update dep to fix vulnerability and fix instance managers 2026-06-24 14:48:22 -04:00
uv.lock update the versions numbers to a alpha 2 and update dep to fix vulnerability and fix instance managers 2026-06-24 14:48:22 -04:00

LCE Qt Launcher

French Version

LCE-Qt-Launcher Icon Screnshot of the launcher in version 0.0.20a0 of the launcher)

Warning

This launcher is work in progress and its feature could be changes or remove at any time. PR are more than welcome to fix or add features. Just be compliant with the GPLv3 license and the Code of Respect

Note

The auto-update and installation of the game files is unstable and unviable, it is recommnend to have the game file already installation as the installation and update mechanism require external repo that can be shutdown without previous notice. I do my best and the nightly build are often up to date but the stable version sometime lack behind and require manual intervention.

About

This is a custom Minecraft LCE Launcher written with PySide6 (Qt6 for Python) with Freedom and with GNU/Linux support in mind.

Why LCE Qt Launcher ?

  • Made in Python with Qt 6 : bloat free and integrate with GNU/Linux Plasma 6/Qt 6 Theme
  • Integration with Community Tools
  • GNU/Linux first class support
  • Licensed via copyleft licensing (GPLv3), so big tech free
  • Free as Freedom Launcher

Features

Long Term Goal / Roadmap

  • Accessibility
  • Skin support
  • GNU/Linux compatibility
  • Windows support
  • Experimental FreeBSD and Nix/NixOS support
  • Flatpak support
  • AppImage Support
  • Localisations support
  • Focus on being one place for everything Minecraft LCE on GNU/Linux

Compiling

See docs/en/COMPILING.md

Running/Debugging

See docs/en/RUNNING.md

How to get

Tag Release

In the GitHub Release page of this repo page you will found tagged Release like Beta 0.0.1.1.

Flatpak (Coming Soon)

Coming Soon (Delayed due to technical issues)

FreeBSD Port (Experimental)

See my FreeBSD Port Overlay to installing games/lce-qt-laucher (py{python version}-lce-qt-launcher) port.

Nigthly Build Nightly Build Action Status

Note

This branch is not stable and changes are made almost daily so this branch can sometimes break. Also, MacOS is not avaiable in the Nigthly Build due to Apple restriction and that I do now own a mac.

In this GitHub Release page you will found Nighly Build which are made automatically via GitHub Action when change are made in the dev branch

AppImage and Others Linux Packages

Aavailable in nightly build and tagged version (Coming soon!) (Note : currently the AppImage and Arch Package atomatic build is broken)

Via Git

You can also, downloading this repo with the command git clone https://github.com/xgui4/lce-qt-launcher.git and then compiling (see docs/en/COMPILING.md for more info how) anually or running in a .venv (see docs/en/RUNNING.md for more info how).

Software Requirement

Software recommendations

Python Library and Tools Used

  • PySide 6
  • platformdirs
  • rich
  • hatch
  • uv

Compatible Operating System

Golden Support

Note

Platform Tested Regurlaly and with completed implemation/patch

  • Windows 10 and later
  • GNU/Linux

Experimental Support

Note

Plattform tested with work in progress implemation

  • NixOS
  • FreeBSD Port & in venv (portable)
  • AppImage

Upcoming Platform

Note

Platform not tested yet, but with implementation

  • Flatpak

Unsupported OS

Note

These platform are not tested and may work or not at all

  • Other *BSD system, as Minecraft LCE is not supported on those and Wine is not available.
  • Minecraft LCE on Android is currently quite laggy and buggy
  • macOS: LCE Qt Launcher does not officially support MacOS and is not tested during PRs and testing and does not have package for it and there is no documentation for it. But expericenced user could make it work.

Special Thank to

Code of Respect

License

GPLV3