Download Principia

This page contains downloads and instructions for obtaining Principia on all supported platforms.

Problems, crashes or bugs? Ask in the Discord server or on the forums, or open an issue on Github.


Windows 10 and above is supported, older versions may work but are not supported. See Windows Compatibility for more info.

Principia 2024.02.29 for Windows - Installer, 64-bit (recommended)

Principia 2024.02.29 for Windows - Portable, 64-bit

Administrator privileges are required to run the installer. The portable build has some limitations to it that are important to know about, see Windows Portable for more info.


Works with Android 4.4 and above. APK contains native libraries for both 32-bit and 64-bit ARM devices as well as x86_64.

Principia 2024.02.29 for Android

Principia is also available for Android on F-Droid:

Get it on F-Droid

Keep in mind that the F-Droid build uses a different signing key, which means that if you want to switch to or from F-Droid's builds you will need to fully uninstall Principia before installing the new version. Please back up your user data before doing so.

IMPORTANT WHEN UPDATING: Principia now stores its user data in scoped app storage as compared to in the shared storage. If you have existing levels and data saved locally from 1.5.1 you will need to manually migrate it to the new location. (See Accessing Android Data Directory for how to access)



GTK+3, FUSE2, xdg-utils and functional OpenGL drivers are required to be installed on your system!

A distro equivalent to Debian 11 Bullseye or newer is required.

Principia 2024.02.29 for Linux - AppImage, 64-bit

An AppImage is a single file containing the game's files that you run. For more information on how to run an AppImage see AppImage quickstart

Arch Linux

Principia is available in the AUR either as the stable principia package or the principia-git package tracking the master branch. Use your favourite AUR helper, as such:

yay -S principia

A custom binary repository is also available. To add:

echo -e '\n[principia]\nSigLevel = Optional DatabaseOptional\nServer =$arch' | sudo tee -a /etc/pacman.conf

A principia binary package for the latest version is available in the repository as well as a principia-git package which gets updated every now and then.


For Debian-based distributions, we have an MPR package tracking the latest master.

Install makedeb (if you do not already have it), and make the principia-git MPR package like such:

git clone
cd principia-git/
makedeb -si

Chrome OS

Install and enable the Linux container environment found on most recent Chrome OS devices.

From there, you can run the AppImage if it is an x86_64 device. Otherwise build from source following the instructions for Debian.


A package for Principia is available in nixpkgs.


A package for Principia is available in SlackBuilds.



Compilation instructions can be found on the Compiling Principia wiki page.

Principia 2024.02.29 source code (.tar.gz)

Alternatively clone the source repository and build from source (this will clone latest master):

git clone --depth 1


A very experimental port to macOS is available for Principia. If you have Mac hardware and are willing to test if Principia works on macOS this would be very appreciated.

Nightly builds for macOS are built on every commit which you can download from here (requires being logged into Github). Alternatively compile from source with the instructions found at Compiling Principia.


An experimental port to Haiku OS is available for Principia.

For instructions on how to compile and run Principia on Haiku OS see Compiling Principia.


The source code for Principia is hosted on Github with a read-only mirror available on Codeberg.

For instructions on how to compile Principia from source see the Compiling Principia page on the Principia Wiki.

The downloads for Principia are currently hosted by Github. Special thanks to ROllerozxa for hosting the Principia downloads prior to 2024.02.29.

For an archive of old Principia versions prior to the open sourcing, as well as Apparatus and Tesla Plushies, see the Bithack Game Archive Index.