Skip to content
Craft Wiki

Install and update

ArtCraft Launcher installs, updates and opens every app in the Craft App Suite, MaterialCraft included. It picks the right build for your system and processor, and tells you when an update is out.

Download it from its latest release, then press Install on MaterialCraft’s card.

Every build is on MaterialCraft’s latest release page; all releases has earlier versions and their notes. In the file names below, <ver> is the version number. SHA256SUMS.txt lists a checksum for every file.

Every desktop build comes with the command-line tool, materialcraft-cli, next to the app. On macOS it is a separate download.

Your PC Installer Portable
Most PCs (64-bit Intel or AMD) materialcraft-<ver>-windows-x64.msi materialcraft-<ver>-windows-x64-portable.zip
ARM PCs, such as Snapdragon materialcraft-<ver>-windows-arm64.msi materialcraft-<ver>-windows-arm64-portable.zip
32-bit Windows materialcraft-<ver>-windows-x86.msi materialcraft-<ver>-windows-x86-portable.zip

The installer installs MaterialCraft for everyone on the computer, into Program Files, so Windows asks for administrator permission. It adds MaterialCraft to the Start menu. The portable zip needs no install: unpack it and run materialcraft.exe.

Download materialcraft-<ver>-macos-universal.dmg, open it, and drag MaterialCraft to Applications. It runs on Apple silicon and Intel Macs.

The command-line tool is materialcraft-cli-<ver>-macos-universal.zip.

Format File Notes
AppImage materialcraft-<ver>-linux-x86_64.AppImage Runs on most distributions; no install needed
Flatpak materialcraft-<ver>-linux-x86_64.flatpak Install with flatpak install --user <file>
Debian, Ubuntu materialcraft-<ver>-linux-x86_64.deb
Fedora, RHEL, openSUSE materialcraft-<ver>-linux-x86_64.rpm
Arch Linux materialcraft-<ver>-linux-x86_64.pkg.tar.zst Install with sudo pacman -U <file>
Tarball materialcraft-<ver>-linux-x86_64.tar.gz Unpack anywhere

Every format also has an ARM64 build (aarch64 in place of x86_64). There are RISC-V builds too (riscv64) as a .deb, an .rpm and a tarball. You can also install and update through the ArtCraft Linux repositories.

Download materialcraft-<ver>-freebsd-x86_64.tar.gz (or freebsd-aarch64 for ARM) and unpack it.

materialcraft-web-<ver>.zip is the web version. Unpack it onto any web server and open it in a modern browser. Opening, saving and exporting go through your browser’s downloads.

MaterialCraft doesn’t check for updates itself.

  • ArtCraft Launcher: tells you about new versions and updates MaterialCraft for you.
  • Installer, DMG, .deb, .rpm: install the new version over the old one, or update through the Linux repositories.
  • AppImage: run AppImageUpdate on it, or download the new one.
  • Flatpak, tarball, portable zip: download the new version and replace the old one.
  • Windows: in Settings › Apps, find MaterialCraft and choose Uninstall. For the portable zip, delete its folder.
  • macOS: move MaterialCraft from Applications to the Trash.
  • Linux: remove the package with your package manager, run flatpak uninstall ai.storyteller.materialcraft for the Flatpak, or delete the AppImage or the unpacked tarball.

Your packages are not touched. Autosaves stay in Documents/MaterialCraft; delete that folder to remove them too.