obplayer

Media Player

Using the Player

Player configuration and status monitoring is accomplished using a Dashboard interface. The Dashboard is available from any web browser, on default port 23233 of the Localhost IP address. 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 as a standalone player. OBPlayer can also be managed by a OBServere reviewed Quick Start.

Be sure to Save any changes on each Page, waiting for a green confirmation message then restarting with the Quit button to take effect. If audio or video hardware modes are changed, a reboot is recommended.

Dashboard access is for first time setup and advance troubleshooting. Once the Player is setup and configured it is typically entirely command and controlled from a managing OBServer.

Main Status

Status Page 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 Page.

Log Level

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, Authentication failure and broken links Red Text

Downloads

Status Logs Text\CSV

  • Daily Playlogs

  • Daily Alerts Log

Audio Logs MP3

  • On Board Audio Logs

  • Off-air Audio Logs

  • SDR Audio logs

Local Audio Streams

Mount points generated for Icecast monitoring enabled in the dashboard.

  • Main Mount Point

  • STL Mount Point

  • Off-Air SDR

  • Live OverRide


Administration

 Admin Menu

Admin Menu is visible to the Admin user only.

Delete DB and Restore deletes the Player DB that contains schedules. Deleting this and restart forces a sync for new media and schedules. This doesn’t delete the settings of player.

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. Preconfigured installations may be deployed using settings files.

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 page 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.


Audio and Video Outputs

 Outputs Page

Audio Output Settings modes available to Select:

  • Alsa
  • ESound
  • JACK
  • OSS
  • Pulse
  • No Audio - good for players in studio that do not want onboard audio coming out of built in speakers

Enable Audio Logging records one hour files available via Admin>Downloads

Video Output Settings Enables Output Mode

  • X11
  • Xvideo
  • OpenGL
  • EGL/GLES
  • Wayland
  • Coloured ASCII - Set this mode on CATV for fundraising drives
  • No Output

Video Overlay Settings Enables crawl of Alert messages across display

LED Sign Settings Configures serial LED signage

Enable Test Signal Turns on/off the 440Hz test signal

Video output Resolution is automatically detected and displays values when video mode is enabled after restart.


Audio and Video Sources

 Sources Page

Fallback Player Settings Enables and specifies file location of Fall Back Media. Fallback media directory and sub directory items are played at random, but all items will be played before any media items are played a second time. Default is 15 Seconds for image display.

AoIP Input Settings to specify AoIP Source URI

RTP/Livewire Audio Input Settings sets values for: RTP Input, RTP Input Port and Multicast Address

Select Audio Encoding Format: OPUS, 16-bit PCM or 24-bit PCM (Livewire)

Audio Clock Rate 48000 Hz or 41000 Hz

Enable RTCP Real-time Transport Control Protocol

Enable Audio Input Settings External Sources and enables pass-thru and capture of Line-In

Audio Input Mode

  • Alsa
  • ESound
  • JACK
  • OSS
  • Pulse
  • No Input

Disable When Silence Is Detected

Prioritize Above Scheduler When source is detected on Lin In, to play that. . Silence/Signal Threshold (dB) When to trigger switch over for detecting line in

Time Before Enabling Input and Disabling Input(s) Time Before Enabling\ Disabling Input (s) after it detects silence before it enables\disables the input.

Enable Audio Input Logging Records one hour segments into ./openbroadcaster and accessible via Admin>Downloads

Image Display Settings Slideshow display of image media and overlay


HTTP(s) Admin

 Security Page

Set Global language

Change Admin user password

Set up Read only user and password

Allow read only user to access restarting through dashboard

Set Text to display in browser Tab and Bookmarks Shortcut


Live Assist

 Live Assist Page

Enable Live Assist

Set HTTP(s) port (Default = 23456) to enable interactive touch screen interface

Specifying Microphone and Monitor sources

More info on using LIVE Assist Here


Location Map

 Location Page Screenshot

Establishes geographic coordinates for an installation. Coordinates are reported back to an OpenBroadcaster Server, if Sync is enabled to display players and status on a geo map using the Geo Mapping Module.


Summary Page

 Summary Page Screenshot

