Install Appspace App and Configure BrightSign Devices

This article provides instructions to configure and register BrightSign devices with the Appspace App, and other BrightSign specific configurations such as enable closed captioning, enable text overlay over video, configure BrightSign for 4k Displays etc.

We also provide instructions to manually update the Appspace App and BrightSign firmware, as the BrightSign devices do not auto-update.

Important
  • If you wish to upgrade existing BrightSign devices running the Appspace App to OS version 8.0, the Appspace App must be updated to version 1.46 first, before the device firmware is updated to version 8. This is crucial to prevent the local storage from being wiped off due to the architectural changes on the location of the local storage for BrightSign OS 8.
  • BrightSign devices are unable to update the Appspace App versions automatically. Please refer to the Update Appspace App on BrightSign section below for workarounds.
  • DHCP Option 43 is supported on Appspace App 1.36 and above.

Prerequisites

Configure BrightSign with Appspace App

Follow the instructions below to setup the BrightSign device:

  1. Log in to the Appspace console.
  2. Select the ☰ Appspace menu, and click System > Downloads.
  3. Download the Appspace App for BrightSign client (autorun.zip).
  4. Copy the autorun.zip file to an SSD storage, an SD card, or a USB drive according to your preference. If using an SD card or a USB drive, plug in the devices into the BrightSign device.
    Warning
    BrightSign devices with SSD storage are only compatible with Appspace App 1.33 and above, and BrightSign firmware 7.0.60 is required.

  5. The Appspace App installation package will be automatically extracted to the storage device.
    Note
    The autorun.zip file is automatically deleted from the storage device after the extraction.
  6. Connect the BrightSign device to a display screen.
  7. Ensure network connectivity is active, and switch on the BrightSign device. Wait for the device to boot-up and display the Device registration page.
    Note
    The BrightSign device may need to be restarted a couple of times if the device registration page does not show up.
  8. Launch the Appspace App.
  9.  Register your device.
  10. If using an SSD, once the initial installation and registration process is complete, you may remove the SD card or USB drive, as the Appspace App will operate solely from the SSD storage hereafter.

Enable Closed Captioning on BrightSign

To enable Closed Captioning or subtitles manually, follow the instructions below.

  1. Log in to the Appspace console.
  2. Select the ☰ Appspace menu, and select Channels.
  3. Select the desired advanced channel, and select the Edit tab.
  4. Click the edit button for the layout containing the Media Zone widget.
  5. In the editing window, select the Media Zone widget, and click the Properties button.
  6. Select the Properties tab, and click the Edit button.
  7. Enter in the following widget property:
    Description Widget Property Value
    Closed Captioning / Subtitles custom.media.video.cc Boolean (True or False)
  8. Once done, click Finish.
  9. Select the Appearance tab, and ensure that Background Color is set to the default value of #000000 with the OPACITY of 0.
    You may also click the None button to return to the default value.
  10. Click Apply, and close the window once changes have been made.
  11. Back on the editing window, change the layout Background Color to #010203 with the OPACITY of 100, or edit the following widget property:
     
    Description Widget Property Value
    Change the background color to black standard.bgcolor #ff010203

  12. Click Apply, and Save once done.

Enable Text Overlay over Video

To enable text overlay over video for viewing in interactive mode/channel browsing mode (user mode on a web browser or mobile device), add a device property, while to enable it on a sign channel, add a widget property to the Media Zone widget instead.

Enable Text Overlay over Video in Interactive Mode (Channel Browsing)

To enable text overlay over video in interactive mode on BrightSign devices during channel browsing, add the following device property:

Description Device Property Value
Enable text overlay over video Custom.media.video.layerindex -1: Places the video behind all graphics
0: Disables “hwz” mode completely
1: Places the video in front of all graphics (the default setting)
2: Places the video in front of all graphics, as well as a second video element
For instruction to add a device property, please refer to Adding New Device Properties.

Note
When “hwz” is enabled, the video is rendered as a video element, ensuring the highest possible frame rate and video quality. When “hwz” is disabled, the video is rendered as a graphics element.

Enable Text Overlay over Video in Advanced Channel (sign)

