Quick reference
Look up keyboard shortcuts, Q-Booth file types, where files are stored, event screen sizes, the guest flow, and the glossary of terms.
Everything you may need to look up while working: keyboard shortcuts, what each Q-Booth file type is, where files are stored, the event screen sizes, the guest flow, and a glossary of the terms used in the app and in this documentation.
Keyboard and mouse shortcuts
| Shortcut | Where | What it does |
|---|---|---|
| F5 | Event Editor | Launch the event full screen. (In the event list, use the card's Launch button.) |
| F5 | Photo, Collage, Motion, Art, AI Online, AI Offline, Lenticular and Flipbook studios | Process the template on the test photo. |
| F9 | Page Designer (every page) | Preview the page you are designing. |
| F10 | Page Designer › Camera Page | Simulate a capture session with sample photos. |
| G / U / D | Simulate window, with Gesture control on (since 5.9.0.0) | Act out a gesture: G = open hand then fist (takes the photo), U / D = thumbs up / thumbs down in review. |
| Esc | Preview / Simulate window | Close it. A click also closes a Preview. |
| Shift + F4 | Running event | Exit kiosk mode (asks for the PIN if one is set). Esc does not work here on purpose. |
| Double-click top-right corner | Running event | Exit kiosk mode (unless Shortcut Only (Shift+F4 Only) is chosen). |
| Shift + F2 | Running event | Open the event gallery, when gallery access is allowed. |
| Double-click top-left corner | Running event | Open the event gallery, when gallery access is allowed. |
| Ctrl + Shift + J | Anywhere | Open the Job Monitor (background uploads and processing). During an event only when the event allows it. |
| Ctrl + V | Paste from Clipboard window (the Clipboard choice of an image picker) | Paste the copied image. |
| Delete | Lists: Collage / Lenticular layers, Motion clips, page-designer elements, event templates, categories, gallery selection, AR stage | Delete the selected item. |
| The template's own key (e.g. 1, F1, Ctrl + A) | Running event, Template Picker | Picks that template. Set per template: template gear › KEYBOARD SHORTCUT (see Templates). |
File formats
Event and settings files
| Extension | What it is |
|---|---|
.qevent | Event design package (pages, templates, categories) — no statistics, no photos. Made with Export Event; opened with Import from File… in the event list. |
.qeventbak | Complete event backup: design, statistics, captured shots, results and the activity log. Made with Backup; opened with Restore from Backup. |
.qtheme | Event theme (the look of the guest screens). Picked when creating an event, or applied with Import Theme. |
.qbset | Backup of all app settings. Made with Export Settings…, restored with Import Settings… in Settings › Other. |
Template files (one per studio)
| Extension | Studio |
|---|---|
.qsd | AI Offline Studio, including Face Swap templates. |
.qso | AI Online Studio. |
.qsp | Photo Studio. |
.qsc | Collage Studio. |
.qsm | Motion Studio. Music and assets are stored inside, so the file is self-contained. |
.qsk | Art Studio. |
.qsl | Lenticular Studio. |
.qsf | Flipbook Studio. |
.qsb | Also Flipbook: the extension a Flipbook template gets when downloaded from the cloud Template Gallery. The event's Open File accepts it. |
.qsg | Augmented Reality (AR) Studio. |
Automation Studio has no file type of its own — it runs a .qsp, .qso, .qsc or .qsd template on a watched folder. A template file can only be opened in the studio that made it; renaming the extension does not change that.
Other files
| Extension | What it is |
|---|---|
.cube | LUT colour filter, used by the Camera Filter looks (called Filter Presets before 5.9.0.0). |
.png | Overlay frames, guide images and other images with transparency. |
.webm | Transparent video clip (for example an effect or AR character), made with the Transparent WebM Converter in Settings › Other. |
.zip | Log archive made with Export Logs, to send to support. Since 5.8.0.0, Upload to Server next to it sends the same ZIP straight to support. |
Folder structure
Everything lives inside the Q-Booth folder (default C:\QBoothAIV5), so deleting that folder deletes your photos and events too.
| Folder | Contents |
|---|---|
images\result | Finished studio results — the default Result Folder. |
images\camera | Camera shots (raw copies in images\camera\raw) — the default Camera Output. |
images\clipboard | Images pasted from the clipboard. |
events\<Event ID>\ | One folder per event, named after its Event ID: the design, the event's own copies of its templates, its media, camera\ (guest shots), result\ (guest results) and reports\ (exported reports and voucher lists). |
template_gallery\ | Your local Template Gallery. Cloud downloads land in template_gallery\download. |
assets\ | Built-in content: event themes (assets\event_theme, also where exported themes go), LUT filters, textures, videos, shared media and AI templates. |
exported_event\ | Default place for Export Event files. |
event_backup\ | Default place for event Backup files. |
settings\ | App settings. settings\backup holds the automatic copy made before Import Settings… — import it to undo. |
log\ | Log files for support. Kept for 30 days. |
backup\ | Files from the previous version, kept by the updater (not event backups). |
temp\ | Scratch files. Emptied every time Q-Booth starts — never keep anything here. |
The Event ID becomes the event's folder name and is fixed after the event's first Save. You can change where results and camera shots are saved in Settings › General › Folders & Files, and give an event an extra copy folder (event FILES › Also copy to:).
Event screen sizes
The event's ASPECT RATIO (GENERAL › Settings › DISPLAY) is the shape of the booth screen. It sets the canvas of every design page, so pick the one that matches the booth monitor. The long side is always 1920 px. New events start at 16:9; Easy Mode only offers Landscape (1920 × 1080) and Portrait (1080 × 1920).
| Ratio | Resolution (px) | Orientation |
|---|---|---|
| 16:9 | 1920 × 1080 | Landscape |
| 4:3 | 1920 × 1440 | Landscape |
| 3:2 | 1920 × 1280 | Landscape |
| 1:1 | 1920 × 1920 | Square |
| 9:16 | 1080 × 1920 | Portrait |
| 3:4 | 1440 × 1920 | Portrait |
| 2:3 | 1280 × 1920 | Portrait |
| Custom | Free size | — |
This is not the shape of the photos. Overlay frames are picked by the shape of each result (set per template), not by the screen ratio — see Event overlay. Make each overlay PNG in the shape of the photos it frames, with a transparent area where the photo shows through.
Guest flow at the booth
The pages a guest sees in a running event, in order:
- Welcome — the guest presses start.
- Survey — only if a survey is live.
- Category Picker — only when categories are shown As Standalone Page.
- Template Picker — the guest picks a style. Skipped when only one template is on.
- Input — only if the chosen template asks the guest something (a text for a collage, answers for a dynamic prompt…). It comes before the camera.
- Camera — countdown (if the Countdown element is shown), capture and review.
- Processing — the result is being made.
- Result — print, email, QR or try again.
Glossary
| Term | Meaning |
|---|---|
| Event | The container for one occasion: templates, categories, screen design, sharing, statistics. What you launch at the venue. |
| Event ID | The event's fixed short name (a number plus 4 letters by default). It is the event's folder name and can't change after the first Save. |
| Studio | A workspace where you build one kind of template (AI Offline, AI Online, Photo, Collage, Motion, Art, Lenticular, Flipbook, AR, Automation). |
| Template | One style a guest can choose, saved as a template file from a studio. |
| Category | A group of templates, shown as a filter or as its own page. |
| Template Gallery | The library of templates — your own (Local) and ready-made ones to download (Cloud). |
| Page Designer | The editor for the runtime pages guests see (Welcome, Template Picker, Camera, Result…). |
| Theme | A saved look for all the guest screens (.qtheme). |
| Runtime / kiosk mode | The full-screen event running at the booth after Launch. |
| Preview / Simulate / Launch | Test one page / test the capture flow with sample photos / run the real event. See the FAQ. |
| Overlay | A frame image laid over the finished result. Set per template, per event, or app-wide in Settings (template wins over event, event over app). |
| Camera filter / LUT | A colour look (from a .cube file) or texture guests can apply on the Camera Page. Managed in Settings › Overlay & Filters › Camera Filter (called Filter Presets before 5.9.0.0). |
| Guide Image | Pictures placed in the photo frame in Photo Studio: Camera Only (a pose outline shown only on the live view) or Camera + Result (also printed). In AI Offline Composite, the Guide Image tab is a different thing. |
| AI Offline | AI that runs on the booth computer itself. Face Swap: Advanced or Pro license, no graphics card required. Image templates (Imagine, Re-Imagine, Composite…): Pro plus an NVIDIA RTX card. |
| AI Offline Server | The local engine for AI Offline image templates. Its status (Loading / Online / Offline) shows at the bottom of the main menu. |
| AI Online | AI processing through an online service, paid with Built-in tokens or your own provider account. |
| Built-in / 3rd Party | The two AI Online payment choices: Q-Booth tokens, or your own API key. |
| API key | The secret code from your own AI provider account, entered in Settings › General › AI Online Service. |
| GPU Pack | An extra download (about 2.4 GB) that lets Face Swap, Face Restore and background removal run on an NVIDIA graphics card. |
| Compute Device | Auto / CPU / GPU — where those offline AI tools run (Settings › Advanced). |
| Face Swap | Puts the guest's face onto the faces in a scene picture. |
| Face Restore | Sharpens and cleans up faces in the result. |
| Imagine / Re-Imagine / Composite | AI Offline template types: create from text / transform the guest's photo with a prompt / combine the guest's photo with guide and background images. |
| Dynamic prompt | A prompt that changes with the guest's answers, built with the Dynamic Prompt Editor (called Prompt Builder before 5.8.0.0). See Dynamic prompt. |
| Prompt Builder | Since 5.8.0.0: builds a Basic (fixed) prompt by picking from lists instead of typing. In Easy mode it opens from Build my prompt. |
| Boomerang | A short clip that plays forward and then backward. |
| Art Drawing / Art Studio | Turns the guest's photo into a drawing in one of seven styles, plus a video of it being drawn. In every licence; the licence only limits which AI template it can draw from. See Art Studio. |
| Lenticular | A print behind a ridged lens that changes image when tilted. |
| Pitch Test / LPI | A calibration print that finds the lens pitch (lines per inch) for your printer, paper and lens. |
| Flipbook | A printed booklet made from a video, flipped to see the motion. |
| Web QR | Sharing by upload: the QR opens the result on the web. |
| Local QR | Sharing over the booth's own Wi-Fi, with no internet. |
| SMS Share (Twilio) | Since 5.9.2.0: texting guests a link to their photo through your own Twilio account, set up in Settings › QR Share. Twilio bills you per text. See SMS with Twilio. |
| Result delivery | How guests receive results: Direct, Email a link, Text a link (since 5.9.2.0), Manual pickup, Scan a QR now, Get it on WhatsApp (since 5.8.0.0). |
| Share buttons | Result Page button actions: Share: Web QR, Share: Local QR and Share: Email (called Web QR, Local QR and Send Email before 5.8.0.0), plus Share: WhatsApp and Share (one button that offers several ways) since 5.8.0.0, and Share: SMS since 5.9.2.0. |
| Job Monitor | The list of background jobs (uploads, logs, processing), opened with Ctrl + Shift + J. |
| Easy mode / Expert mode | A simplified guided interface, or the full interface with every editor. |
| Kiosk mode (payment) | Running the booth with voucher codes or payment before a session. See Kiosk & payment. |
| Payment Gateway | The add-on that lets guests pay at the booth by QR in Kiosk mode (called QRIS before 5.9.0.0; guests in Indonesia still pay with a QRIS code). Payments are read in the event Report › Payment Recap / Payments. |
| Gesture control | Since 5.9.0.0: guests use hand gestures instead of the screen — open hand then fist takes the photo, thumbs up / down finishes or retakes in review. |
| Automation | Applies one template to every photo dropped into a watched folder, without an operator. |
| Local API | Since 5.9.2.0: lets another app on the same computer or network control a running booth — start an event or a session, capture, print, show the QR — including a phone remote control. Off by default, in Settings › Advanced. It works on the local network only, not over the internet. See Local API. |
Next steps
Still need help?
Our team answers on WhatsApp. Tell us your Q-Booth version and what you see on screen.