How to Install and Register the Spektrix Box Office App

The Spektrix Box Office App is locally installed software that enables your locally installed ticket printers and Chip & PIN / Chip / EFTPOS devices to communicate with Spektrix in the cloud.

The App must be installed on each Windows PC that is connected to a ticket printer or PIN Pad/Chip Reader

Pre-installation checklist

• Is your computer is connected to the internet?
• Is the Box Office App already installed?

To check to see if the Box Office App is installed, follow these steps:

• To check for an existing Box Office App installation, follow these steps:

  1. Click the Start button in your Toolbar. Alternatively, press the windows key on your keyboard.
  2. Type Settings and press enter.

  3. Click Apps:

     

      

  4. Click Installed apps:

     

      

  5. Look for the Box Office App:

     

  If the Box Office App is installed on your computer, you can upgrade to the latest version without having to uninstall. Take a look at How do I Update the Box Office App? for more information.

  If the Box Office App is not installed, proceed through the rest of this article.

What do I need to install and register the Box Office App?

To install, and register the Spektrix Box Office App, you'll need the following permissions:

• Windows Administrator permissions on the PC you're installing the Box Office App on. If you are unsure if you have this, check with your IT team.
   

• Microsoft .NET Framework 4.71 or later installed on your PC. If Microsoft .NET Framework isn't installed or is older than 4.7.1, ask your IT team to install or update .NET Framework.
   

  To check the version of .Net installed, follow the steps in How to: Determine which .NET Framework versions are installed.

  
   

• A Box Office App registration token: A token provided by a user with the General Administrator Role. Once issued, the token is valid for 45 minutes.
  
  Take a look at How to Generate a Spektrix Box Office App Registration Token for more information.

How do I add the Box Office App to the firewall / proxy server / trusted device list?

To register and use the Box Office App, your IT team may need to set exceptions on your firewall / proxy server and trusted device list to allow access. Ask your IT team to set the following::

• *.service.signalr.net on port 443 on your firewall
• Add boxoffice.spektrix.com to your organisation's trusted devices list in your antivirus software

A document providing a technical overview of the Spektrix Box Office App for IT teams is attached to this article.

How do I install the Box Office App?

To install the Box Office App, follow these steps:

1. Download the Spektrix Box Office app from the Software and Driver Downloads article.

    

2. Open your Downloads folder on your PC and run BoxOfficeAppInstaller.msi to start the installation.
   
   

   During installation you may see a Windows User Account Control screen pop up asking "Do you want to allow this app to make changes to your device?" Click Yes to proceed.

   
   
   

3. Once the install is complete you’ll see the App icon appear in the system tray. The icon will be grey with a red exclamation mark:

   
   This means the Box Office App is installed but not registered. Move onto the next section for steps to register the Box Office App.

Once you've installed the Box Office App, proceed to the next section to learn how to register the app.

How do I register the Box Office App?

To register the Box Office App, you’ll need a Registration Token. A User with the General Administrator Role will be able to generate this for you by following the steps in How to Generate a Spektrix Box Office App Registration Token.

WARNING: Each Registration Token is only valid for 45 minutes. If the Token expires, you’ll need to request a new one.

To register the Box Office App, follow these steps:

1. Right click on the Box Office App icon in your system tray. Click Register:

   

    

2. From the Register with Spektrix screen, enter the following information:

   

   • Your Spektrix Client Name: The unique ID used to identify your Spektrix system
   • Computer name: Choose an easily identifiable name, for example, Box Office Left
   • Registration Token: A Token issued by a General Administrator User which is used to register the Box Office App

Once you've filled in all three fields, click Register. If you've filled in everything correctly, you should see the App icon appear green in the system tray:

If you see the grey icon and red exclamation mark, the App is not connected or has unsuccessfully registered:

Take a look at How to Troubleshoot the Spektrix Box Office App.

How do I add devices to the Box Office App?

After you’ve installed and registered the Box Office App, you'll need to select the hardware you're using in the Box Office App. Read How to add Hardware to the Spektrix Box Office App.

How do I update the Box Office App?

When an update is available, the Box Office App will automatically update itself either upon startup or after four hours of inactivity.

The app will turn itself off, update, and then turn back on. 

Before using any device connected through the Box Office App, we advise to allow extra time. This is to ensure the Box Office App is fully updated.

How to manually check for updates

You can manually check for Box Office App updates by following these steps:

1. Right click the Box Office App icon in the system tray

2. Click Check for Updates:

   

    

3. If an update is available, the Box Office App will update and restart

TIP: We recommend checking for updates at the start of the day before serving any customers. This ensures the Box Office App is updated and ready to use.

How do I Uninstall the Box Office App?

Uninstalling the Box Office App is a two stage process:

• Stopping the Box Office App in Windows Services
• Uninstalling the Box Office App

Stopping the Box Office App in Windows Services

Before you uninstall the Box Office App, you’ll need to stop the app in Windows Services. Follow these steps:

1. Click the Windows button in your taskbar. Search for Services and select it.

2. In Services, right click on Spektrix App Service and select Stop:

   

TIP: You can also stop the Box Office App in Windows Task Manager. Right click on BoxOfficeAppGUI (32 bit) and select End Task.

Uninstalling the Box Office App

Once you’ve stopped the Box Office App from running, follow these steps to uninstall the App.

1. Click the Windows button in your taskbar and select Settings
2. Click Apps from the left menu and then select Installed apps

3. Click the three dots next to BoxOffice App and select Uninstall:

   

4. Once the App is uninstalled, browse to C:\Program Files (x86)C:\Program Files (x86) and delete the Spektrix Ltd folder

To reinstall the Box Office App, follow the steps in:

• How do I install the Box Office App?
• How do I register the Box Office App?

• Spektrix App Technical Overview.pdf100 KB