Breeze Booth for iPad - Printing, sending emails and texts and saving files to a Windows computer

Breeze Hub is Windows based software that allows photos to be automatically printed and shared by email and text. The output from the iPad is automatically downloaded to a Windows PC where it can be shared using applications such as Breeze Kiosk or dislayed as a slideshow using BreezeViewer.
Breeze Hub 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 Hub v1.0 beta 20181115: BreezeHub_v1_20181115.zip
Please note that this is a time limited beta that won't run after the end of February 2019.

Setup

Run Breeze Hub on the Windows computer. The main window displays a list of connected iPads, their IP address, the screen they are currently displaying and their id. The log area in the main window shows a list of files downloaded from connected iPads, printing and other status information.

Breeze Hub main window

Select "Printer setup..." from the "File" menu to setup the printer. Then select "Preferences" from the "File" menu to setup the server and the printing preferences:

Breeze Hub preferences

Set the server name to identify the server. This will be displayed in the App Settings screen on the iPad. The default is the token {computerName} which is the name of the computer it is running on.

Set an optional password if you require additional security for files being downloaded from iPads. If a password is set the same password has to be entered on each iPad in the "App Settings". The password is used to sign each file that is sent by Breeze Booth for iPad and Breeze Hub will refuse to accept the file if the password is incorrect. Please note the actual password is not sent with the files. Instead the iles are signed using the password. This means that the password cannot be stolen if the system is running on an insecure network. Breeze Hub will only accept JPEG photos, GIF files, MP4 movie files or XML files. All other file types are rejected.

Breeze Hub uses three internet ports for communicating with connected iPads:

  1. Broadcast port: this is used to send UDP broadcast messages to tell iPads about the server. The default port number is 5500. You may need to configure the firewall software on the computer to allow UPD outward messages on this port
  2. Status port: this is used to receive UDP status messages from iPads connected to the server. The default port number is 5501. You may need to configure the firewall software on the computer to allow UPD inward messages on this port
  3. Sync port: this is used to receive files from iPads connected to the server. The default port number is 5502. You may need to configure the firewall software on the computer to allow TCP inwards messages on this port

The download folder specifies where the downloaded files should be saved. The default setting is {documents}\Breeze Booth for iPad\{ipadName}. The tokens enclosed on curly brackets are replaced with the actual values when the files are downloaded. {documents} is replaced with the path of the Documents folder for the current login e.g. C:\Users\Chris\Documents. {ipadName} is replaced with the name of the iPad sending the file. Please take care to only use characters that are allowed in Windows filenames when naming the iPads if you use the {ipadName} token i.e. avoid using < > ? * / \ : | "
Tip: If you are running an event with multiple iPads and want to share the photos using sharing software running on the PC you may wish to remove the {ipadName} from the download folder path and replace it with the event name so that the photos from all iPads are downloaded to the same folder.

Automatically Printing Photos

Select "Print photos" to automatically print photos when they are received. The number of copies to be printed is read from the XML summary file received from the iPad. The summary file has a similar format to the summary files from our Windows based photo booth applications.
The print layout is automatically rotated to match the printer's page orientation before printing. Select the "Resize prints to fill page" option if the prints are smaller than the page size. Select the "Auto bleed" option if the prints have colored borders. This will extend the borders of the print to fill the printable area when printing to avoid possible white margins caused by the printer heads not being perfectly aligned.

Select "Don't print if print quota used" to only print the number of prints set up in the event info. Each time Breeze Hub prints a a photo is decrements the print counter and when this reaches zero Breeze Hub won't print any more photos if "Don't print if print quota used" is selected. The print counter is the same print counter that can be shared with DSLR Remote Pro and other apps from Breeze Systems. Breeze Hub broadcasts the current value of the print counter to connected iPads and they can access it using the {printCounter} token.

Automatically Emailing and Texting

Breeze Hub can automatically send emails and SMS text messages using the email addresses and phone numbers entered in the iPad app's sharing screens. The iPad saves the email and text messages in XML files (with email_ or text_ prefixes) and Breeze Hub can send them automatically when they are downloaded to the PC. Select "Send emails" to automatically send emails and "Send texts" to automatically send SMS text messages.

Setting up emails

Select "Send emails" and then click on "Settings..." to set up your email settings:

Breeze Hub email settings

To send an email you need to specify the host name and port number of your email server. Most email servers also require a username and a password to prevent unauthorized users from sending spam emails. The port number should normally be set to 587 when using SSL secure email or 25 otherwise (please check the port numbers used by your ISP). Set the "Email addr:" to the sender's email address. To include the name of the sender with the email address enter it as the name followed by the email address enclosed in angle brackets e.g. "Acme Photo Booth <photobooth@acme.com>". Most free email services require the sender's email address to the be the same as that of the email account specified by the username and password.

Check the email settings by entering an email address and pressing the "Send test email to:" button.

Please note: If you are using Google GMail to send emails you need to go to your Google account settings and set the "Access for less secure apps" option to "Turn on" otherwise GMail will refuse to send the email. Google limit the number of emails that can be sent from a GMail account to 100-150 emails in a 24 hour period which may not be enough for photo booth usage. If this is a problem please consider using a dedicated email service such as Postmark or SendGrid.