Displays all current configuration settings and additional info; Current Version\Branch, GPS Coordinates and Local Time.


Sync/Media

 Sync/Media Page

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

Media Sync Mode

Remote stores media under ./openbroadcaster

Backup stores media locally or shared in a specified directory

Local is used to access media library that is on the same machine as player

Backup Downloaded Media saves and caches a copy so it doesn’t get downloaded reducing bandwidth.

Maintenace Mode toggles the scheduled material and puts player into lockdown mode with Fall Back Media to set audio levels.

Disables the scheduler’s request queue, so the core player loop will ignore any requests from the scheduler. The next highest priority request generator will take over. If a higher priority request comes in from the alert module, it will play the alert request. The feature will only affect the scheduled content. It’s not quite the same as disabling the scheduler module, since it will still sync media and attempt to schedule content, but it will be ignored by the core player as if the scheduler module was disabled.


Streaming Media

 Streaming Page

Icecast Streaming

Main streaming mount point

 Icecast Configuration

Streaming of player output (audio and video) using Icecast

Audio Input Mode

  • Intersink - Bypass processing and sends the source material direct to Icecast server

  • Pulse Audio - Use this mode if you wish to fine tune input and output levels

  • Alsa

  • Jack

  • OSS

  • No Input


Allows creating a separate feed at a different quality to be sent to a STL. ie Stream 1 sends to outside relay server at 128 KB while the STL Stream 2 sends to transmitter at 320K on internal network.

RTP Livewire Multicast Streaming

 RTP Livewire Multicast Streaming

Send and receive AoIP to RTP devices and AXIA Digital Consoles.

Enable RTP Streaming

Specify the multicast address

Select Encoding Format; 24-bit PCM Livewire, 16-bit PCM, Opus and Mp3


YouTube Live Channel

 YouTube Streaming

Create LIVE YouTube channel

  1. Enable YouTube streaming

  2. Enter your secret YouTube key to authenticate

  3. Output Mode supports encoding rates 240p - 720p

Restart player and begin streaming!


CAP Emergency Alert Player

Emergency messages issued from NAAD (Pelmorex) may be issued as a string of text, digital audio file and/or with an included graphic image. These will automatically be received and broadcast with our systems. In the event the attached alert is missing or corrupted, relayed from Environment Canada or issued using a text source, your system will play the audio using built in TTS(text-to-speech). For video installations it will also display a scroll along bottom of screen and/or a full screen red slide with descriptive text and accompanying audio alerts.

Alert messages will continue to broadcast at the Alert Repeat Interval until the Alert expiry time is reached or when the NAAD sends a command to terminate playing of message. Broadcast Intrusive alert messages are required to play at least once. To limit the number of repeats of an Alert message, it is possible to change this setting.

Please refer to the National Public Alerting System Common Look and Feel Guidance Ver 2 for more detail on specifications and recommended practices relating to public alerts.

Heart Beats

 System Heart Beats

Pelmorex sends out keep alive heart beats that our player monitors to ensure connectivity to receive alerts. A stable internet connection must be available to receive heart beats and CAP alert messages.

Pro Tip In the Admin menu set Log Level to only show heart beats and alerts.


Location Geocodes

In Canada, a Standard Geographical Classification uses a numeric code to identify discrete areas, based on census districts. Alerts will be filtered to include only those that match, contain, or are contained by the set Alerting District.


CAP Alerts Configuration Page

 Emergency Alerts Page


Initial Setup

Emergency alerting dashboard is built into OBPlayer and configured in the dash board Emergency Alerts.

For initial setup, disconnect any USB audio device before powering up the unit, and use the internal green speaker/headphone jack to monitor audio output for testing. Do not setup and provision unit on air in a production environment until it is understood how it works.

Open the Dashboard to configure and ensure Emergency Alerts are enabled

Set Alerting Locale

A single SGC Geocode is required for your alerting locale. In the Location Geocode window, simply enter your region’s name and a current list with the SGC code will display. Multiple region SGC geocodes may be used and separated by commas eg: “6001036,6001018” would play alerts for both Tagish AND Haines Junction. Entering “6001” would capture both districts, as well as any others in the immediate locale.

