Breeze Booth for iPad Beta Notes

New! 27 May 2018: Breeze Booth for iPad beta build 14 now available
If you're still running build 11 please run TestFlight on your iPad to update to build 14.

Installation

Download TestFlight from the Apple App Store and click on "Redeem" to show the apps you're able to beta test. Select Breeze Booth for iPad and install. When a new beta is available you should receive a notification email and can install it by running TestFlight, selecting Breeze Booth for iPad and tapping "update".

Running Breeze Booth for iPad for the first time

Tap on events to go to the events screen and then tap on "Update" in th top right corner to download the demo events from Breeze Systems' server. Ater downloading the event list tap on "< Events" to return to the events screen and you should see a list of events. Swipe right to left on an event and select "Sync" to synchronize the files on the iPad with the server. Tap on "< Events" to return to the events screen after syncing the files. Swipe right to left on the event and tap "Run" to run the event.

Files stored on the iPad

The iOS 11 Files app can be used to view the files used by Breeze Booth for iPad and to copy events and their associated photos to an iCloud or DropBox folder. New event configurations can also be copied to Breeze Booth to iPad using the Files app.

Tap "Browse" in the Files app and then tap om "On my iPad" under "Locations" and you should see a folder named "Breeze Booth". Tap on the folder to pen it and there will be two folders: "assets" which is where the event configuration is stored and "photos" where photos, animated GIFs and MP4 movies captured by Breeze Booth are stored.

Creating your own events

The Breeze Booth Event Editor is a Windows based program which can be used to create and edit events. Please note that this is beta software and will be updated as new features are added.

Breeze Booth for iPad works in a similar way to our Windows based photo booth software. All the settings are stored in XML files and the screens are created using JPEG backgrounds with PNG overlays and animated GIF animations. Profiles are used to load settings from the XML files and provide a way of selecting different configurations. Breeze Booth for iPad can run with the iPad in landscape or portrait orientation and uses a separate profile for each orientation.

Screens should match the aspect ratio of the iPad's display (4:3). The suggested sizes are 2048x1536 pixels for landscape orientation screens and 1536x2048 for portrait orientation screens. The following screens are used by the app:

  • ready.jpg, ready_overlay.png, ready.gif: The ready screen in photo mode. Append the style (e.g. ready_normal.jpg, ready_monochrome.jpg) to the filename to provide feedback when different styles are selected. The style names are normal, monochrome, sepia, comic, filter1, filter2, filter3, filter4, filter5, filter6
  • 1.jpg, 1.png, 1.gif: Screen displayed during the countdown. Use 1.jpg for the first photo, 2.jpg for the second etc.
  • taking.jpg, taking.png, taking.gif: displayed when taking a photo
  • preview.jpg, preview.png, preview.gif: displayed when previewing each photo after it has been taken
  • processing.jpg, procesing.png, processing.gif: displayed while the print layout is being prepared
  • confirm_printing.jpg, confirm_printing.png, confirm_printing.gif: displays the print preview when the user is asked whether to accept or reject the photos
  • share,jpg, share.png, share.gif: displayed when asking the user whether to share the photos
  • standby.jpg, standby.png, standby.gif: standby screen displayed when the booth is inactive. Live view is disabled in standby mode to save power.
  • gif_ready.jpg, gif_ready_overlay.png, gif_ready.gif: The ready screen in animated GIF mode. Append the style (e.g. gif_ready_normal.jpg, gif_ready_monochrome.jpg) to the filename to provide feedback when different styles are selected.
  • gif_countdown.jpg, gif_countdown.png, gif_countdown.gif: displayed during the countdown before capturing an animated GIF
  • gif_capture.jpg, gif_capture.png, gif_capture.gif: displayed when capturing the animated GIF
  • gif_processing.jpg, gif_processing.png, gif_processing.gif: display while preparing the animated GIF for display
  • gif_playback.jpg, gif_playback.png, gif_playback.gif: playback screen displayed when the user is asked whether to accept the animated GIF
  • gif_share,jpg, gif_share.png, gif_share.gif: displayed when asking the user whether to share the animated GIF or MP4 movie

Animated GIF options: append _loop to the filename (e.g. ready_loop.gif) to play the animated GIF in a continuous loop.
By default the GIF will be displayed in the center of the screen. The size and position of the GIF can be modified by appending modifiers enclosed in curly brackets. The h and w modifiers specify the size as a percentage of the screen width or heighta and the l, r, t, b modifiers specify the position relative to the left, right, top or height of the screen respectively. If conflicting modifiers are present (e.g. l and r) the last one will used.
Example: to place a ready.gif animated GIF which is half the width of the screen and 1/4 the way down the screen set the filename to ready_{w50%t25%}.gif (or ready_loop_{w50%t25%}.gif to play it in a continuous loop).

Copying events to the iPad

Method 1: Copy the files to a folder on iCloud or Dropbox that is visible on the iPad. Then use the Files app to copy the files to Breeze Booth for iPad's assets folder.

Method 2: Upload the files to a folder on a web server then go the to the settings screen in Breeze Booth for Ipad and edit the URL for the sync server to point to the folder on the web server. Then use the events screen in Breeze Booth for iPad to sync the events.
Important: This method can only be used with secure servers that have https e.g. https://breezesys.com. It will not work with http URLs.
Sample events are available by setting the sync server to https://breezesys.com/BreezeBooth/sync in the iPad's app settings.

Method 3: Sync via Dropbox. To do this first install the offical DropBox app on your iPad (this can be downloaded from the Apple App Store). Then select "Sign in to Dropbox" in Breeze Booth for iPad's app settings and authorize the app. This will create a "Breeze Booth for iPad" folder in your DropBox "Apps" folder. Next select the "Sync via Dropbox" option and copy the event files a folder named events. Select "Copy output to Dropbox" to copy photos and animated GIFs to Dropbox (this requires an active internet connection).

Download Breeze Booth Event Editor

The Windows based Breeze Booth Event Editor software can be downloaded using the link below. After downloading the software unzip the file and copy it a suitable folder on the computer's hard disk.

Download Breeze Booth Event Editor v1.0 beta 20180527: BreezeBoothEventEditor_v1_20180527.zip

Download a ZIP file of the example events hosted on the Breeze Systems' servers: events.zip

Additional information on syncing events.

Download Breeze Booth Sync Server

The Windows based Breeze Booth Sync Server software allows photos to be printed and output from the iPad to be automatically downloaded to a Windows PC where it can be shared using applications such as Breeze Kiosk. Breeze Booth Sync Server can be downloaded using the link below. After downloading the software unzip the file and copy it a suitable folder on the computer's hard disk.

Download Breeze Booth Sync Server v1.0 beta 20180521: BreezeBoothSyncServer_v1_20180521.zip

Additional information on printing and syncing files to a Windows computer.

More detailed setup information

Additional information on setting up Breeze Booth for iPad is available here: