Introduction to the Breeze Booth Event Editor

This post contains brief notes about the new Breeze Booth Event Editor,  used to create and modify events for Breeze Booth for iPad.

More detailed ‘how to’ notes will be released later.


The Breeze Booth Event Editor is a powerful Windows based program which can be used to create and edit events for Breeze Booth for iPad.

The first beta version of the editor has a basic user interface, which will be given a friendly front end and further features before the full release.

This beta is provided for Breeze DSLR Remote Pro users with experience using profiles. Please don’t be concerned if you don’t find it accessible at this stage.

Do join the beta program and explore Breeze Booth for iPad before using the editor.

At present the easiest way to create a new event is to copy an existing event and edit it.

Files stored on the iPad

You can use the iOS 11 Files app to view the files used by Breeze Booth for iPad and to copy event ‘assets’ (screens, print layouts, profiles etc) to an iCloud or DropBox folder.

Tap Browse in the Files app then 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. (More details can be found   here)

Breeze Booth folders in iOS Files app

Upload the demonstration events from your iPad to the PC you are using to run Breeze Booth Event Editor.

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 version 1.0 beta 20180304

Run Breeze Booth Event Editor

Start the Event Editor, and select Open.

Breeze Booth Event Editor main screen

Load the events by selecting events.xml

Loading events.xml into Breeze Booth Event Editor

Select an event to edit, then Edit event

Selecting the ‘GIF only’ event Breeze Booth Event Editor

This brings up a list of profiles for the event you selected. ‘GIF only’ is a simple event with one profile each for landscape and portrait orientations:

List of profiles for sample event ‘GIF only’ Breeze Booth event Editor

To make changes to a profile select Edit

Photo Booth Settings Screens

The Photo Booth Settings Screen is displayed for the profile you selected. This has four tabs : General, Photos, GIFs, Share. There are layout editors for touchscreen actions, print layout and GIF layout.  More features will be added to these editors in future releases.

Use the editors to customize events; saving your changes will update  settings.xml.

Photo Booth Settings Screen – General

Photo Booth Settings Screen General Tab BBEE

Select Touchscreen actions… to display the Touchscreen actions editor

Touchscreen Actions Editor Breeze Booth Event Editor

Touchscreen actions can be moved and resized. Right click to add and edit actions etc.

Photo Booth Settings screen – Photos

Photo Booth Settings screen Breeze Booth Event Editor (beta)
Print Layout Editor Breeze Booth Event Editor (beta)

Note: This screenshot is from the ‘Photos only’ event as the ‘GIF only’ event does not need a print layout.

Photo Booth Settings screen – GIFs

GIF settings screen Breeze Booth Event Editor

Select Edit Layout to access the GIF layout editor

GIF Layout Editor Breeze Booth event Editor (beta)

Photo Booth Settings screen – Share

Sharing settings screen Breeze Booth Event Editor
Default email for sharing animated GIFs from Breeze Booth for iPad (Breeze Booth Event Editor Beta)


Breeze Booth Event Editor works in a similar way to DSLR Remote Pro and other Windows based Breeze photo booth software.

  • Settings are stored in XML files
  • Screens are created using JPEG backgrounds, PNG overlays & 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 2048×1536 pixels for landscape orientation screens and 1536×2048 for portrait orientation screens.

The app uses the following screens:

  • 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

Don’t forget to save the changes you have made. When you are ready to transfer them to your iPads running Breeze Booth for iPad, you can either

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. It will not work with http URLs.

It’s your feedback which makes Breeze products stand out – please email comments to .

If you find this post useful please share it with others.

© 2018 Breeze Systems Limited


One thought on “Introduction to the Breeze Booth Event Editor”

Leave a Reply