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. http://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.

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 before restarting. If audio modes are changed, a reboot will also 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, including password, so 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

  • links the Player to a Open Broadcaster Duo media management server. The Sync URL should be in the format http://server_ip_address/remote.php or https://server_ip_address/remote.php. 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.

  • Audio/Visualization Tab

     A/V Tab Screenshot

  • Sources Tab
    • 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
  • Output Tab
    • 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 provide for a GPIO Trigger 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. 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 and JACK are both supported audio modes, either will produce sound quality suitable for broadcast. Pulse is the default tool for adjustment of output levels for all installed sound cards in Ver 5.X Series players.

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

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.


Shaded code blocks are commands in the Terminal Emulator:

To change directories:

cd *directory_name* '; 

the tilde ‘~’ denotes the users home directory, ‘#’ denotes a comment or disabled command i.e.

cd ~ # equivlaent to cd /home/obsuser; 

Where sudo is indicated for root privileges, you will be prompted for your user password;

In nano, use CTRL-X to exit the editor; click ‘Y’ when prompted to save changes, and enter to save the 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 Audio Troubleshooting for guidance about the connection definitions.

When using a JACK setup, PulseAudioshould be disabled:

obsuser@obsource:~$ nano ~/.pulse/client.conf

#hashtag denotes a comment.
#to disable PulseAudio:
    autospawn = no
    daemon-binary = /usr/bin/true


The PulseAudio configuration file ~/.pulse/client.conf must be edited to enable use of PulseAudio.

obsuser@obsource:~$ nano ~/.pulse/client.conf

#to enable PulseAudio:
    autospawn = yes

<a name="headless"></a>

#### __Running Headless__

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

Legacy for 4.X Series

For headless operation (i.e. no keyboard/video/mouse), open a Terminal window and edit the grub configuration as follows:

obsuser@obsource:~$ `sudo nano /etc/default/grub`

#Disable the next line for Headless operation #GRUB_CMDLINE_LINUX_DEFAULT=”quiet splash”

#Enable next line for Headless operation GRUB_CMDLINE_LINUX_DEFAULT=”quiet text”

#Enable next line for Headless operation GRUB_TERMINAL=console ~~~~

IMPORTANT After changing grub config, you MUST run sudo update-grub to apply the changes. The computer should now boot successfully without a monitor attached. Use http://player_ip_address:23233 to access the Dashboard over the local network. To control audio output, SSH to the computer (ssh obsuser@player_ip_address) and run alsamixer at the command line. Follow instructions for Basic Setup.


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

Open Server Bugs

Open Player Bugs