Skip to content
Craft Wiki

Install and update

ArtCraft Launcher installs, updates and opens every app in the Craft App Suite, PhotoCraft included. It picks the right build for your system and processor, checks it against the release’s SHA-256 checksums before installing it, and tells you when an update is out.

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

Every build is on PhotoCraft’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.

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

By default, the installer installs PhotoCraft for your account only and doesn’t need administrator rights. To install it for everyone on the computer, choose Everyone on this computer on the first page; this asks for an administrator. You can only have one copy installed, so to switch between the two, uninstall first.

The portable zip runs without installing. It keeps its settings in a PhotoCraftData folder next to the program, so you can carry it on a USB stick.

The installers and programs are code-signed.

Download photocraft-<ver>-macos-universal.dmg, open it, and drag PhotoCraft to Applications. It runs on Apple silicon and Intel Macs, and is signed and notarized by Apple.

The command-line tool comes separately, as photocraft-cli-<ver>-macos-universal.zip. See Automation and AI agents.

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

Every format also has an ARM64 build (aarch64 in place of x86_64). For RISC-V there is a riscv64 .deb, .rpm and tarball. The RISC-V tarball needs glibc 2.39 or newer, as on Ubuntu 24.04.

The first time you run the AppImage, it adds PhotoCraft’s icon and menu entry under ~/.local/share. Set PHOTOCRAFT_NO_DESKTOP_INTEGRATION=1 to skip that.

The Flatpak needs the freedesktop runtime from Flathub; flatpak offers to install it for you. Start it with flatpak run ai.storyteller.photocraft.

Gentoo: the community ::snakebyte overlay has media-gfx/photocraft-bin. It is not maintained by the PhotoCraft team.

Download photocraft-<ver>-freebsd-x86_64.tar.gz (or freebsd-aarch64 for ARM). The tarball is laid out like /usr/local. Install the libraries it needs, then unpack it there:

Terminal window
pkg install libxkbcommon wayland libX11 libXcursor libXrandr libXi libxcb mesa-libs vulkan-loader gtk3 fontconfig freetype2 alsa-lib
tar -xzf photocraft-<ver>-freebsd-x86_64.tar.gz --strip-components 1 -C /usr/local

photocraft-web-<ver>.zip is the web version. Unpack it onto any web server and open it in a modern browser.

To update the web version, replace the whole folder on your server with the new one, not only some files. Then reload the page in your browser with a hard refresh (Ctrl+Shift+R, or ⌘+Shift+R on a Mac), so it doesn’t keep showing the old version from its cache.

SHA256SUMS.txt lists a checksum for every file. The Linux files also have signature files ending in .asc, and so does SHA256SUMS.txt. To check the checksum list with GnuPG, import release-signing-key.asc from the release, then check the signature:

Terminal window
gpg --import release-signing-key.asc
gpg --verify SHA256SUMS.txt.asc SHA256SUMS.txt

You can ignore the other extra files on the release page: *-symbols.zip (debug symbols for Windows), *.oci-manifest.json and *.oci.sig (container images), and *.zsync (what AppImageUpdate uses to download only the changes).

Most people never need these. You can start PhotoCraft with a file name, or several, to open them:

  • On Windows and Linux, files you open while PhotoCraft is running open as new tabs in the copy that is already running. Add --new-instance to start a separate copy instead.
  • --safe-gpu starts with the CPU renderer for that start. See Troubleshooting.
  • --in-window-menus keeps the menus inside the window instead of the menu bar on a Mac.
  • --present-mode (fifo, autovsync or novsync) and --frame-latency (1 to 3) change how frames reach your display.
  • Set PHOTOCRAFT_CONFIG_DIR to a folder to keep PhotoCraft’s settings there.

Run photocraft --help to see them all.

PhotoCraft checks for a new version when it starts, and tells you when one is out. Only public release information is requested; nothing about you or your documents is sent. To check yourself, choose Help › Check for Updates…. To stop the check at startup, turn off Automatically Check for Updates in Edit › Preferences › General… (on a Mac, PhotoCraft › Settings…).

  • ArtCraft Launcher: tells you about new versions and updates PhotoCraft for you.
  • Installer, DMG, .deb, .rpm, Arch package: install the new version over the old one.
  • AppImage: run AppImageUpdate on it, or download the new one.
  • Flatpak, tarball, portable zip: download the new version and replace the old one.

Your settings are kept outside the app’s folder (except for the portable zip), so updating keeps them.

  • Windows: in Settings › Apps, find PhotoCraft and choose Uninstall. For the portable zip, delete its folder.
  • macOS: move PhotoCraft from Applications to the Trash.
  • Linux: remove the package with your package manager, run flatpak uninstall ai.storyteller.photocraft for the Flatpak, or delete the AppImage or the unpacked tarball.

Your images are not touched. Settings stay in PhotoCraft’s settings folder (see Find the log for where it is); delete that folder to remove them too.