Files · Batch 10 min

Repeat one job on a folder of files

One edit on one photo is a session. The same edit on a folder is a batch. PhotoCraft can record the steps, run them from the File menu, or run them from photocraft-cli without opening a window.

Record the steps once

Window, then Actions, opens the panel. Alt+F9 does the same. On a Mac, Alt is Option. The panel menu loads and saves action sets in the Photoshop .atn format. Record the steps, then play them on the document you have open.

File, then Automate, then Batch, runs the selected action on a folder, or on the documents you have open. Include All Subfolders also takes the images inside folders. In File Naming, tokens such as {name} and {serial} build the new names. Leave the naming empty to keep the original names. Add {ext} yourself if the names need an extension. {name}_{serial}{ext} writes names such as photo_001.png. Stop on error ends the batch at the first file that fails. Error log writes a text file of the files that failed.

A recorded Image Size step applies the size of the first file to the other files in the batch. That report is still open. The note is on the troubleshooting page, and the rest of this menu is on the workflows guide, both checked 21 November 2026.

Other folder tools from the official workflows guide.
CommandWhat it does
File, then Scripts, then Image ProcessorConverts a folder to JPEG, PNG, PSD, or TIFF, and can resize, without recording an action.
File, then Automate, then Fit ImageFits the image inside a width and height you set.
File, then Automate, then Contact Sheet IIPlaces a folder of images as thumbnails on one sheet.
File, then Export, then Layers to FilesSaves each layer as its own file.
File, then Export, then Artboards to FilesSaves each artboard as its own file.
File, then Automate, then Create DropletSaves the selected action as a droplet file. Record an action first.

The same commands without a window

photocraft-cli runs the commands the menus run. PhotoCraft ships no AI model of its own. An assistant you connect is a separate app. Run photocraft-cli --help for the subcommands, and photocraft-cli commands to list command names and settings. The install that puts the desktop app on the machine is still Which PhotoCraft file to download. The page these paths come from is Automation and AI agents. If a filename is missing on the release you open, the asset list wins.

Where the automation page says photocraft-cli is installed.
InstallWhere to look
Windows installer, your account%LOCALAPPDATA%\Programs\ArtCraft\PhotoCraft\photocraft-cli.exe
Windows installer, every accountC:\Program Files\ArtCraft\PhotoCraft\photocraft-cli.exe
Windows portable zipNext to photocraft.exe. The installer copies are not added to PATH.
macOSA separate download, photocraft-cli-<ver>-macos-universal.zip, on the GitHub release. It is signed and notarized.
Linux deb and rpm/usr/bin/photocraft-cli
Linux AppImageRun the AppImage with --cli first, for example ./photocraft-<ver>-linux-x86_64.AppImage --cli --help

Let an assistant touch one folder

The subcommands are convert, info, run, batch, droplet, commands, and mcp. convert opens one file and saves another format. info prints the size, the color mode, the depth, and the layers. run opens or creates a document, runs commands, and saves the result. batch applies a recorded action to every file in a folder. droplet runs a droplet on files or folders. commands lists every command. mcp starts the server an assistant talks to.

The documented server start is photocraft-cli mcp, with --automation-read-root and --automation-write-root, each pointed at a folder. Without those two options the assistant cannot read or write files on the computer. With them, it can read any file under the read folder, and it can create or replace image and document files under the write folder. A document can contain text, such as a layer name, that tries to steer the assistant. Point both roots at a folder you made for the job, and keep copies of the files you care about. On Windows, give the full path to photocraft-cli.exe, because that copy is not on PATH.

An assistant can also drive the PhotoCraft window you already have open. That setup is described for developers. To stop agents from connecting to the app, turn off Allow agent control under Edit, then Preferences, then AI Integrations. The change applies the next time PhotoCraft starts. On a Mac, preferences are PhotoCraft, then Settings. A resize you still want to watch happen belongs in A first session you can undo, not in a recorded Image Size step.

Pick the command that matches the folder

Image Processor is the small job. File, then Scripts, then Image Processor, converts a folder to JPEG, PNG, PSD, or TIFF, and it can resize, without an action. Use it when the only change is the format or the fit. Batch is the job you recorded. The action runs on a folder or on the documents already open, with Include All Subfolders, a naming pattern, Stop on error, and an error log. A droplet is that action saved as a file you can drop onto later. Create Droplet asks for an action first. photocraft-cli batch is the same idea with no window, and the executable paths are in the table above. Contact Sheet II is the contact sheet, a folder of thumbnails on one page. Layers to Files and Artboards to Files split a stack. Fit Image fits one document inside a width and a height.

Do not record Image Size when the folder holds different dimensions. That recorded step still applies the first file’s size to every later file, issues 11721 and 11722 on the troubleshooting page. Resize with Image Processor or Fit Image until that report closes. Point the source at a copy of the folder. An assistant connected through mcp can read everything under the read root and can create or replace files under the write root, so those two folders should be the copy, not your library. The open-window control protocol is for developers. Allow agent control, under Edit, then Preferences, then AI Integrations, is off until the next start when you turn it off. A single picture you still want to watch is A first session you can undo.