Image ToolsIntermediate

How to Batch Upscale a Folder of Images with Topaz Photo AI

Process dozens of photos at once using Topaz Photo AI's batch mode and command-line tool so you do not click through each file.

8 minIntermediate

Upscaling one photo at a time is fine. Upscaling a wedding shoot of three hundred is not. Topaz Photo AI can take a whole folder and apply the same settings to every file, and it also ships a command-line binary for fully scripted runs. This guide covers both routes.

What you need

  • Topaz Photo AI installed and licensed
  • A folder of source images in one place
  • An output folder with free disk space (upscaled files are large)
  • Comfort with a terminal if you want the scripted route

Step 1: Add the whole folder to the app

In Topaz Photo AI, drag the entire folder onto the window or use File then Open and select multiple images. They appear as a filmstrip across the bottom. Settings you change apply to whichever image is selected, so set up one image first.

Step 2: Dial in settings on one representative image

Pick a typical photo from the batch and tune Upscale, denoise, and sharpen until it looks right. Then use the option to apply the current settings to all images so the batch stays consistent. Avoid per-image autopilot here, since it will vary the look across the set.

Topaz Photo AI - Batch
Filmstrip: [img_001 ok] [img_002 ok] [img_003 ...] [img_004]
Apply settings to: ( ) current (o) all images
Upscale: 2x
Remove Noise: Auto
Output: /Exports/upscaled/
Format: JPG Quality 95
The filmstrip shows progress per file; green means done.

Step 3: Run the batch export

Open Export, point the destination at your output folder, set the format and quality, then export all. Topaz works through the filmstrip and writes each finished file. Larger batches can take a long time, so let it run.

Step 4: Or script it from the command line

Topaz Photo AI installs a CLI binary. You can point it at a folder and an output directory and let it process every supported image without opening the GUI, which is ideal for a scheduled job.

upscale-folder.sh
#!/usr/bin/env bash
set -euo pipefail

# macOS path to the bundled CLI
TPAI="/Applications/Topaz Photo AI.app/Contents/MacOS/Topaz Photo AI"

IN="$HOME/Pictures/shoot"
OUT="$HOME/Pictures/shoot_upscaled"
mkdir -p "$OUT"

# --upscale enables the upscale model, --output sets the target folder
"$TPAI" --cli "$IN"/*.jpg --upscale --output "$OUT" --format jpg
Quote the binary path
The macOS app path contains spaces, so always wrap it in quotes. Without quotes the shell splits Topaz Photo AI into separate arguments and the command fails to find the binary.
zsh - batch run
$./upscale-folder.sh
Processing img_001.jpg ... done
Processing img_002.jpg ... done
Processed 312 files in 41m 18s
$

Result: a folder of 312 shoot images comes out the other side at twice the resolution with identical denoise and sharpen settings, written to a separate output folder so the originals are untouched.

Watch related tutorials

Tags
#topaz#batch#upscale#cli#workflow