Settings: General
Set the app language, theme, menu layout, AI Online tokens and API keys, and the folders where Q-Booth saves photos and results.
The General tab is the first page of App Settings. It controls how Q-Booth looks (language, colours, size), how the main menu behaves, your AI Online tokens and keys, and where photos and results are saved on disk. You normally set it once per computer.
Open App Settings
- Click Settings in the main menu. The App Settings window opens.
- The left column lists the tabs: General, Hardware, Overlay & Filters, QR Share, Other and Advanced.
- Make your changes, then click Save Settings at the bottom right. Cancel closes the window without keeping most changes — see How saving works for the exceptions.
Some tabs and groups are hidden to keep the window simple. If you don't see a tab or option described in these articles, turn on Show all settings at the bottom left of the window. It only changes what this window shows — nothing else. In Expert mode it is on by default; in Easy mode it starts off.

What Show all settings hides
In Easy mode the window opens "folded": only General, Hardware and QR Share are in the list. With Show all settings off, these are hidden:
- The tabs Overlay & Filters, Other and Advanced.
- In General: Studio Navigation, Mode switch and the whole Folders & Files group.
- In Hardware: Camera 2 and the Live View Framing card.
- In QR Share: the Local QR card, the Email Share card, the SMS Share (Twilio) card (since 5.9.2.0), and the FTP method for Web QR (unless FTP is already the chosen method).
The switch isn't remembered — next time, Settings opens again the way the mode says. It does not switch the app between Easy and Expert. Hiding a row never changes or erases what was set there: a second camera set up in Expert mode keeps working in Easy mode.
How saving works
Most changes are only kept when you press Save Settings; the window then closes. Cancel (or the window's X) closes without keeping them. There are exceptions:
- Language, Theme Color, Theme Style and UI Size take effect and are saved the moment you change them — even if you then press Cancel.
- These pop-up windows save on their own Save button, separately from Save Settings: a camera's Configure window (a GoPro pairing is saved as soon as it succeeds), the printer list (Printer Setting → Configure…), Camera Filter → Configure (its button is Save Preset Filter), and adding or editing a Web QR FTP session, a Local QR session or an SMTP email account.
- But which camera type and device, which QR session and which email account is selected still needs Save Settings.
Pressing Save Settings also restarts the Local QR server with the new session. Since 5.9.3.0, picking a Local QR session already starts the server, so Check Status and Test QR work before saving; Cancel puts the saved choice back.
Appearance
These options only change how the Q-Booth window looks on your computer. They do not change what guests see in a running event — that is designed per event in the Page Designer.
| Option | What it does |
|---|---|
| Language | The language of the whole interface. The menus switch immediately. |
| Theme Color | The colour scheme of the app, for example Light, Dark, Sky, Honey, Ember or Mustard. |
| Theme Style | The shape and style of buttons and controls (Modern, Classic, NeoBrutalism). A few buttons only refresh after you close and reopen the window they are in. |
| UI Size | Standard, Big or Huge. Makes text and controls larger — handy on a touchscreen or a high-resolution monitor. Since 5.5.0.0 windows no longer cut off their contents at Big or Huge; on an older version, update. |
Main menu and navigation
| Option | Choices | What it does |
|---|---|---|
| Studio Navigation | Select studio dialog / Show in sidebar | What happens when you click Studio in the main menu. Select studio dialog keeps the menu short and opens a picker window; Show in sidebar lists every studio as its own menu item. When the menu is collapsed to icons, the dialog is always used. |
| Menu Position | Left side / Right side | Which edge of the window the main menu sits on. |
| Mode switch | Show / Hide | Shows or hides the Easy / Expert switch at the foot of the main menu. Hide it on a booth that should always stay in one mode, so staff can't switch by accident. |
There is no right or wrong choice here — pick whatever feels most comfortable for the people who operate the booth.
AI Online Service (tokens and API keys)
Since 5.8.0.0 this section holds your Built-in tokens and your own API keys in one place:
- Built-in credit card (QBooth / XBooth cloud licence, and since 5.9.6.1 a dongle registered to a lumaqube.com account) — your token balance, a refresh button, Buy tokens and Recent Generations.
- Your own API keys — a fal.ai row and a WaveSpeed row, both always shown. Paste the key from that provider's dashboard; Get a key opens the provider's key page. Tick Show key to check what you pasted.
A key here doesn't choose a provider. Each template picks Built-in or 3rd Party (and which service) in AI Online Studio, so you only need a key for the services your templates use. If you only use the Built-in QBooth tokens, you don't need a key at all. Click Save Settings to keep the keys.
The whole section is hidden on a Basic licence, because AI Online needs Advanced or higher. On versions before 5.8.0.0 there was an AI-Online API Provider dropdown that switched which key box was shown; each provider still kept its own key.
How to create an account and get a key is explained step by step in AI Online Studio.
Treat the API key like a password. Don't show it on screen while recording or streaming, and don't send it in chat.
Folders & Files
Every path already has a working default inside the Q-Booth folder, so most booths never need to change anything here.
| Option | Default | What it does |
|---|---|---|
| Result Folder | app folder\images\result | Where finished results from the studios are saved. |
| Camera Output | app folder\images\camera | Where raw camera shots are saved. |
| Processing Animation | app folder\assets\shared_media\process_animation.mp4 | The image or video shown while a result is being processed. |
| Filename Prefix | QIMG | The first part of every result file name. A Photo Studio result looks like QIMG_PS_1784672399_hSNi.jpg (prefix, studio code, a time stamp, 4 random letters). Change it to your brand or client name to make files easy to recognise. |
Click Change to pick another folder or file, or Use Default to go back to the original location.
Only move the folders if you have a reason — for example drive C is almost full and you want results on a bigger drive. Events keep their own result and camera folders inside each event; an event can also copy results to an extra folder in its event settings. If you move the Result Folder, the Gallery doesn't follow — add the new folder there with Manage Folders.
Common questions
I changed the language, but some text is still in the old language.
Most text switches immediately. If a window that was already open still shows old text, close and reopen it. Event pages that guests see use the text you typed in the Page Designer, not the app language.
Where are my photos?
Studio results go to the Result Folder; raw camera shots go to Camera Output. Results from a running event are stored inside that event. The easiest way to find any of them is the Gallery.
I changed a setting but it went back.
The window was closed with Cancel or the X instead of Save Settings.
I pressed Cancel but the language still changed.
That's expected — Language, Theme Color, Theme Style and UI Size apply and are saved straight away.
I can't find Folders & Files or Studio Navigation.
Turn on Show all settings at the bottom left of the App Settings window.
Next steps
Still need help?
Our team answers on WhatsApp. Tell us your Q-Booth version and what you see on screen.