A tiny CLI Minecraft launcher.

Samuel Čavoj bdb606545e Add comment about java -XshowSettings:properties 11 hours ago
picomc bdb606545e Add comment about java -XshowSettings:properties 11 hours ago
.gitignore 6e23ec59dd Add .idea to .gitignore 1 month ago
LICENSE b604d66d75 Update copyright year in license 1 day ago
README.md 5c0ca246fe Improve README.md 1 day ago
setup.py 2e471d269e Add tqdm to requirements 11 months ago



picomc is a cross-platform command-line Minecraft launcher. It supports all(?) officialy available Minecraft versions, account switching and multiple separate instances of the game. The on-disk launcher file structure mimics the vanilla launcher and as such most mod installers (such as forge, fabric or optifine) should work with picomc just fine, though you will have to change the installation path. Don't hesitate to report any problems you run into.


The easiest and most portable way to install picomc is using pip, from the Python Package Index (PyPI):

pip install picomc

Depending on your configuration, you may either have to run this command with elevated privileges (using e.g. sudo) or add the --user flag like this:

pip install --user picomc


The quickest way to get started is to run

picomc play

which, on the first launch, will ask you for your account details, create an instance named default using the latest version of Minecraft and launch it.

Of course, more advanced features are available. Try running

picomc --help

and you should be able to figure it out. More detailed documentation may appear someday in the future.