Start · Trouble 10 min

When the window closes or the canvas is slow

A wrong installer is {{guides/start/install}}. This page is the next failure: PhotoCraft starts and then closes, draws on the CPU, or refuses a file because of memory. The steps follow the official troubleshooting page, checked 21 November 2026.

It closes as soon as it starts

PhotoCraft draws with the graphics card, so a driver problem can stop the start. Start it again. If the last start did not finish, PhotoCraft picks a safer graphics mode by itself. On Windows the order is Vulkan, then DirectX 12, then the CPU, and Intel or Qualcomm graphics start on DirectX 12. On Linux the order is Vulkan, then OpenGL, then the CPU. On a Mac it is Metal, then the CPU.

CPU mode does not depend on the graphics driver, and it is slower. When a mode works, PhotoCraft remembers it. Open Edit, then Preferences, then Performance. On a Mac that menu is PhotoCraft, then Settings. Rendering Mode offers Automatic (recommended), GPU, and CPU / Compatibility.

For one start on the CPU, launch PhotoCraft with --safe-gpu. On Windows you can also set WGPU_BACKEND to dx12 in PowerShell, in the folder that contains photocraft.exe, and then start the program. While that variable is set, PhotoCraft uses it and does not step down by itself. Remove the variable before a later launch. The official write-up is PhotoCraft troubleshooting.

The status bar says CPU Rendering

PhotoCraft could not use the graphics card, so it draws on the processor. Click the message. The reason is in System Info. Updating the graphics driver is the usual next step. Then set Rendering Mode back to Automatic (recommended) and restart PhotoCraft.

A slow canvas after that is a reason to keep working on a copy, not a reason to fetch a different installer. The file that matches the computer is still Which PhotoCraft file to download.

A file is refused for memory

Before it opens a PSD or PSB, PhotoCraft estimates how much memory the file needs. If that estimate is over the hard limit it measured from free memory, the open fails. The message names both numbers. A small file can fail when the limit is small. If the message says little or no memory is free, close other apps and try again.

Edit, then Preferences, then Performance holds the Memory Usage limit. Edit, then Preferences, then Scratch Disks sets where PhotoCraft writes the part of a large file that does not fit in memory. If a small file still fails, copy Help, then System Info, and paste that text with the full message into a report. The project lists this as an open problem since version 0.21.0, including on some Flatpak installs.

Recover the work, then report it

PhotoCraft saves recovery information for documents with unsaved changes every 10 minutes, and reopens them on the next start. You can change the interval, or turn it off, in Edit, then Preferences, then File Handling. Recovery is not a substitute for the copy you made before the first PSD save. That copy is Open and save a PSD without losing the original.

The current log is photocraft.log, in the folder in the table. After a crash, start PhotoCraft again and also attach photocraft.1.log, which is the run before. Help, then Report an Issue, opens the issue tracker. Help, then System Info, then Copy pastes the version, the operating system, and the graphics card. Write what you did, what you expected, and what happened. Leave out a file that is private. Search the tracker before you file a second copy of the same report. Short questions can go to Discord. Whether the alpha is still the right tool is What early alpha means.

Where PhotoCraft writes photocraft.log
SystemFolder
Windows%APPDATA%\Photocraft\logs\
macOS~/Library/Application Support/Photocraft/logs/
Linux~/.config/photocraft/logs/
Windows portable zipPhotoCraftData\logs\ next to photocraft.exe

A white border, a black taskbar, a warning from a network drive

Image, then Canvas Size, does not scale the photo. It adds space around it and fills the new space with the canvas extension color, which is the background color, usually white, until you change it. Set that color to Transparent when the new space should be empty. The white edge appears because a photo you open becomes a locked Background layer, and that layer cannot be transparent. To make the photo itself larger or smaller, use Image, then Image Size. The resize you wanted, and the difference between the two commands, also belongs in A first session you can undo if you are still learning which menu scales pixels.

PhotoCraft draws its own title bar. If the Windows taskbar turns black or disappears while PhotoCraft is maximized, update PhotoCraft first. If it still happens, turn on System title bar in Edit, then Preferences, then Interface, and restart, so Windows draws the title bar. On a Mac the preferences menu is PhotoCraft, then Settings. Saving a .pcraft file to a network share, such as a NAS, can show a warning that the file was changed by another app or that PhotoCraft could not confirm the save is durable. In the reports behind that note, the file was saved anyway. Keep the copy you made before the session, the one Open and save a PSD without losing the original asks for, and do not treat the warning as proof the write failed until you reopen the file from that share.

Problems the project still lists as open

The troubleshooting page, checked 21 November 2026, keeps a list of problems that are not fixed yet. A PSD or PSB can fail to open because of the memory limit, including a message that 0.0 GB is free, since version 0.21.0. The reports are issues 11715 and 11720, and ArtCraft issue 2744. Dropping a file on the window fails on some Linux systems since 0.21.0, issue 11714, which is why File, then Open, is the reliable path. A .pcraft save to a NAS can warn even though the file was written, issue 11873. A recorded Image Size step applies the first file’s size to the other files in a batch, issues 11721 and 11722. That one is Repeat one job on a folder of files. The eyedropper can show slightly different values on a CMYK JPEG, ArtCraft issue 2747, which is Color, proofing, and print.

Saving an Indexed Color image as GIF can change the palette, and some tools then add colors outside it. Those reports are issues 11824 and 11826. Files you open while PhotoCraft is running can open in new windows instead of tabs for some people, ArtCraft issue 2725. The canvas can be slow in full screen on an Intel MacBook Air, ArtCraft issue 2762. None of these are a reason to fetch an installer from a blog. Attach the log, the system info, and a description of what you expected. The alpha boundary around them is What early alpha means. The official list is PhotoCraft troubleshooting.