Set TTS (Text to Speech)

Select and configure Primary and Secondary Language options.

  1. Onboard TTS - Mediocre quality at best (recommended to change on first setup)

  2. ESpeak Mbrola Voices - Not much better quality as above, but an improvement. Select Language i.e. English then associate MB-en1 as primary language voice. Select French and primary voice of MB-fr1

POLLY AI Voices

Best possible solution for TTS. Sounds very natural. Configured and enabled, when a valid CAP message is recieved, the text of this message is sent to AWS and produced as an mp3 file, sent back for airplay.

1) Select Enable AWS POLLY enter the API key into the advanced menu in Admin. Restart player.

 Advanced Polly API Key

2) Emergency Tabnow displays a selection of bilingual male and female voices to choose from: Joanna, Matthew and Chantal (more to come)

 Polly Voices

Obtaining AWS Polly Key

You’ll need an API key from Amazon Web Services (AWS) using a free plan. If running a large network of POLLY devices, there is a very small fee to use this service, approx 4.00 USD for one million characters for thousands of hours of spoken word.

Register at AWS POLLY

Go to Identity and Access Management (IAM)

Create User with Access type = Programmatic access

Attach existing policies directly by scrolling through list and selecting with a check box AmazonPollyReadOnlyAccess

Add POLLY policy to user

 AWS Management Console

View POLLY service attached to user

 AWS Management Console

View API Key. It has 3 parts

Export User Key

After creating user and attaching policy you will be able to generate the Key. A single use menu will appear allowing you to copy and paste the keys and/or download link a small csv file with credentials for backup. Download this file and stash securely. If AWS key is lost or cannot remember, simply generate a new one

AWS Region should be set to the data centre closest to player.

Once you enter the key and enable Polly, restarting player will populate the alerting voices with available voices.

 AWS User Key


Advanced Settings

 Advanced Emergency Settings

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

Use the Play Moderately Severe Alerts setting to enable optional, non-broadcast intrusive alert messages, if desired. Provides a setting to Truncate Long Alert Messages to shorten long alert messages to include only the first section To play the entire CAP alert, including the entire lengthy description, disable the Truncate Long Alert Messages setting .

Provides an override to Play Moderately Severe Alerts that do not have a Broadcast Immediate status

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) Note: These alerts are not related to scheduled tests from Pelmorex.

Purge Saved Alerts after 90 days will free up your disk space, even more of a concern now with the large multimedia attachments being sent along with the CAP message.

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 and Lead-out delay timings may be adjusted to prevent ‘clipping’ of messages.

Trigger Icecast Alerts is used to generate an on demand Icecast mountpoint.

Logging of Alerts shows the count of played alerts; broadcast intrusive, moderate advisories and self generated tests. This can also be downloaded from the Admin main menu.


Injecting CAP Alerts into the broadcast chain

Every station is setup different with several ways to inject audio and visual alerts into the broadcast chain. CAP alerts are received and authenticated by the standalone alert player and put into the broadcast chain each with their own merits, listed below in no particular order.

Audio

When an alert is received, audio is sent out for your systems to receive in several ways. Generally there is no audio present unless a message is being issued; either a valid CAP message, Pelmorex test message or when a internal test alert is issued.

• Onboard analog stereo 1/8” mini output using Realtek ALC888S codec. Audio present only when a valid CAP message is being broadcast.

• GPIO trigger reverses DTR voltage on pin 4 using RS232 DB9 when CAP message is played to switch an External relay.

• Using BARIX exstreamer at transmitter to listen to a priority port of incoming stream of CAP message

• Configuring ICECAST server to detect new mount point of on demand stream

• Silence Detection using external third party hardware used to sense audio coming out of the Alert Player and mechanically switch a relay on your board.

• Windows playout machine may use free Silence Detection software from Pira CZ Silence Detector to switch broadcast audio source when CAP message is played.

• Integrating to AXIA Digital AOIP Consoles to sense an on demand Livewire stream of CAP message in conjunction with the Qor’s GPIO to switch channels on the console while EAS is in progress and switch back.

CAP Alerts with Barix Exstreamer

