Files
photocraft/docs/user/getting-started/install.md
T
c6fd71241d docs: add user docs in docs/user (#3951)
* docs: add user docs for PhotoCraft

Adds docs/user/ (published at getartcraft.com/docs/photocraft), the docs
check and publish workflows (copied from craft-launcher), and a User docs
rule in AGENTS.md. Checker: 0 error(s), 0 warning(s).

Source notes per page:
- index.md: README (intro, status, Crafting Apps table), website
  crafting-apps.ts photocraft entry, links.rs (Discord, issues), menus.rs
  (Help > Report an Issue).
- getting-started/index.md: menus.rs and menu_catalog.rs labels, panels.rs
  (Layers, Properties, History), dialogs.rs (Create button).
- getting-started/install.md: README Downloads and Get started sections,
  gh release view v0.7.0 asset list, craft-launcher catalog.rs (lists
  PhotoCraft).
- guides/open-and-save-files.md: apps/photocraft/src/services.rs (open and
  save filters), README Formats and PSD sections, docs/file-format-parity.md.
- guides/adjust-colors-with-adjustment-layers.md: menu_catalog.rs, panels.rs
  (footer button, adjustment list), lib.rs (Properties shows new layer).
- guides/select-and-mask.md: menu_catalog.rs Select and Layer Mask menus,
  state.rs tool names, retouch_ui.rs (Select Subject button and message).
- guides/add-and-style-text.md: state.rs (Horizontal Type Tool, T),
  type_tool.rs, menu_catalog.rs Layer Style and Type menus, dialogs.rs.
- guides/export-an-image.md: export_dialog.rs (labels, formats, options).
- troubleshooting/taskbar-turns-black.md: issues 3550, 3864, 3430, 3144,
  PR 3308 (git: not an ancestor of v0.7.0), prefs_ui.rs (System title bar).
- troubleshooting/text-moves-when-editing.md: issues 3795, 1317, PR 3819
  (open).
- troubleshooting/get-help.md: menus.rs, links.rs, gpu_status.rs (System
  Info content).
- faq/*: README (status, license badge, offline, formats), LICENSE-MIT and
  LICENSE-APACHE, docs/file-format-parity.md.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* docs(user): apply final review fixes

Part 1: verified = latest release tag policy in docs/user/AGENTS.md; released-pages sentence in root AGENTS.md. Part 4 items 1-9: remove x86 row and TGA resolution, formats, new photocraft-does-not-start page, mask label, taskbar workaround, wording, Affinity read-only, index.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* docs(user): use the standard section title

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* docs(user): describe PhotoCraft 0.7.0 startup behaviour

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* docs(user): tighten PhotoCraft startup wording

Drop the unsourced "slower" claim for CPU mode and give the exact
Preferences path on Windows and macOS.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* docs: pin the docs checker to a commit and its SHA-256

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* docs: drop the docs workflows until the checker is on artcraft-services main

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* docs: re-verify against 0.8.2

- taskbar and PSD text pages: both fixes ship in 0.8.2; tell users to
  update and drop the "not in a release yet" wording and workarounds
- does not start: 0.8.2 fixes the Intel Iris Pro/Monterey Device(Lost)
  case; OpenCore Legacy Patcher Macs still have no fix
- install: Windows 10 or later, 32-bit Windows builds, RISC-V deb/rpm,
  Wayland paste and XWayland notice
- open and save: Krita and Paint.NET filters, Krita/PCX/FITS formats,
  save progress, JPEG/WebP encoding kept on Save
- export: TGA Resolution, multi-layer Export As and Quick Export
- text: Shift-click starts new text over existing type
- CLAUDE.md is now a regular file pointing to AGENTS.md
- verified: 0.8.2 on every page

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* Drop the root AGENTS.md docs rule; keep the PR to docs/user/

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

* docs(user): drop the stale missing-tools count from the Photoshop FAQ

Re-verified the page against v0.9.0.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>

---------

Co-authored-by: Fabio Lussi <198260595+itrycodinganditsbad@users.noreply.github.com>
Co-authored-by: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-18 16:15:53 -06:00

4.2 KiB
Raw Blame History

title, description, order, verified
title description order verified
Install PhotoCraft Download PhotoCraft for Windows 10 or 11, macOS or Linux from getartcraft.com or GitHub, or install it with ArtCraft Launcher. 10 0.8.2

The easiest way is the PhotoCraft page on getartcraft.com. You can also install it with ArtCraft Launcher, which lists PhotoCraft. For a specific build or file format, take it from the latest release on GitHub. In the file names below, <version> stands for the version number, for example 0.8.2.

Windows

PhotoCraft needs Windows 10 or later. On Windows 7 and 8 the installer stops with "PhotoCraft needs Windows 10 or later."

  1. Open the latest release.
  2. Download photocraft-<version>-windows-x64.msi. It fits most PCs (64-bit Intel and AMD).
  3. Run the file and follow the installer.

To run without installing, download photocraft-<version>-windows-x64-portable.zip instead and unzip it.

Your PC Installer Portable
64-bit Intel or AMD photocraft-<version>-windows-x64.msi photocraft-<version>-windows-x64-portable.zip
Arm (Snapdragon and other Arm PCs) photocraft-<version>-windows-arm64.msi photocraft-<version>-windows-arm64-portable.zip
32-bit photocraft-<version>-windows-x86.msi photocraft-<version>-windows-x86-portable.zip

The installers and executables are code-signed.

macOS

  1. Download photocraft-<version>-macos-universal.dmg. It works on Apple silicon and Intel Macs, and is signed and notarized by Apple.
  2. Open it and drag PhotoCraft to Applications.

Linux

Pick one file from the release. Use x86_64 for Intel and AMD, or aarch64 for Arm.

Format File Notes
AppImage photocraft-<version>-linux-x86_64.AppImage Runs anywhere and needs no install.
Debian and Ubuntu photocraft-<version>-linux-x86_64.deb
Fedora and openSUSE photocraft-<version>-linux-x86_64.rpm
Flatpak photocraft-<version>-linux-x86_64.flatpak Run flatpak install --user <file>, then flatpak run ai.storyteller.photocraft.
Tarball photocraft-<version>-linux-x86_64.tar.gz Unpack it anywhere.

The first time you run the AppImage, it adds its icon and menu entry under ~/.local/share. Set PHOTOCRAFT_NO_DESKTOP_INTEGRATION=1 to skip that. For RISC-V, take the riscv64 file: photocraft-<version>-linux-riscv64.tar.gz, .deb or .rpm. The RISC-V tarball needs glibc 2.39 or newer.

On a Wayland session, files dropped on the PhotoCraft window do not open yet. Use File › Open… instead, or copy the image in your file manager and paste it with Ctrl+V. To drag and drop, start PhotoCraft under XWayland with WAYLAND_DISPLAY= photocraft. PhotoCraft shows the right command for your install in a notice until you dismiss it.

FreeBSD and the web

FreeBSD 14 (x86_64) has a tarball, photocraft-<version>-freebsd-x86_64.tar.gz, laid out like /usr/local. The web version comes as photocraft-web-<version>.zip, a static site you host on any web server. It runs in a modern browser.

Check your download

SHA256SUMS.txt on the release lists a checksum for every file.

Next step

Open an image: Open and save files.