Automation Studio
Process every photo dropped into a hot folder with one template, automatically, with optional auto upload and auto print.
Automation Studio is a hot-folder processor. Point it at a folder, and every photo that lands there is run through one of your templates, one after another, without anyone touching the computer. It does not create templates; it applies one you already made.
Chapters (8)
Available in Advanced Pro
Automation Studio has been in Q-Booth 5 since 5.2.0.0. It needs an Advanced or Pro license (their demo versions included) and doesn't appear on Basic. The template's own requirements still apply: for example, an AI Offline workflow template needs Pro to run.
When to use it
- A camera or tethering app that saves photos into a folder.
- A roaming photographer whose photos arrive in a shared or network folder.
- Reprocessing a large batch of existing photos with the same template.
Automation runs on its own, outside any event. It is designed to take over the computer while it runs, so a dedicated PC works best.
Which templates work
| Works | Does not work |
|---|---|
Photo Studio (.qsp), Collage (.qsc), AI Online (.qso, image output only), AI Offline and Face Swap (.qsd) | Motion, Art (.qsk), Lenticular, Flipbook, Augmented Reality |
The template must also:
- need exactly one photo as input;
- need no typed text from the guest;
- produce an image, not a video (an AI Online template ending in video is rejected).
AI Online templates use credits for every file processed. Test your setup with a Photo Studio template first.
Set it up
Open Studio › Automation. Settings are on the left, the Source and Result folder lists in the middle, and the Preview / Log tabs on the right. The badge at the top right shows Automation is OFF or Automation is ON.

1. Template
- Under Template, click Open.
- Choose From Gallery..., Browse File... or Recent Files.
- If the template does not meet the rules above, Q-Booth refuses to load it and tells you why (see the table below). Under the button you see the full path of the loaded template, or no file loaded.
| Message | Meaning |
|---|---|
| Template must need exactly one photo input to be used in Automation | The template asks for 0 or 2+ photos. For a Collage, that means it needs exactly one Independent photo layer; a 3- or 4-photo strip can't be used. Make a version with one photo slot. |
| Templates that require text input cannot be used in Automation | Remove the text question (a Collage User Input Text layer, or a dynamic prompt question in an AI template). |
| Video output is not supported yet in Automation | The AI Online template ends in a video. Use an image model. |
| Unknown or unsupported template type | Motion, Art, Lenticular, Flipbook, Augmented Reality, or not a template file. |
2. Folders
- Click Source Folder › Select Folder... and pick the folder where photos arrive. Recent Folders lists folders you used before.
- Click Result Folder › Select Folder... and pick where finished pictures go. If the folder doesn't exist yet, Q-Booth creates it. Use two different folders for Source and Result.
- Q-Booth reads only
.jpg,.jpegand.pngfiles, oldest first. Other files (for example RAW or HEIC) are ignored. - Only files directly in the Source Folder are picked up. Photos inside subfolders are not.
- Each processed photo is moved into a
donefolder inside the Source Folder, so nothing is processed twice. A photo that fails is moved into anerrorfolder and the queue continues. Don't let the camera software save intodoneorerror. - To retry a photo that failed, read the reason in the Log, fix it, then move the photo from
errorback into the Source Folder.
Automation moves your source photos. Always let it work on copies, never on your only originals.
3. Output (file names)
| Option | Result |
|---|---|
| Result File Format › Auto | A unique automatic name, for example event_1722244000_a3fd.jpg. |
| Result File Format › Input Name | Named after the source file with your Prefix, for example beach_IMG_0231.jpg. The prefix is required. |
| If File Exists › Overwrite | An existing file with the same name is replaced. |
| If File Exists › New + Suffix | A new file is created with a number suffix, for example beach_IMG_0231_1.jpg. |
If File Exists only matters with Input Name, since Auto names are always unique. When a template makes more than one result for a photo, Input Name numbers the extras: beach_IMG_0231.jpg, beach_IMG_0231_1.jpg, and so on. If the template saves a copy of the original photo, that copy keeps its automatic name.
4. Overlay
Since 5.9.6.1 this is a switch with Disabled / Auto / Custom (Disabled is the old Off).
- Auto: follows the template's own overlay setting. A template set to Default gets the global overlay from Settings › Overlay & Filters.
- Custom: replaces the template overlay with a JPG or PNG you pick with Select overlay image (required in this mode).
- Disabled (Off before 5.9.6.1): no overlay at all, even if the template has one.
Custom and Disabled only apply inside Automation; they don't change the template file.
Since 5.9.6.1, with Custom, the Put the photo inside the frame's window switch puts every result inside the frame's window (see Put the photo inside a frame). Like the image, it's only for this Automation session.
QR code on the result
Automation follows the template's own QR Overlay setting: Default uses the global QR on Result setting in Settings, while Disabled and Custom work as set in the template. It never uses an event's QR setting, because it isn't running inside an event.
- The QR code is added after the file is renamed, so it always points to the file's final name.
- Web QR must be set up in Settings › QR Share. If it isn't, the QR code is skipped and the Log says QR on result skipped — Web QR is not set up.
- A result with a QR code on it is always uploaded, even when Auto Upload Web QR is off, because a printed QR is useless if the photo isn't online.
5. Options: auto upload and auto print
- Auto Upload Web QR: uploads every result for its QR link, using the upload method set in Settings › QR Share (API or FTP). Uploads run in the background, so the next photo doesn't wait. Nothing is uploaded if Web QR isn't set up.
- Auto Print Result (since 5.5.1.0): prints one copy of each result as it's made, on Q-Booth's automatic printer choice (the least busy of the printers switched on in Settings). Set up the printer first in printer settings.
- Always one copy. Only images print; a video result is skipped (Auto print skipped — this result has no printable image.).
- If the template makes several results, only the first image prints.
- A printer problem never stops automation: it's written in the Log and the next photo goes ahead.
- With no printer set up, the Log says Auto print skipped — no printer is set up.
Leave both switches off while you test. Auto Print uses real paper and Auto Upload really uploads. Auto Print Result stays on after a restart; Auto Upload Web QR does not (see What's remembered).
6. Timing
Delay Between Process is the pause, in Seconds, before each photo is processed (minimum 1, default 5). A short delay keeps the computer from being overloaded and gives the operator time to pause.
Start Automation
- Click Start Automation. Q-Booth first checks your settings and refuses to start if the template, a folder, the prefix (for Input Name) or the custom overlay image is missing, or the delay is invalid. It also won't start while Background Job In Process shows: a background result (for example a guest's "pick up later") is still being made. Wait, or pause the background queue in the Jobs panel.
- The badge turns green: Automation is ON.
- Before each photo, a countdown window shows Last Result, Next Image and Processing in N. Click Process Now to skip the wait, or Pause Automation to stop.
- The photo then goes through the normal processing window, exactly as in the studio.

