App Settings

Top  Previous  Next

Tap on the "Settings" menu button in the startup screen to display the app settings screen:

 

settings screen default

 

By default the Settings screen only shows the essential settings. To show all the settings select "Show advanced settings".

 

Please note that the app settings screen is only used to define the way the app works. The "Event Editor" is used to edit events that are run on the iPad.

 

Updating Events from a Web Server or Dropbox

The default method of updating events is by downloading them from a web site. To do this set the "Events sync server" to the URL of the web site hosting the events. Please note that the web server must be a secure site (i.e. starting with https:// not http://). The default URL is https://bb4ipad.com/sync which hosts the example events.

 

Select "Show advanced settings" to see more detailed settings for updating events.

 

settings screen (advanced)

 

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.

 

An alternative way to host events is to use Dropbox. This method can be very secure because only devices that have access to your Dropbox account will be able to access the event files. To use this method first log into Dropbox by tapping "Sign in to Dropbox" then select the "Sync via Dropbox". The official Dropbox app needs to be installed on the iPad when you tap on "Sign in to Dropbox" and will open and ask whether to allow Breeze Booth permission to access your Dropbox account. Once the app is signed into Dropbox you can uninstall the Dropbox app if you are concerned about unauthorized people being able to access your Dropbox files.

 

Please see "Updating Events" for details of updating events from a web site or via Dropbox.

 

The photos and animated GIFs captured by the photo booth are stored on the iPad and can also be saved to Dropbox by selecting the "Copy output to Dropbox" option. If the iPad is not connected to the internet it will keep a list of files and will copy them to Dropbox when an internet connection is available. The list of files waiting to be copied to Dropbox can be cleared by tapping on "Clear queue".

 

Printing Photos

There are two options for printing photos from the app: AirPrint or via Breeze Hub. AirPrint has the advantage that all you need is an iPad connected to the same network as an AirPrint enabled printer. The disadvantages of using AirPrint are that there aren't many photo booth quality printers that support AirPrint and it can be slow and is not very configurable.

To use AirPrint for printing first enable "Print using AirPrint" then tap "Choose printer" to connect to the printer.

 

The alternative option for printing is to use Breeze Hub which is software that runs on a Windows PC and can print to any Windows compatible printer. Please see "Breeze Hub" for details.

 

Breeze Hub Settings

Breeze Hub is Windows based software which can be used to print photos and to send emails or texts. It also provides a way to automatically download the output from the photo booth to a Windows PC. Select "Connect to Breeze Hub" use this option.

 

settings screen showing hub

 

When the app is connected to Breeze Hub the name of the server and the time and date will be displayed in the "Breeze Hub" status line.

 

If Breeze Hub is not available any files waiting to be downloaded to Breeze Hub will be held in a queue until it becomes available. The Breeze Hub file queue status line shows the number of files in the queue and can be cleared by tapping on "Clear queue".

 

Select "Show advanced settings" to display advanced settings for Breeze Hub:

 

settings screen showing hub (advanced)

 

Additional security when connecting to Breeze Hub can be provided by using a password. The password must match the password set up in Breeze Hub in order for the app to be able to send files to it.

 

The "Breeze Hub broadcast port number" doesn't normally need to be changed, but if Breeze Hub is set up to use a different broadcast port this setting on the app also needs to be changed.

 

By default only print layouts, animated GIFs, MP4 files and printing, email and text information is sent to Breeze Hub. Select the "Copy all output to Breeze Hub" to send all output from the photo booth to Breeze Hub.

 

Advanced Settings

Select "Show advanced settings" to display the advanced settings:

 

settings screen (advanced)

 

settings screen showing hub (advanced)

 

Use the "Startup using front camera" option to specify which camera the app should use when it starts up.

 

Select "Log activity to journal.txt" to log information about the usage of the app and error messages. The journal files are saved on th eiPad and can be accessed using the iOS Files app by selecting "On My iPad" then "Breeze Booth". A new journal file is created each day and is given the filename journal_YYYYMMDD.txt where YYYYMMDD is the date in the form year, month, day.

 

Select the "Hide 'Events' menu entry" option to hide the "Events" menu button on the start screen. This can be useful for unattended booths if you do not want users to be able to access the event screens.

 

Select the "Hide Sign Out menu entry" option to hide the "Sign Out" menu button on the start screen when the iPad is logged in (the "Sign In" button will be visible if the iPad is not logged in). This can be useful for unattended booths if you do not want users to be able to logout.

 

The following two options are useful for fixed installations:

Select "Sync event daily at 4am" to automatically sync the current event at 4am each day. The current event will only be synced if the app is running in photo booth mode. It won't be synced if the app is displaying the startup screen.

Select "Purge photos daily at 4am" to automatically delete the Photos folder at 4am each day. This will avoid problems with the iPad running out of storage if it is use for a long time without manually clearing out old photos. Please use this option with care as it isn't possible to recover the contents of the Photos folder once it has been deleted.

 

Enter a password for the "Setup password" to protect the settings screen. This can be useful for unattended booths if you do not want users to be able to change the app's settings. If you forget the password it can be reset by exiting the app and replacing the settings.xml file in the "Breeze Booth" folder which can be accessed using the iOS Files app. Alternatively use the device_settings.xml update option to download a new settings file when updating events (see "Updating Events" for details).

 

Enter a password for the "Exit password" to prevent users from exiting out of photo booth mode. This is useful if a touchscreen action has been defined to exit photo booth mode and you want to prevent guests from using it.

 

Event Name and Event Strings

The event name and event strings provide a way of customizing an event by using tokens which are replaced with the actual values when the event is run. For example the text for emails sent when sharing photos could be set to "Your photos from {eventName}". If the event name is set to the name of the event, e.g. Jack and Jill's Wedding, the {eventName} token will be replaced with this text to give "Your photos from Jack and Jill's Wedding". Please see "Tokens" for more information.

 

Event names and strings can be defined locally on each iPad or they can be defined in Breeze Hub and sent to each connected iPad. Select the "Get event strings from Breeze Hub" if you want the iPad to receive the event name and strings from Breeze 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".

 

Id and Version Information

The id (also known as the vendor id) shown at the bottom of the settings table is a unique id that identifies this installation of the app on this iPad. If the app is uninstalled from the iPad and reinstalled it will be given a new id.

 

The version information shown at the bottom of the settings table shows the version and build number of the app followed by the login status. If the iPad is logged in this will show the name of the user. If the iPad is not logged in this will display "Free version:" followed by the number of photo and GIF sessions remaining before a watermark is added to all output.