The Settings Section

The Settings section of a player’s configuration profile properties contains its general settings and parameters.

Note: The Settings section is one of several sections of Configuration Profile Properties for players. For general information about configuration profiles, see Configuration Profiles.

The Core tab of Configuration Profile Properties

    • Time Synchronization: Allows you to control how the Broadsign Player synchronizes its time with the Broadsign Server.
        • Do Not Synchronize: No time correction.
        • Keep system time intact: Let the player correct its local clock.
        • Let player set system time: The Broadsign Player actually resets the OS time.
    • Day Part Switch Behavior: Allows you to determine how the player reacts when a day part ends while content is playing.
    • External Saturation Schedule: Allows you to specify the path to the file that will control the saturation values of campaigns in the player.

The Network tab of Configuration Profiles Properties

    • Poll Frequency: Allows you to change a player or edge server’s poll frequency settings, which determine the time interval at which a Broadsign Player or Broadsign Edge Server will poll the Broadsign Server. “20 mins” is the minimum allowable poll frequency. Please note that the Broadsign Player will add +/- 10% randomly to each poll period in order to distribute load.
    • Downloads: Determines whether the player will honour network control time spans when polling, whether it will revert to downloading ad copies from the main server cluster if its edge server is unavailable, and, furthermore, if it will honor network control time spans with respect to downloading content.
        • Fallback to primary server cluster: This setting controls the player’s download behaviour when one or more edge servers are assigned, but the edge servers are unreachable. If fallback to primary is enabled, the player will bypass the assigned edge servers and download directly from the Broadsign server cluster. If it is not enabled, the player will continue to attempt to contact its assigned edge servers.
        • Network Controls: This setting governs whether or not downloads should respect any network control time spans that are in place.
        • Throttling: Both edge server and player configurations can be configured to throttle download speeds to a specific rate in kilobytes per second. This can be used in cases where the player or edge server is on a shared network and bandwidth saturation is a concern.
        • Prioritization: Downloads can also be prioritized according to importance. By default, the Broadsign Player will attempt to download all required content in sequence. However, this might not be an optimal strategy to employ when using a slow connection such as dialup. In this case, a remote configuration can be created that prioritizes future downloads first. A typical example of when this might be useful is when units are deployed mid-month. For example, consider a network which has unique programming each month. When a new player is deployed mid-month, it becomes useful to prioritize downloading of the next month’s playlist over the current month’s. This will ensure that the next month’s playlist will be downloaded in time. In this case, the “Lead Time” value is used to control how far in the future the player should prioritize downloads.

The Geometry tab of Configuration Profile Properties

The geometry tab allows you to control how the player window appears on-screen. Custom geometry is typically used in conjunction with large outdoor LEDs that will only display a portion of the desktop. Alternatively, it can be used to incorporate BSP into an existing application by layering it on top.

The Reporting tab of Configuration Profile Properties

You can configure the player to generate the following types of reports:

    • Incidents: You can enable or disable a player’s capability to report incidents.
    • Statistics: You can enable or disable a player’s capability to report playback statistics.

The Proxy tab of Configuration Profile Properties

When you configure the Broadsign Player to use a network proxy, this tab allows you to configure the exceptions for when the proxy should not be used. A typical example of this is when a player uses an http proxy for communicating to the Broadsign Server and the web. However, it must not use the proxy when communicating with a local edge server or FTP server.A proxy exception can be defined in one of three ways:

    • Hostnames: A hostname exception, for example “”, will allow bypassing of the proxy when the hostname of the request exactly matches hostname defined in the exceptions. Hostnames must be fully valid in order to be accepted.
    • IP addresses: Any IP v4 address, for example “” can be configured as a proxy exception.
    • CIDR Notation: A range of IP addresses can be configured as a proxy exception by using the CIDR notation. For example “” will bypass the proxy for any connection to an IP in the range of –

The Disk tab of Configuration Profile Properties

The Disk tab allows you to configure how a player or edge server uses the hard disk to cache ad copies. You can either set a specific cache size to use in gigabytes, or, you can allow the disk usage to be auto-managed.An auto managed disk will ensure that the entire partition used for caching ad copies retains at least 15% free space at all times. Periodically, the player will check to see if the cache exceeds the specified size. If it does, it will automatically delete the least recently used content found in the player’s document root. When using a static cache size, be sure to allow enough room for the operating system and any files used by other applications.

Broadsign designed location monitoring to be a part of our geotargeting feature.

The player will pull geolocation data from your GPS transponder in one of two ways:

    • Operating system location API
    • Script (provided by you)
Note: Whichever method you choose to communicate geolocation data to the player (via this configuration profile), the end result must be latitude and longitude coordinates.

In this tab, you can configure the following:

    • Enable location monitoring: Select to enable the location monitoring feature.
    • Refresh period (seconds): Set the length of time between the player’s pulls from your GPS transponder. For the geotargeting set-up, we recommend a refresh period of 15 seconds.
    • Use Operating System location: If you opt to use your operating system for geotargeting, you have the following options:
    • Set location with this script: If you opt to use your own script for geotargeting, enter it here.
Using the “Script” Option
Note: If you experience issues with your operating system’s location API, we suggest you use the “script” option. Export it based on your hardware.

If you use the script option, you must output a string to stdout with a JSON document containing lat and lng:

{ "lat":"45.50610628959769", "lng":"-73.70864868164062" }

If your GPS transponder is unable to get a fix from the satellite, for any reason, you must output an empty JSON string:

{ "lat":"", "lng":"" }
Note: The player will continue to use the last valid latitude and longitude it received until you restart the player. In other words, the player will assume that the taxi (in this example) is stationary until provided with new coordinates.

Python Sample (Windows OS)


import json

def main():
  newLat = "-33.207143856288027"
  newLng = "149.843896484374990"
  data = { 'lat': '{}'.format(newLat), 'lng': '{}'.format(newLng) }
  print (json.dumps(data))
if __name__ == "__main__":

BAT File Sample (Windows OS)

@echo off

@echo {"lat": "-33.207143856288027", "lng": "149.843896484374990"}

SH File Sample (Linux OS)


echo "{\"lat\": \"-33.207143856288027\", \"lng\": \"149.843896484374990\"}"