App Settings - Breeze Booth

What is it?

The App Settings are where you configure global settings relating to the Breeze Booth app. For example, it’s where you would configure your Sync settings to determine how you get your events on to the device. You do not create your events here, rather, that is done in the Event Editor.

Open Settings and then Enable “Advanced Settings”

In this Guide

Advanced Settings

By default the Settings screen only shows the essential settings. To show all the settings select Show advanced settings. This will display a much more in-depth list of settings.

Updating Events from a Web Server

The default method of updating events is by downloading them from a website. To do this set the “Events sync server” to the URL of the web site hosting the events. This is a more advanced option, most users would use the Dropbox sync method described below.

The default method of updating events is not very secure because anybody is able to download your events if they know the URL. For more secure hosting of events set the “Use HTTPS POST when syncing” option and set a password. For this to work you will need a suitable server side script to accept the request and check the password before returning the file.

Local Sync

If the iPad is connected to the same network as the PC running Event Editor you can use the local syncing option to run a simple web server and sync files to the iPad very quickly. This is very useful when editing an event because you can make a few changes in Event Editor and sync them to the iPad for testing very quickly.

Dropbox

An alternative way to host events is to use Dropbox. This method can be very secure because only devices with access to your Dropbox account will be able to access the event files.

Tap Sign in to Dropbox, then select Sync via Dropbox.
The official Dropbox app needs to be installed on the iPad when you tap Sign in to Dropbox. It will ask whether to allow Breeze Booth access to your Dropbox account.
Once signed in, you may uninstall the Dropbox app if you are concerned about unauthorized access to Dropbox files.

Saving Photos to Dropbox

Photos and animated GIFs captured by the photo booth are stored on the iPad and can also be saved to Dropbox by selecting Copy output to Dropbox.

If the iPad is offline it will queue files and copy them to Dropbox when a connection is available.
Clear the queue by tapping Clear queue.

Orientation Lock

Lock the Breeze UI to Landscape or Portrait. This prevents switching profiles when the device is rotated (e.g., Robots or Roaming devices).

Printing Photos

There are two options for printing photos from the app: AirPrint or Breeze Hub.

AirPrint is simple (same network as an AirPrint-enabled printer) but fewer photo-booth printers support it, it can be slower, and is less configurable.

Printing via AirPrint

Enable Print using AirPrint then tap Choose printer to connect.

Printing via Breeze Hub

Use Breeze Hub (Windows software) to print to any Windows-compatible printer. See Breeze Hub for details.

Timed Sessions

Breeze Booth for iPad can automatically run photo booth timed sessions with a start and end time. See Timed Sessions for details.

Breeze Hub Settings

Breeze Hub (Windows) can print photos, send emails/texts, and automatically download output to a Windows PC. Select Connect to Breeze Hub to use this option.

When connected, the server name and time/date are shown in the Breeze Hub status line.
If Breeze Hub is unavailable, files waiting to download are queued until it becomes available. The queue count is shown in the status line and can be cleared via Clear queue.
Select Show advanced settings to display advanced Breeze Hub settings:
- Add a password for additional security (must match the password set in Breeze Hub).
- Breeze Hub broadcast port number rarely needs changing, but must match if Hub uses a different port.
- By default, only print layouts, animated GIFs, MP4 files and print/email/text info are sent to Breeze Hub. Enable Copy all output to Breeze Hub to send everything.

Front Camera

Use Startup using front camera to specify which camera the app should use at startup.

h2#(signed-in). Must Be Signed In

Must be signed in only allows photo booth mode when the iPad is signed in. Useful for unattended booths to prevent free mode when not signed in (avoids watermarks after the 10 free sessions per day).

Activity Journal

Select Log activity to journal.txt to log usage and errors.

Files are saved in the iOS Files app under On My iPad → Breeze Booth.
A new file is created daily: journal_YYYYMMDD.txt.

Hide Events

Disable Show ‘Events’ menu entry to hide the Events button on the start screen (useful for unattended booths).

Hide Sign Out

Disable Show Sign Out menu entry to hide the Sign Out button when logged in (the Sign In button shows when not logged in).

Hide Quick Setup

Disable Show ‘Quick Setup’ button to hide the Quick Setup button on the start screen.

Daily Sync

Select Sync event daily at 4am to automatically sync the current event at 4am each day. (Only when the app is running in photo booth mode; not on the startup screen.)

Daily Purge

Select Purge photos daily at 4am to automatically delete the Photos folder at 4am.

Age (days) specifies how long to keep files (e.g., 5 keeps files newer than 5 days).
Use with care: purged files cannot be recovered.