Watch it work
- One by one, photos leave the Source Folder list and their results appear in the Result Folder list. Each list shows its file count.
- The Preview tab shows the file you click, and jumps to the newest result after every successful process.
- The Log tab records every step with a time: template loaded, Automation started (ON), Processing, Process success, upload and print entries, errors, Automation stopped (OFF). When a photo fails, the Log shows the reason (Process error : …). It keeps the last 100 lines and is cleared when you close Q-Booth.
- When the folder is empty, Automation keeps watching and checks again every second. Drop in a new photo and it is processed right away.
- The countdown and Processing windows sit on top of the app, so you can't do other work in Q-Booth while a photo is being handled.

Stop Automation
Click Stop Automation. Processing stops at the next safe point, not in the middle of a photo. The badge returns to Automation is OFF. During the countdown, use Pause Automation. During processing, if the Processing window offers Cancel, cancelling stops automation too; the photo stays in the Source Folder and is processed again next time you start.
Share opens the sharing window for the file showing in Preview, so you can resend one result by hand.
If the app or the PC stops suddenly, just click Start Automation again. The Source Folder itself is the queue, so nothing is lost or done twice as long as a photo has not yet moved to done or error.
What's remembered
- The template, Source Folder, Result Folder and Auto Print Result are remembered after you close Q-Booth, so a dedicated automation PC is ready to go after a restart.
- The other settings (Output, Overlay, Auto Upload Web QR, Delay) stay while Q-Booth is open, but go back to their defaults when you restart it.
- Reset (only when automation is off) clears all settings, after asking Reset all Automation settings?. It doesn't delete any files.
Tips
- Work on copies: the source photos are moved.
- Test with print and upload off, then switch them on.
- Use templates that need one photo and no typing.
- Use Input Name with a prefix when you need to match results to the original camera files.
- Check the
errorfolder and the Log after a run.
Troubleshooting
Start Automation does nothing or shows a warning.
Read the message: "No template is selected", "No source folder is selected", "No result folder is selected", "File prefix is required for this option", "Select an overlay image for Custom overlay" or "Delay must be at least 1 second". Fix that setting and start again.
My template is rejected.
It needs more than one photo, asks for text, outputs video, or comes from a studio Automation does not support (Motion, Art, Lenticular, Flipbook, Augmented Reality). Use a single-photo image template.
New photos are not picked up.
Make sure they are saved as JPG or PNG (not RAW or HEIC) directly in the Source Folder (not in a subfolder), and that Automation is ON.
Where did my original photos go?
Into the done (success) or error (failed) subfolder inside the Source Folder.
Results overwrite each other.
You're using Input Name with Overwrite. Switch to New + Suffix.
It won't start: "Background Job In Process".
Wait for the background result to finish, or pause the queue in the Jobs panel.
My settings were reset after a restart.
Only the template, the folders and Auto Print Result are remembered.
"Auto print skipped — no printer is set up."
Set up a printer in Settings first, then turn on Auto Print Result.
"QR on result skipped — Web QR is not set up."
Configure Web QR in Settings › QR Share.
Next steps
Still need help?
Our team answers on WhatsApp. Tell us your Q-Booth version and what you see on screen.