
Troubleshooting
PhotoCraft closes as soon as it starts
Section titled “PhotoCraft closes as soon as it starts”PhotoCraft draws with your graphics card, so a graphics driver problem can stop it starting. Start it again: if the last start didn’t finish, PhotoCraft picks a safer graphics mode by itself.
- Windows: Vulkan, then DirectX 12, then the CPU. On Intel and Qualcomm graphics, PhotoCraft starts on DirectX 12 right away.
- Linux: Vulkan, then OpenGL, then the CPU.
- macOS: Metal, then the CPU.
The CPU mode doesn’t depend on your graphics driver, but it is slower. When a mode works, PhotoCraft remembers it. To see or change it, open Edit › Preferences › Performance… (on a Mac, PhotoCraft › Settings) and look at Rendering Mode: Automatic (recommended), GPU or CPU / Compatibility.
To force the CPU mode for one start, run PhotoCraft with --safe-gpu.
If it still closes on Windows, choose the graphics system yourself. In PowerShell, from the folder that contains photocraft.exe:
$env:WGPU_BACKEND = "dx12"& .\photocraft.exeRemove-Item Env:WGPU_BACKEND # go back to the default for later launchesWhile WGPU_BACKEND is set, PhotoCraft uses it and doesn’t step down to a safer mode by itself.
The status bar says “CPU Rendering”
Section titled “The status bar says “CPU Rendering””PhotoCraft couldn’t use your graphics card, so it draws on the processor instead. Click the message to see why in System Info. Updating your graphics driver often helps. Then set Rendering Mode back to Automatic (recommended) in Edit › Preferences › Performance… and restart PhotoCraft.
Dropping a file on the window does nothing on Linux
Section titled “Dropping a file on the window does nothing on Linux”On a Wayland desktop, files dropped on the window don’t open yet. Use File › Open…, or copy the image in your file manager and paste it with Ctrl+V.
To drag and drop, run PhotoCraft through XWayland: set Linux display server to X11 in Edit › Preferences › Performance… and restart PhotoCraft. You can also start it once with WAYLAND_DISPLAY= photocraft.
Since version 0.21.0, some people on Linux also can’t drop files with the X11 setting. One report says it still works on Windows 11. See Known problems, not fixed yet.
A file won’t open: “cannot be admitted … hard limit”
Section titled “A file won’t open: “cannot be admitted … hard limit””PhotoCraft checks how much memory a PSD or PSB file needs before it opens it. If the file needs more than PhotoCraft may use, you get a message like this:
cannot open “Top banner.psb”: its estimated memory requirement of 189 MiB cannot be admitted within the 109 MiB hard limit on this machine.
The hard limit comes from the free memory PhotoCraft measures on your computer. A small file can fail when the limit is small. If the message says “About … of memory is free” or “measured no free memory”, do what it says: close other apps and try again.
Two settings are related. Edit › Preferences › Performance… has the Memory Usage limit, and Edit › Preferences › Scratch Disks… sets where PhotoCraft puts the part of a big file that doesn’t fit in memory.
If a small file still fails, report it. Choose Help › System Info…, click Copy, and add the text and the full message to your report. People report this error with small files since version 0.21.0, including on Flatpak installs. See Known problems, not fixed yet.
The Windows taskbar turns black when PhotoCraft is maximized
Section titled “The Windows taskbar turns black when PhotoCraft is maximized”PhotoCraft draws its own title bar. If the taskbar turns black or disappears while PhotoCraft is maximized, update PhotoCraft first. If it still happens, turn on System title bar in Edit › Preferences › Interface… and restart PhotoCraft, so that Windows draws the title bar instead.
Canvas Size added a white border around my photo
Section titled “Canvas Size added a white border around my photo”Image › Canvas Size… doesn’t scale your photo. It adds space around it, and fills the new space with the Canvas extension color, which is your background color (usually white) unless you change it. To add empty space, set Canvas extension color to Transparent.
This happens because a photo you open becomes a locked Background layer, which can’t be transparent. To make the photo itself bigger or smaller, use Image › Image Size….
A PSD doesn’t look as it does in another app
Section titled “A PSD doesn’t look as it does in another app”PhotoCraft is in early alpha, and some effects or features in a PSD may look different or be left out. PhotoCraft warns you when it can’t match something in a file. Keep your original file, and please report the document if you can share it: real files are how we find these problems.
Saving to a network drive shows a warning
Section titled “Saving to a network drive shows a warning”Saving a .pcraft file to a network share, such as a NAS, can show “was changed by another app after it was opened or saved here” or “could not confirm the save is durable”. In the reports, the file was saved anyway. See Known problems, not fixed yet.
PhotoCraft closed and I lost my work
Section titled “PhotoCraft closed and I lost my work”Start PhotoCraft again. It saves recovery information for documents with unsaved changes every 10 minutes, and reopens them when it starts. You can change how often, or turn this off, in Edit › Preferences › File Handling….
Find the log
Section titled “Find the log”PhotoCraft writes a log you can attach to a bug report.
| System | Log folder |
|---|---|
| Windows | %APPDATA%\Photocraft\logs\ |
| macOS | ~/Library/Application Support/Photocraft/logs/ |
| Linux | ~/.config/photocraft/logs/ |
| Windows portable zip | PhotoCraftData\logs\, next to photocraft.exe |
The current log is photocraft.log. The log from the run before is photocraft.1.log, so if PhotoCraft crashed and you have started it again since, attach that one too.
The folder above logs is PhotoCraft’s settings folder.
Report a bug
Section titled “Report a bug”Choose Help › Report an Issue… to open PhotoCraft’s issue tracker. Include:
- What you did, step by step, and what you expected.
- What happened instead. A screenshot helps.
- Your system details: choose Help › System Info…, click Copy, and paste the text. It lists your PhotoCraft version, operating system and graphics card.
- The file, if one file causes the problem, and the log. Leave the file out if it contains anything private.
Search the tracker first. If someone has already reported your problem, add your details there.
Known problems, not fixed yet
Section titled “Known problems, not fixed yet”These are open on the issue tracker. Add your details there if you run into one.
- Cannot open a PSD or PSB because of the memory limit, or “0.0 GB is free”, since 0.21.0: #11715, #11720, #2744.
- Dropping a file on the window doesn’t open it on some Linux systems since 0.21.0: #11714.
- Saving a
.pcraftfile to a NAS shows a warning although the file is saved: #11873. - A recorded Image Size step applies the first file’s size to the other files in a batch: #11721, #11722.
- The eyedropper shows slightly different values on a CMYK JPEG: #2747.
- Saving Indexed Color images as GIF changes the palette, and some tools add colors outside it: #11824, #11826.
- Files you open while PhotoCraft is running open in new windows instead of tabs for some people: #2725.
- The canvas is slow in full screen on an Intel MacBook Air: #2762.
Still stuck?
Section titled “Still stuck?”- Ask in the ArtCraft Discord.
- Report a bug on GitHub, with the log attached.