Bluetooth

Select Connect to Bluetooth to use a compatible Bluetooth peripheral.

The app scans and auto-connects to the first device whose name matches the Bluetooth prefix.
Tap Set Bluetooth prefix to change it.

See Using Bluetooth for more information.

Setup Password

Set a Setup password to protect the settings screen (useful for unattended booths).

If forgotten: exit the app and replace settings.xml in the Breeze Booth folder via the iOS Files app.

Exit Password

Set an Exit password to prevent users exiting photo booth mode (e.g., where a touchscreen action can exit). The exit password also protects deleting images in the standby slideshow.

Event Name and Event Strings

Event name and strings let you customize events with tokens replaced at runtime.
Example email text: Your photos from eventName → becomes e.g. Your photos from Jack and Jill’s Wedding.

See Tokens for more information.

Event names/strings can be defined locally per iPad, or in Breeze Hub and sent to connected iPads.
Select Get event strings from Breeze Hub to receive them from Hub.

Upload Option

Output from the iPad can be automatically uploaded to a website by selecting the “Upload to cloud” option. The files are sent as an HTTPS POST with an optional password for additional security. For this to work the URL must point to a suitable script running on the web server to receive the uploaded files.

If the iPad is not connected to the internet it will keep a list of files and will upload them when an internet connection is available. The list of files waiting to be uploaded can be cleared by tapping on “Clear queue”.

A PHP script on a web server can access the uploaded file using the $_FILES variable. The optional password is hashed with the iPad vendor id, filename and the file’s MD5 checksum and can be verified using the following PHP code:

PHP authentication example

$password = "My secret password";

$id = $_POST["id"];
$filename = $_POST["filename"];
$chksum = $_POST["md5"];
$key = $_POST["key"];

// check client authentication string is correct
if (sha1("breeze" . $id . $password . $filename . $chksum) != $key) {
  fatalError(401, "Not authorized");
}

Built In SMTP

Emails sent directly from the iPad use SMTP. By default, emails are sent using the SMTP service provided with the Breeze Booth for iPad subscription.

Fair use: up to 1000 emails/month.
From address: noreplybreezesys.com@ or noreplymail.breezesys.com@.
Reply-To can be set via From email address in sharing settings.
To use your own From, choose Custom SMTP and enter your server details.

Custom SMTP

Specify your SMTP host, port, username, and password.

If Port is set to 0, the app will try secure email and auto-detect the port. Set a specific port if auto-detect fails or your server uses a nonstandard port.

Gmail settings

SMTP server: smtp.gmail.com
Port: 0
SMTP username: yournamegmail.com@
SMTP password: (your 16-digit Google App Password)
See: Google Support – App passwords

Twilio SMS

To send SMS you need a Twilio account (charges apply). See pricing at twilio.com.

Enter your Twilio message phone number, AccountSID, and AuthToken in settings.

Set the country prefix (e.g., +1 US/Canada, +44 UK, +49 Germany).
Users can enter numbers with or without the prefix; the app adds the prefix if missing.

Queuing

SMTP emails and Twilio texts are queued and sent in the background.

If the internet is unavailable, the app keeps trying.
If there’s a send error (e.g., bad credentials) the app tries once and records status in the XML file.
Failed messages can be sent later by copying files to a PC and running Breeze Hub.

Remove.bg API Key

Enter the API key for the background removal service you wish to use for AI background removal. Tap Check background removal API key and credits to verify the key and credits. See AI Background Removal for more info.

QR Code Scanning

Enable QR code commands and QR code strings to control the booth using QR codes. See QR Codes and Contactless Operation.

Face Detect

High quality face detect uses higher-quality detection for virtual props (more stable placement). Suitable for more powerful iPads only (e.g., iPad Pro, or iPads with A12 or better like iPad Air 10.5” or iPad mini 5).

External Controller

Allows a Windows PC to connect for monitoring and remote control (e.g., login/out, syncing, screenshots, sending commands) or for payment systems. See Remote control and monitoring of the iPad.

Status URL

Send regular status updates to a web server and receive commands.

Set Status URL to the endpoint that receives updates.
Set Interval (seconds) between updates; set to 0 to disable.
Optional password for extra security.

See Status URL for more details.

Id and Version Information

Id (vendor id) uniquely identifies this installation on this iPad. Reinstalling the app creates a new id.

Version Information

Shows version and build number and the login status.
If logged in, shows the user name.
If not logged in, shows @Free version: plus the number of photo and GIF sessions remaining before watermarking is applied.

Start Screen

Event List

Feedback

Post your comment on this topic.