mirror of
https://github.com/storytold/photocraft.git
synced 2026-10-25 10:27:07 -06:00
c6fd71241d
* 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>
60 lines
4.2 KiB
Markdown
60 lines
4.2 KiB
Markdown
---
|
||
title: Install PhotoCraft
|
||
description: Download PhotoCraft for Windows 10 or 11, macOS or Linux from getartcraft.com or GitHub, or install it with ArtCraft Launcher.
|
||
order: 10
|
||
verified: 0.8.2
|
||
---
|
||
|
||
The easiest way is the [PhotoCraft page on getartcraft.com](https://getartcraft.com/apps/photocraft). You can also install it with [ArtCraft Launcher](https://getartcraft.com/docs/craft-launcher/guides/install-and-update-apps), which lists PhotoCraft. For a specific build or file format, take it from the [latest release](https://github.com/storytold/photocraft/releases/latest) 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](https://github.com/storytold/photocraft/releases/latest).
|
||
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](../guides/open-and-save-files.md).
|