Follow the instructions below to enable text overlay over video in an advanced channel (sign):

  1. Add the following property to your Media Zone widget:
    Description Widget Property Value
    Enable text overlay over video Custom.media.video.layerindex -1: Places the video behind all graphics
    0: Disables “hwz” mode completely
    1: Places the video in front of all graphics (the default setting)
    2: Places the video in front of all graphics, as well as a second video element
    For instruction to add a widget property, please refer to Adding Widget Property.
    Note
    When “hwz” is enabled, the video is rendered as a video element, ensuring the highest possible frame rate and video quality. When “hwz” is disabled, the video is rendered as a graphics element.
  2. Change the advanced channel’s layout Background Color to #010203, and set the Opacity slider value between 1 and 100 (non-zero value).
    Description Widget Property Value
    Change the background color to black standard.bgcolor #ff010203

Configure Device Rotation Settings

In Appspace 7.0 and later, a single playlist channel automatically rotates based on the natural orientation of the device. However, BrightSign  by default, does not have a device orientation setting to support this feature, and instead follows the current, or the last orientation setting of a device.

Note
The default orientation settings for all devices is Landscape.

To play a single playlist channel in the desired orientation, set the device orientation in the BrightSign device settings, as per the following instructions:

  1. Log in to the Appspace console.
  2. Select the ☰ Appspace menu, and select Devices .
  3. Select the desired BrightSign device, and click the Settings tab.
  4. Select the desired Display orientation option.
  5. Click Save.

Configure BrightSign for 4K Display

To display 4K content on BrightSign devices, you will need to modify the main.brs file before installing Appspace App on to the BrightSign device.

  1. Log in to the Appspace console.
  2. Select the ☰ Appspace menu, and click System > Downloads.
  3. Download the Appspace App for BrightSign (autorun.zip) to your computer, and extract the autorun.zip file.
  4. Navigate and open the main.brs file located in the appspace folder.
  5. Locate the “vmCreate Object (“roVideoMode”) line of code, and enter the vm.SetMode(“4096x2160x30p:fullres:gfxmemlarge”) line of code below it.


    Code
    vm=CreateObject(“roVideoMode”)
    vm.SetMode(“4096x2160x30p:fullres:gfxmemlarge”)
    m.width=vm.GetResX()
    m.height=vm.GetResY()
  6. Once done, save the main.brs file and repackage it back to the autorun.zip file.
  7. Proceed to configure your BrightSign device with the modified autorun.zip file.

Update Appspace App on BrightSign

Note
This is applicable to Appspace App version 1.13 and above.

To ensure the Appspace App is updated on all supported BrightSign devices in the network, follow the instructions below:

Prerequisites

  • Ensure the network allows devices to be updated.
    How To
    1. Navigate to Devices in the ☰ Appspace menu, and select the Networks > Properties tab.
    2. Ensure the Software.SoftwareUpdates device property value is set to TRUE.
  • Ensure the BrightSign device is configured to receive updates automatically.
    How To
    1. Navigate to Devices in the ☰ Appspace menu.
    2. Select the desired BrightSign device, and click the Settings tab.
    3. Ensure the Software updates option is set to Automatic Update.

Update Appspace App

Follow the instructions below to manually update the Appspace App: 

  1. Log in to the Appspace console.
  2. Select the ☰ Appspace menu, and navigate to System > Downloads.
  3. Download the latest Appspace App for BrightSign package, and save it to a hosted folder.
  4. Navigate to Device Tasks in the ☰ Appspace menu, and click the Advanced Tasks tab.
  5. Click the ADD button, and select the Appspace App : Brightsign App Updater task.
  6. Configure the advanced task, and deploy it to the network where the BrightSign devices are registered.
  7. Click Save.

Update BrightSign Firmware

Follow the instructions below to manually update the BrightSign firmware: 

  1. Download the BrightSign firmware of your device from the BrightSign Downloads site at: https://www.brightsign.biz/downloads/overview
  2. Extract the BrightSign firmware .zip file.
  3. Copy only the .bsfw file and paste it in a folder on the local web server.
  4. Right-click and compress the .bsfw file.
  5. Log in to the Appspace console.
  6. Select the ☰ Appspace menu, and navigate to Admin > Device Tasks.
  7. Select the Advanced Tasks tab.
  8. Click the Add button, and select the Appspace App : Device Firmware Update task.
  9. In the Common Parameters section, enter in the URL to the BrightSign firmware package on your local web server (from Step 3 above).
  10. In the Deploy To section, select the desired network to deploy the task to.
  11. In the Schedule section, select the desired deployment option.
  12. Click Save.

Related Articles