Choose your CPU and package format
The release snapshot checked 2026-10-15 is v0.9.0. Use the package picker and SHA256 verifier for exact filenames, or check version history before downloading. ReleasesRelease checksums
| Route | When to use it | What to confirm |
|---|---|---|
| Flatpak bundle | Use the project's sandboxed package. | Flatpak setup and freedesktop runtime. |
| AppImage | Run a release file without a package-manager install. | Executable permission and CPU architecture. |
| DEB / RPM | Use the distribution package format. | DEB for Debian/Ubuntu; RPM for Fedora/RHEL/openSUSE. |
| Tarball / source | Control the unpack location or build. | Runtime libraries or development prerequisites. |
The checked release also includes RISC-V riscv64 DEB, RPM and tarball assets. The README describes that route as built against Ubuntu 24.04 and requiring glibc 2.39 or newer; no RISC-V AppImage or Flatpak is listed in the checked release. Find it in the complete file matrix. Platform READMERelease checksums
Keep the installer and SHA256SUMS.txt from the same official GitHub release. Match the filename and hash before running it. The examples use <version> as a placeholder: replace it with the downloaded release number, and change x86_64 to aarch64 for ARM64. Platform README
Install the local Flatpak bundle
Set up Flatpak for your distribution, download the matching .flatpak asset, and run these commands from its folder. The bundle needs the freedesktop runtime from Flathub, which Flatpak offers to install with it. This is a bundle installation, not evidence of a PhotoCraft listing on Flathub. Platform README
flatpak install --user photocraft-<version>-linux-x86_64.flatpak
flatpak run ai.storyteller.photocraftRun the AppImage
Allow the downloaded AppImage to execute, then run the same file. For example, after verifying an x86_64 download:
chmod +x photocraft-<version>-linux-x86_64.AppImage
./photocraft-<version>-linux-x86_64.AppImageThe README says the first run registers a launcher icon and menu entry under ~/.local/share. Prefix the launch with PHOTOCRAFT_NO_DESKTOP_INTEGRATION=1 to skip this. It also describes AppImageUpdate using accompanying .zsync assets; check the release rather than assuming an update was installed. Platform README
DEB, RPM and tarball alternatives
The README lists DEB for Debian/Ubuntu, RPM for Fedora/RHEL/openSUSE, and tarballs for unpacking elsewhere. Select the correct CPU package in the official file matrix and use your distribution's package installer. This wiki has not tested every distribution or confirmed a minimum Linux version for these checked packages. Platform README
Arch Linux and AUR: verification status
If you independently find an AUR entry, review its source URL, PKGBUILD, checksum and update history before installing. Treat that as a separately maintained packaging route, not an official PhotoCraft release. Platform README
Build PhotoCraft from source
The build book requires the stable Rust toolchain. On Linux, install windowing, GL and GTK development packages first; it links distribution-specific prerequisites for Debian/Ubuntu, Fedora, Arch and openSUSE. Follow those prerequisites before running the desktop app. Build guide
git clone https://github.com/storytold/photocraft
cd photocraft
cargo run --release -p photocraft -- image.psdReplace image.psd with a test file you own, or omit that argument to start without it. See the official documentation book for build details and the separate CLI and web targets. Build guide
Wayland: when dropped files do not open
The README identifies a winit 0.30 drag-and-drop limitation on Wayland. Use File › Open, or copy the image in the file manager and paste with Ctrl+V. If your environment supports XWayland, the documented alternatives are:
WAYLAND_DISPLAY= ./photocraft-<version>-linux-x86_64.AppImage
flatpak run --nosocket=wayland --socket=x11 ai.storyteller.photocraftThese are alternative launch commands for the respective package, not two steps to run together. Platform README
Keep important originals: PhotoCraft is an early alpha. For a reproducible failure, use the GitHub reporting checklist and include distribution, CPU, package, session type, document size and screenshot. Platform README
PhotoCraft Linux questions
Is PhotoCraft on Flathub?
The official instructions describe a downloadable Flatpak bundle from GitHub Releases. Flathub supplies the freedesktop runtime; that does not prove a PhotoCraft store listing exists. Install the local bundle by filename.
Can I install PhotoCraft from AUR?
This wiki has not verified a current PhotoCraft AUR entry or its maintainer. The official README lists release packages and source builds. Use those routes unless you independently review an AUR package and its build recipe.
Why does dragging a file onto PhotoCraft fail on Wayland?
The README describes a Wayland drag-and-drop limitation in winit 0.30. Use File then Open, or copy the file in your file manager and paste with Ctrl+V. It also documents XWayland launch options.
Which Linux architecture should I choose?
Choose x86_64 for a 64-bit Intel or AMD machine, and aarch64 for an ARM64 machine, matching the official package names. The checked release snapshot lists both. Confirm the architecture before downloading rather than assuming from the distribution name.
Sources
Every fact on this page comes from one of these pages, each opened and read on the date shown. Where a number is the project’s own measurement, the text says so.
- PhotoCraft README: downloads, Linux runtime and Craft apps — PhotoCraft contributors (GitHub). Read 2026-10-15. Platform instructions and app-family section, read again at the v0.9.0 tag; release assets remain a separate dated snapshot.
- PhotoCraft documentation book: Building — PhotoCraft contributors (GitHub). Read 2026-10-15.
- PhotoCraft releases — PhotoCraft (GitHub). Read 2026-10-15.
- PhotoCraft v0.9.0: official SHA256SUMS.txt — PhotoCraft (GitHub Releases). Read 2026-10-15. The download selector uses this dated checksum snapshot. Desktop installers remain on GitHub.