Finally, set the "Base folder (Scan XML files in this folder and subfolders)" to the location where the files are downloaded from the iPads. Normally this is the same as the "Download folder" specified in the "Preferences" dialog.

Setting up texts

Breeze Hub can send SMS text messages using using a web-based service called Twilio (www.twilio.com). To make the most of this you need to upload the files to a web site and include the URL in the SMS message. The paid for version of Breeze Booth for iPad will offer microsites to display photos, animated GIFs and movie files and allow users to share them on Facebook and other social media sites directly from their own devices.

To use this service you need an account with Twilio and enter your Twilio account details in the "Text Message Settings" dialog. Twilio charge for each MMS or SMS message sent using their service. Please see their website for pricing information.
The SMS settings need to be setup so that the program can send the texts via Twilio. The "Text Message Settings" dialog can be opened by selecting "Send texts" and clicking on the "Settings...":

Breeze Hub SMS settings

Enter your Twilio message phone number, AccountSID and AuthToken in the "Text Message Settings" dialog. You can find your Twilio message phone number, AccountSID and AuthToken by logging into your Twilio account.

Set the country prefix to your country prefix e.g. +1 for the US and Canada, +44 for the UK, +49 for Germany etc. When users enter their cellphone numbers they can either enter the number with their country prefix e.g. +1234567890 or without it e.g. 023456789 and the country prefix will be added automatically before sending the text.

Finally, set the "Base folder (Scan XML files in this folder and subfolders)" to the location where the files are downloaded from the iPads. Normally this is the same as the "Download folder" specified in the "Preferences" dialog.

Sending Event Info

Breeze Hub allows Breeze Booth for iPad to use the same event info as other apps from Breeze Systems. Event information can be defined and used in filenames, captions and the messages used when sharing photos. The information is saved in the Windows registry so that it may be shared with other applications and is read from the Windows registry before it is used so that it can use information supplied by other applications. The "Photo Booth Event Info" dialog can be displayed by selecting "Event info..." from the File menu:

Event info

The event info can be used in filenames , caption text in print layouts or in the message text used when sharing photos by using the tokens below. The information is also saved in the Windows registry using the registry key so that it can be shared with other applications:
HKEY_CURRENT_USER\Software\BreezeSystems\Event Info.

Please note: Do not use the characters \ / : * ? " | < > in the event info if it is going to be used to define filenames. Windows does not allow these characters to be used in filenames and this may prevent the files from being saved.

Item
Token
Registry value
Event Name
{eventName}
HKEY_CURRENT_USER\Software\BreezeSystems\Event Info\EventName
Event String 1
{eventString1}
HKEY_CURRENT_USER\Software\BreezeSystems\Event Info\EventString1
Event String 2
{eventString2}
HKEY_CURRENT_USER\Software\BreezeSystems\Event Info\EventString2
Event String 3
{eventString3}
HKEY_CURRENT_USER\Software\BreezeSystems\Event Info\EventString3
Event String 4
{eventString4}
HKEY_CURRENT_USER\Software\BreezeSystems\Event Info\EventString4
Event String 5
{eventString5}
HKEY_CURRENT_USER\Software\BreezeSystems\Event Info\EventString5
Print Counter
{printCounter}
HKEY_CURRENT_USER\Software\BreezeSystems\Event Info\PrintCounter

The values of the event name, event strings and printer can be displayed in the iPad app by tapping on "App Settings".

iPad Settings

Tap on "App Settings" in Breeze Booth for iPad's start screen to set it up to send files to Breeze Hub for printing or sharing:

Breeze Hub main window

Select "Connect to Breeze Hub" and check that the "Breeze Hub broadcast port number" is the same as the sync port setup in Breeze Hub. The default port number is 5500. If Breeze Hub is running on a computer on the same network you should see appear on the Breeze Hub line. If it shows <none> please check that the iPad and computer running the server are connected to the same network and check the firewall settings on the server computer.

If a password has been set in Breeze Hub the same password needs to be entered in the "Server password" field on the iPad otherwise the server will refuse to accept the files.

Select "Copy all output to Breeze Hub" if you want all output including animated GIFs and MP4 files to be sent to Breeze Hub. This is useful if you wish to use sharing software such as Breeze Kiosk to share the output from the iPad via email, text, Facebook or Twitter on the Windows computer. When the "Copy all output to Breeze Hub" option is not selected only the photos, print layout and XML summary file will be sent to the sync server.

Updating firewall settings on the Windows computer

In order to use Breeze Hub you may need to edit the firewall settings on your computer:

  1. If you don't see Breeze Hub in Breeze Booth for iPad's "App Settings" you may need to enable outgoing UDP packets on the sync port (default setting: 5500)
  2. If you don't see the iPad listed in the "Connected iPads" display in Breeze Hub on the Windows PC you may need to enable incoming UDP packets on the status port (default setting: 5501)
  3. If files are not transferred to Breeze Hub you may need to enable incoming TCP packets on the sync port (default setting: 5502)

The settings will depend on the firewall software that is running on the PC. Please see the help files for your firewall for information on how to configure the settings. Sample settings for WIndows Firewall and AVG are shown below.

Sample Windows Defender firewall settings
Sample firewall settings for Windows Defender firewall

Sample AVG firewall settings
Sample firewall settings for AVG firewall

Additional information

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