Using the Player

Player configuration and status monitoring is accomplished using a Dashboard interface. The Dashboard is available in a web browser, on port 23233 of the localhost IP address (i.e. //localhost:23233). In headless mode, the Dashboard is accessible using the local area network address of the Player (e.g. // For access to the Dashboard from outside the local area network, contact your network administrator to setup port forwarding on your router..

The Admin user can change configuration settings of the Player as required for activation in a broadcast setting. The changes that are required in each case are reviewed in Getting Started. Additional settings for each tab are reviewed on this page.

NOTE: Be sure to Save any changes on each Tab, waiting for a green confirmation message then restarting with the Quit button to take effect. If audio or video modes are changed, a reboot will be required.

Dashboard Navigation

  • Status Tab

     Status Tab Screenshot

    • displays real time information for the current state of the Player. If audio signal is present, a signal level indicator will respond to output from both audio channels. All system operations are displayed on a real time Log displayed on the Status Tab.
    • provides detailed logging by viewing the Debug log. The Debug log displays all CAP alert messages received by the Alert Player, before local filters have been applied. The status log will indicate status of connections to the NAAD server(s); only those alerts matching the SGC filters will actually be played

Log Colours

  • Normal system operation Green Text.
  • Player and Now playing Green Text.
  • Schedule sync Teal
  • Downloading Media Orange Text
  • CAP XML Alerts received Lime Green Text (Only in Debug mode).
  • CAP Alert playout and NAAD connection Magenta Text.
  • Warning and advisory Olive Text
  • Media DB sync Medium Blue Text
  • Admin Modules and System Black Text
  • Data Command and Control Dark Grey Text
  • Network Error, Authetication failure and broken links Red Text

  • Summary Tab

     Summary Tab Screenshot

    • displays all current configuration settings.
  • Admin Tab

     Admin Tab Screenshot

  • is visible to the Admin user only. Advance Settings control visibility of Tabs for Read Only user access.

  • Export or Import settings to save or restore the configuration, if necessary. To create a backup of the configuration export the settings. To restore a configuration, import the settings file. Configuration settings are output in plain text form, excluding passwords. This file should be kept in a secure location.

  • The current settings may be exported as a text file from the Admin Tab Settings file and passwords Passwords will not be exported or revealed. Restoring the settings file will reset the player dashboard passwords to default (admin) retaining the created user account. Once the player has been restored, simply login with the user and default password and change in the Admin tab to your desired password.

  • Reset to Defaults will restore the default configuration. Current configuration parameters will be overwritten, but may be restored from the backup settings file.

  • Update Player allows the user to confirm the installed Player version, check for updates to the Player software, and if desired, retrieve and install the updates. Changes will not take effect until the Player is restarted.

  • Sync/Media Tab

     Syn/Media Tab Screenshot

  • The Sync URL should be in the format http://server_ip_address/remote.php or https://server_ip_address/remote.php, Device ID and Password should match what was entered in server to provision player. These settings are ignored if Sync/Media settings are disabled such as configured for standalone alerting operation

  • Fallback Media in Player

     Fall Back Media

  • Obplayer loads Fall Back Player on startup that checks to see whether something is playing or about to play. If nothing is playing and nothing is about to play, because of missing or corrupted media, a missing DPL or blank schedules obplayer has the intelligence to locally play from the “Fall Back Media” directory so no dead air.

  • In the player dashboard under Sources enable and place media into location specified as Fall Back Media. Auto scans sub folders created to separate audio, image, video media. Fallback media directory items are played at random, all items will be played before any media items are played a second time. Default is 15 Seconds for image display.

Not applicable for standalone CAP Alerting

TIP Set up with Polka music in Fall Back directory. Hearing Polka, indicates something is up with player that needs investigating.

  • Sources Tab

     Sources Tab Screenshot

    -Audio Input Mode, External Sources and enables pass-thru of Line-In

    • Fallback Player Settings Enables and secifies file location
    • Image Display Settings Slideshow display of image media

  • Outputs Tab

     Outputs Tab Screenshot

    • Audio Output Settings Selects mode and Enable Audio Logging
    • Video Output Settings Enables Output Mode and Resolution
    • Video Overlay Settings Enables crawl of Alert messages across display
    • LED Sign Settings Configures serial LED signage
    • Enable Test SignalTurns on/off the 440Hz test signal

  • Streaming Tab

     Streaming Tab Screenshot

    • Streaming of player output (audio and video) using Icecast configuration
    • RTP\Livewire Multicast Streaming to AXIA Digital Consoles
    • YouTube Live Channel Streaming

  • Location Map Tab

     Location Tab Screenshot

  • establishes geopgraphic coordinates for an installation. Coordinates are reported back to an Openbroadcster Duo server, if Sync is enabled

  • HTTP(s) Admin Tab

     Security Tab Screenshot

  • global language

  • admin user password

  • readonly user and password

  • Live Assist

     Live Assist Tab Screenshot

  • setting the HTTP port to enable interactive DJ/Jukebox interface

CAP Emergency Alert Player

  • Emergency Alerts Tab

     Alerts Tab Screenshot

    • enables the Player to receive and broadcast Alert Messages. Please refer to the National Public Alerting System Common Look and Feel Guidleines for more detail on specifications and recommended practices relating to public alerts.

    • configures Primary and Secondary Language options for the eSpeak engine from a selection of mbrola voice synthesizers

    • adjust the Alert Repeat Interval time between repeated plays of queued alert messages. Setting this value to 0 will cause an alert message to play until the Expiry time stated within that message has passed

    • provides a Truncate Long Alert Messages setting to shorten long alert messages to include only the first section (Applies only to Moderate advisories)

    • provides an override to Play Moderately Severe Alerts that do not have a Broadcast Immmediate status

      Advanced Settings

  • GPIO Trigger provide for a RS-232 Port to issue a DTR serial signal upon commencement of CAP-CP Alerts. When an alert cycle starts, the serial port will be opened and the DTR control signal (positive pin voltage) will be transmitted on Pin #4 of a common DB9 connector. After the alert cycle has completed, the DTR signal will drop (negative pin voltage). Lead-in Delay timings may be adjusted to prevent ‘clipping’ of messages.

  • Trigger Icecast Stream on Alerts creates an on demand mountpoint

  • Lead in/Out times used with a streaming service to allow entire message to not get cut off while buffering

  • Play Test Alerts These are not scheduled test of the alert systems, but internal system test not normally heard by public (Default = Off)

Location Geocodes

A Standard Geographical Classification uses a numeric code to identify discrete areas, based on census districts. Use the map below to find SGC codes in your area. Use a comma to separate multiple SGC codes as a list (without spaces). For example, the town of Haines Junction (Yukon) is “6001018”; the village of Tagish (Yukon) is “6001036”. To include alerts affecting both districts, “6001036,6001018” would be entered into the textbox. Alternatively, entering “6001” would capture both districts, as well as any others in the immediate locale. Alerts will be filtered to include only those that match, contain, or are contained by the set Alerting District.

Advanced Topics

Audio Settings

Pulse](#pulse) is the default tool for adjustment of output levels for all installed sound cards in Ver 5.X Series players. Pulse and JACK are both supported audio modes, either will produce sound quality suitable for broadcast.

Setting Audio Mode to Pulse and restarting will bring up a slider control in dashboard to control signal levels

Running Headless

Ver 5.X player runs headless by default (no desktop required)

Backend Troubleshooting

Files containing user and machine settings are located in the .openbroadcaster folder within the users home directory. The Admin Tab provides utilities for backup and restoration of user settings.

The data.db contains a copy of media scheduled for the period identified by the sync buffer (default 24 hours). Delete data.db and Restart to purge the Player and force a refresh of the database, schedules and media according to the current sync settings. Useful when changing backend services.

settings.db contain the player settings in an sqlite db. Lost passwords may be recovered by editing this file.

Legacy Audio for Ver 4.X Series

JACK Audio

JACK uses port names openbroadcasterout and openbroadcasterin respectively, with a configuration to maintain the connection state. ALSA Mixer may be used to control output levels when using Jack, however adjustment of input levels ( e.g. for line-in source) requires jack-mixer, and modification of the setup. See Troubleshooting for guidance about the connection definitions.

When using a JACK setup, PulseAudioshould be disabled:


Find a bug ? Have a feature request?
We really appreciate your feedback!

Open Server Bugs

Open Player Bugs