OBPlayer creates an on demand IceCast mount point when an alert is present with a Barix Exstreamer receiver at transmitter to play CAP alerts. Stations normally will be supplying audio to Exstreamer at transmitter. Barix will be configured to detect and automatically switch to the generated alert mount point the new mount point stream, cut over and play alert, switch back to normal programming when alert stops.

Prerequisites

In order to make the priority streaming work, so that OBPlayer only outputs the alerts and nothing else; disable the scheduler, fallback player, audio in, and the test signal.

Configure OBPlayer

Streaming Page Create a mount point on local machine’s IceCast server. Exstreamer will switch to the generated alert mount point and switch back when it stops. There is a minor delay in the switching with Barix Exstreamer. Set the lead-in delay to 1 second and the lead-out delay to 5 seconds to catch the whole alert cycle without having too much delay before and after.

Barix Configuration Set the first URL as priority for the alert stream. Second URL is set to the normal stream coming from the studio.

When a CAP message matches your region, a mount point will be temporarily created, overriding your studio. When the alert is finished playing, normal programming from your studio will resume.

GPIO Audio Relay

If using the GPIO switching Relay, connect a serial cable from the Player to the Switching Relay. On the Emergency Alerts tab, under Advanced Settings, enable the RS-232 DTR Alert signal.

Visual

Applicable for; over the air TV, Cable TV and digital signage applications. Normal visual content will be displayed. When there is a valid CAP alert, a red scrolling overlay will display the text of message with accompanying audio of the alert. Graphis sent as attachments will display full screen if present.

• Onboard local video with (HDMI\DP\DSUB) where an overlay will be displayed when a valid CAP message is being broadcast.

• GPIO trigger on pin 4 (high) using RS232 DB9 when CAP message is played to switch CATV channel on digital cable head end.

• Configuring ICECAST server to detect new mount point of on demand stream of CAP Alert

Test Alerts

We offer several ways to test and set levels.

Self Generated Test Alerts

To confirm that Alert messages are working correctly, select one of the four sample valid CAP messages:

  1. Simple Test. Generates an internal CAP formated message and plays using TTS
  2. Embedded Audio Test. Generates an internal CAP message and plays a supplied MP3 file instead of TTS.
  3. External Audio Test. Generates an internal CAP alert message, fetches and plays a test MP3 file from Pelmorex.
  4. Embedded Audio and Image Test. Generates an internal CAP test the displays a JPG image and plays audio recording. Requires ‘Moderately Severe Alerts’ to be enabled.

Click Inject to add the message to the Active Alerts queue; a 20 second countdown begins. If another incoming message is received, the countdown timer is rest at 20 seconds. Once the countdown reaches 0 secs, queued messages will play through the active audio output and can be observed in real time on the player’s main Status Page displaying the current state of the Player with live display of system events.

Pro Tip Try different text-to-speech voices when testing alerts, before placing on air.

Scheduled Testing

In Canada, national tests are done every 6 months. Contact Alert Ready for more info on scheduled testing.

 Canadian Live testing of Alert Ready

 Alert Logging

Ad Hoc LIVE testing

It is possible to monitor and receive real alerts by entering high level SGC geocodes for provinces (Atlantic Canada=1; Quebec=2; Ontario=3; Prairies=4; British Columbia=5; Northern Canada=6) and test with moderate advisories.

Enable the Play Moderately Severe Alerts setting to receive and play additional warning messages.

Set your levels, testing and be sure to reset the Location Geocode back for your specific alerting locale before proceeding to Production Operation.

Pro Tip ` Admin` Menu has a button to export a text log of all Broadcast Intrusive messages ever played on your alert player

Indigenous Alerts

Experimental Features

 Admin Advanced

Use these at your own risk for experimenting with of new features that are not recommended for production environments. Enable the feature from Admin advanced menu and restart player. More info about experimental features is found Here


Feedback

Find a bug? Want to request a feature? Submit your issue to OBServer or OBPlayer

Have some Gstreamer, PHP or Python coding skills? Help Contribute and Sponsor to make the OpenBroadcaster community even better

We really appreciate your feedback!

OBServer Advisories

OBPlayer Advisories

Open Server Bugs

Open Player Bugs