Download Principia

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

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

Principia 2025.04.05 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 5.0 and above (7.1 and below need to manually install certificates). APK contains native libraries for both 32-bit and 64-bit ARM devices as well as x86_64.

Principia 2025.04.05 for Android

Principia is also available for Android 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 2025.04.05 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

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 = https://arch.principia-web.se/$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.

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 2025.04.05 source code (.tar.gz)

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

git clone --depth 1 https://github.com/Bithack/principia

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. 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.

Whenever a new commit is pushed the game is automatically built by CI for all supported platforms. These nightly builds contain changes that have not yet made it into a full release, but are also less tested than the release builds.

For more information and downloads see the Nightly Builds page.

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.