Skip to main content
Skip table of contents

User Manual RetailPlayer

Introduction

The purpose of this document is to guide users through the features and functionality of the RetailPlayer. It provides a detailed description of each component of the RetailPlayer system, explaining the purpose and operation of every button, LED, webpage, and more. This will enhance the user's understanding of the product.

What is RetailPlayer?

RetailPlayer from Barix is a multi-site, multi-channel streaming platform for background music distribution and message scheduling playback. RetailPlayer is a cloud-managed solution, the best choice when there are multiple devices installed in different geographical locations, configured, controlled and supervised from a centralized web app.

The solution encompasses 2 key elements:

  1. The RetailPlayer Devices - compact and robust audio decoders, easy to install, connected to the network, and to the amplification system through standardized connections

  2. The RetailPlayer Portal - Cloud-based management solution where an organization can register their RetailPlayer devices and control them at once with an easy-to-use interface

RetailPlayer Platform - Portal mode

The RetailPlayer devices, out of the box, estrablish a secure connection with the RetailPlayer Portal (over web secure socket) and retrieve their configuration from it (streaming channels, volume, scheduling information and much more).

Applications

RetailPlayer is suitable for:

  • Distributing background music (e.g., in retail stores, restaurants, gyms, hotels, etc.)

  • Radio distribution systems with centralized management

  • Corporate audio streaming solutions

  • Music on Hold systems

  • Sonic branding organizations seeking a professional music playback solution

About this manual

This manual is designed for distributors, installers, and users of the RetailPlayer solution. It covers the functions of the RetailPlayer device, how to set up connections, and how to access and utilize the Portal’s features. The manual is written for those with basic networking knowledge.

This guide assumes that the RetailPlayer device and the Portal are running the latest firmware versions. (For more details on the release history and change log, refer to the release notes.)

Barix strongly recommends using the latest firmware version to benefit from important new features, security fixes, and updated libraries and components.

RetailPlayer allows firmware updates either locally via its web interface or remotely through the Portal (see the Update Page section for details).

Additional documents and support

The following additional documents are available for the RetailPlayer Solution:

In addition to regularly visiting the Barix website and Help Center, users can access support through several channels:

  • Contact your local distributor for the technical support they provide. A list of distributors is available on the Barix website at this link.

  • Reach out to a Barix support technician directly via email at: support@barix.com.

RetailPlayer devices

RetailPlayer runs on the following Barix Products, from this point onward referred to as “RetailPlayer Devices”:

Product

PN

Description

RetailPlayer S400

2017.9221 EU Package

2017.9222 US Package

2017.9223 UK Package

2017.9224 No PSU Package

Compact audio decoder with 3.5mm stereo line output, requires external power supply.

RetailPlayer SP400

2019.9284

Compact audio decoder with 3.5mm stereo line output. PoE powered (IEEE 802.3 af)

RetailPlayer M400

2020.9318 EU Package

2020.9319 US Package

2020.9320 UK Package

2020.9321 No PSU Package

Audio decoder with stereo line output on RCA , requires external power supply.

RetailPlayer TPA400

2020.9314P

Audio decoder with amplified output to drive 4-8 ohms loudspeaker, max power output 6W. PoE powered (IEEE 802.3af)

First Installation

RetailPlayer devices connect to the network via an Ethernet wired interface. By default, each device is configured as a DHCP client, requiring connection to a DHCP server to obtain an IP address.

For more information on network requirements, click here.

After booting, the device will immediately attempt to connect to the RetailPlayer Portal, a cloud-based platform used to manage all devices within an organization.

Portal URL: https://manage.barix.com

To request an account, send an email to support@barix.com with the following details:

  • Organization Name

  • Organization Address

  • Organization Website

  • Admin Full Name

  • Admin Email Address

  • RetailPlayer Device MAC Address

Your account will be verified and opened in maximum 2 working days.

Below is an example of how to connect a RetailPlayer S400 to an amplification system:

  1. Connect the audio cable to the 3.5mm line-out of the RetailPlayer device.

  2. On the opposite end of the cable, the two connectors carry the left and right channels of the stereo stream. Connect these to the input of your amplification system, mixer, or DSP unit.

  3. If you need to hear the IP address during boot (using the Sonic IP® function), increase the volume on your amplification system.

  4. Connect the network cable to the RetailPlayer device.

  5. Connect the power. The device will boot. Listen for the IP address announcement via Sonic IP®

  6. The LED on the front panel will turn green. It will blink if the device is not yet registered with the RetailPlayer Portal, and will remain solid once registered and able to connect to the Portal.

Local web configuration interface

The RetailPlayer device offers some level of control via local web configuration. Specifically the local configuration can be accessed to:

These settings can only be changed via local web configuration interface. Accessing this interface is not mandatory unless one of the above settings must be changed. Any other configuration is perfromed via RetailPlayer Portal.

Additionally, it is also possible to:

  • Update the firmware of the device

  • Apply reset to defaults

  • Reboot the device

In order to access the local web configuration interface type the IP address of the device in the browser URL. .

Sonic IP® function

Each device comes with a feature from Barix called “Sonic IP®”. When the device boots and connects to a network with a DHCP server, it automatically acquires an IP address and announces the address through the audio output. This feature is particularly helpful when accessing the device’s web interface for the first time.

To access the web interface of the device the "Webconfig" flag on the Portal must be set to enabled otherwise the unit will reply with a ‘connection timeout’ or ‘connection refused’ when trying to open the web configuration interface. This option can be found in Devices → Basic Settings → Device Webconfig. More details are provided in the RetailPlayer Portal chapter of this manual.

In the following paragraphs, the settings and the different sections of the local web interface are described. 

The Settings Page

As soon as the web interface is accessed it visualizes the SETTINGS page.

The interface is organized into three main sections:

  1. Top Navigation Bar: This includes options for Settings, Status, Logs, Defaults, Update, and Reboot. In the top-right corner, you’ll also find the device’s MAC address and the current firmware version installed.

  2. Operational Area: This is where users can input values and configure parameters.

  3. Side Help Section: This section provides a brief overview of the parameters and values, assisting users without requiring them to leave the page.
    TIP: Each parameter has a default value, which is also displayed in the help section.

Application Settings

This section is used to configure the device’s main operational mode.

Priority URL

The Priority URL will interrupt any audio currently being played. By default, this field is empty. It is particularly useful for interfacing the RetailPlayer with any paging device capable of sending audio over RTP, thereby overriding the background music.

The device supports RTP in multicast, unicast, or broadcast formats.

When using any RTP static payloads the URL schema is as follow:
rtp://<IP_ADDRESS>:<Port> (Example: rtp://239.0.1.39:5004)

For non-standard payloads, use the following URL schema:

rtp://<IP_ADDRESS>:<Port>?format=[format]&channels=[channels]&rate=[rate]

Where you can assign the following values to the respective fields:

  • format: mulaw, alaw

  • channels: 1, 2

  • rate: 8000, 16000, 24000, 32000, 48000

For example, if you want to play RTP PCM at 48 kHz in stereo, use the following URL:
rtp://239.0.1.39:5004?format=mulaw&channels=2&rate=48000

When the manual format setting is used, it will override the automatic format detection.

Portal URL

This is the Portal URL that the device connects to. By default, the devices are configured to connect with the Barix Portal.

The connection to the Portal is established over HTTPS and upgraded to Web Secure Sockets.

Only change this field if you have your own on-premises Portal; otherwise, do not modify this value.

RTP Forwarding

This feature enables the RetailPlayer device to re-broadcast its main audio output to a destination address over RTP (Real-time Transport Protocol).

When this option is enabled, you can configure the Forwarding Destination Address, which must be an RTP multicast or unicast address
(e.g., rtp://239.0.1.39:5004).

Additionally, you can select the audio format from the following options:

  • G.711 u/aLaw @ 8 kHz Mono (64 kbps)

  • G.722 @ 16 kHz Mono (64 kbps)

  • MP3 @ 44.1 kHz Stereo (128 kbps)

  • Uncompressed PCM @ 44.1 kHz Stereo 16-bit (1411 kbps)

This functionality allows the RetailPlayer to serve as a primary audio source for a fully IP-based installation using IP Formers.

Playback Priorities 

This chapter clarifies the various audio sources that the RetailPlayer can handle. One of the key strengths of RetailPlayer is its range of fallback mechanisms designed to ensure continuous playback under all circumstances.

The playback sources are organized into three categories: PRIORITY, FOREGROUND, and BACKGROUND.

Priority

Category

Source

Description

1- Highest

Priority

Priority URL

When audio is received at the priority URL whatever is playing is immediately overridden

2- High

Foreground

Scheduled Assets and Cues

Any scheduled clip (asset) or manually triggered cue always plays over background material. (I.e ads, messages etc.)

3- Medium

Background

Main Stream/Store & Play/USB Tracks

Under normal conditions, the playback source is either the main stream, a store-and-play channel, or USB tracks (the latter must be enabled through the Portal).

2- Low

Background

Fallback Stream

Only when the device is set to play a STREAM, in the channel configuration is possible to setup a fallback streaming server that will play only in absence of the main stream (not applicable to Store & Play)

1- Lowest

Background

Failover Tracks

When the device is configured to play a STREAM, the Channel List settings allow you to upload Failover Tracks. These are locally stored music tracks that will play only in the absence of the main or fallback stream, such as during a network disruption at the player location.

Se the RetailPlayer Portal configuration chapter to learn how to setup the playback material on the RetailPlayer device.

Network Settings - Ethernet

IIn this section, you can configure the network settings for the RetailPlayer device. You can choose between dynamic or static address assignment methods for the Ethernet interface.

The RetailPlayer supports the Dynamic Host Configuration Protocol (DHCP), which enables the device to acquire an IP address from a pool managed by a DHCP server. When the device is discovered on the network, the server assigns an available IP address. This address is associated with a lease time, meaning that once the lease expires, the DHCP server may reassign the IP address to other devices on the network, potentially giving it a different address than before. Additionally, the DHCP server provides all related information to the requesting device, including subnet, gateway, and DNS addresses.

While DHCP offers a convenient way to assign IP addresses, there are situations where static IP addresses are necessary. In these cases, you can manually assign a static IP address to the RetailPlayer device to ensure it remains consistent over time.

IMPORTANT
While is possible to use either DHCP or Static IP methods to assign an IP address to the Ethernet (wired) interface of the RetailPlayer, the wireless interface supports only the DHCP method. If you are operating your RetailPlayer solely on a wireless connection (with no Ethernet cable plugged in), ensure that the Ethernet method field is set to DHCP. Failing to do so will prevent your device from connecting to the wireless network.

DHCP Method

Static Method

DHCP Hostname

When DHCP is the chosen protocol it is possible to indicate the Hostname of the DHCP server to be sent in the DHCP request. It's an optional field.

IP Address

This is the fixed IP address of the RetailPlayer device. The IP address serves as a unique identifier for the device on a network. If you are using static assignment, ensure that no other device on the same network has the same IP address assigned to the RetailPlayer.

Netmask

In addition to the IP address, it is essential to provide information about the subnet mask. The subnet mask indicates which bits in the IP address are allocated for the network portion and which are allocated for the host portion.

In a Class C LAN, the subnet mask is commonly set to 255.255.255.0. This configuration specifies that the first three octets of the IP address (e.g., 192.168.1.100) are used for network identification, while the last octet (e.g., 192.168.1.100) is reserved for host identification within the network.

Gateway IP Address

The Gateway IP address is the address of the device that connects your Local Area Network (LAN) to the Internet, typically a router that all devices on the LAN connect to. To utilize the RetailPlayer’s cloud-based features and receive a stream from an Internet radio in stand-alone mode, it is essential to provide this address. If you are unsure of the Gateway address on your network, please contact your network administrator.

Network Settings - Wireless

RetailPlayer devices are equipped with (2x) USB ports in the front panel that can be used for a WiFi Dongle to be connected, in this way the device can connect to the network wirelessly.
It is necessary to configure the wireless parameters to access the WiFI network. 

RetailPlayer devices are compatible with the Realtek RTL8188EU chipset. Click here for the full list of compatible vendors and product IDs.

To connect your RetailPlayer to a wireless network, follow these steps:

  1. Insert your WiFi USB dongle into one of the USB ports (it does not matter which port you choose).

  2. Refresh the local web interface in your browser or power on the device if it was turned off. You should now see an indication stating "not configured" next to the WIRELESS label.

  3. Select the SSID you wish to connect to from the drop-down list.

  4. Set the Security Protocol to WPA.

  5. Enter the password for the selected SSID.

  6. Ensure that the IP assignment method is set to DHCP. As of firmware version 5.3.0, static IP assignment is not available for the WLAN interface. Also, make sure the Ethernet method is set to DHCP; otherwise, your device will not connect to the wireless network.

  7. Click on Submit at the bottom of the page. The device will apply the configured settings and reboot. After rebooting, the WiFi status should show as connected, indicated by a green dot next to the WIRELESS label.

  8. Visit the Status page of the web interface to locate the Wireless Settings. Here, you can check the IP address configured on the device. Make a note of it if you intend to access the device via WiFi.

  9. Power off the RetailPlayer and disconnect the Ethernet cable. Power it back on and wait until the boot process is complete. If Sonic IP is enabled, it will announce its IP address over the audio output. Verify that the wireless connection is fully operational.

    image-20241007-100018.png

    While it is possible to use DHCP or Static IP methods for assigning an IP address at the Ethernet (wired) interface of the RetailPlayer it is not possible to do the same with the wireless interface, which supports only the DHCP method. If you run your RetailPlayer using solely Wireless connection (no Ethernet cable plugged), make sure to set the Ethernet method field to DHCP, failing in doing so will result in the impossibility to connect your device to the wireless network.

When the device connects correctly to a wireless network it will be indicated in the web UI as follow:

image-20241007-100222.png

WIRELESS

Connection LED

It shows the status of the connection to the wireless network and if a dongle is inserted and configured

  • 🔴 - Not connected

  • 🟡 - Connecting…

  • 🟢 - Connected

SSID

It is the Service Set Identifier or the name of the wireless network you intend to connect to or if already connected, it's the one that you are currently using . RetailPLayer doesn’t support the selection of ‘hidden’ networks

Security

Select the correct security protocol to be used

Password

The password to authenticate within the wireless network

DHCP

Define the Dynamic Host Configuration Protocol. For the wireless interface of the RetailPlayer, only the DHCP method is available

IMPORTANT: If you intend to connect only using the wireless interface make sure to set also the Ethernet method to DHCP

DHCP hostname

It indicates the hostname to be sent in the DHCP request. It is an optional field

WiFi USB dongles tested with RetailPlayer
  1. TP-Link TL-WN722N

  2. Realtek RTL8188EUS

  3. TP-Link TL-WN725N

Other list of USB dongles using the same chipset can be found here

DNS, SonicIP® Volume

Completing the network configuration of the RetailPlayer device are the below settings:

DNS Auto

Automatic Domain Name System resolution. If set in Auto the DHCP server will provide the address of a DNS server to contact for the IP name resolution process.

DNS Manual

If DNS is set to Manual the device expects the Primary and Alternative DNS server fields to be filled with the related information. When Ethernet IP method is set to Static, DNS will always be set Manual and it is mandatory to provide the address information

Primary DNS and Alternative DNS

This address is for the Domain Name Server (DNS), which informs the RetailPlayer which DNS server to contact to resolve domain names into IP addresses. For example, the address of an Internet radio, such as http://barix.streamguys.net/Barix_hi, needs to be translated into an IP address, and this task is handled by the DNS server.

The Alternative DNS serves as a backup for name resolution in case the primary DNS server is unavailable. This field is not mandatory. If you are unsure about which DNS server address to use, please contact your network administrator.

Proxy Configuration 

Proxy type supported: HTTP

Host

The Hostname or the IP Address of the proxy server to be configured

Port

The port number used by the proxy

User name

If the proxy requires authentication, inset here the username to be used, otherwise leave the field empty

User password

If the proxy requires authentication, inset here the password to be used, otherwise leave the field empty

Exceptions*

Set here any proxy exception, connections that will bypass the Proxy

Time Settings

It is essential for the RetailPlayer device to operate with the correct date and time. This is crucial because the validation of HTTPS certificates, which establish a secure connection with the Portal, relies on these certificates being valid within a specific time window. The device presents its system time during this process; if the time is outside the expected window, the device will be unable to connect.

RetailPlayer devices utilize an NTP (Network Time Protocol) daemon to set their system time, operating over the standard port 123. The time set by NTP is in UTC (Coordinated Universal Time).

In the web interface, the time settings allow users to modify the default NTP pools used by the device. This flexibility is beneficial for customers who may wish to use their internal NTP servers or prefer alternative options. The fields accept either a domain name (which requires a valid DNS connection to resolve to an IP address) or an IP address.

Users can verify the system time on the Status page of the device or from the Portal's status page.

Once the device has booted, NTP is used to set the time only at startup. After establishing a connection with the Portal, the time is managed by the Portal, which also allows for the selection of the appropriate time zone for the device's installation. This ensures that the device always operates on the correct schedule for its intended use.

Security Settings

This section is dedicated to securing access to the RetailPlayer web interface and enabling or disabling critical operations such as rebooting, resetting to factory defaults, and updating the device.

Reboot Function

Enable or disable the reboot function of the device from the web UI

Reset Factory Defaults

Enable or disable the possibility to reset the device to factory default from the web UI (hard reset via button continue to operate)

Update Function

Enable or disable the possibility to update the device from the web UI

Web UI Password

Set the password for accessing the web interface of the RetailPlayer device. If a password is already set, an additional field labeled OLD PASSWORD will be displayed, which is required to change the password.

By default, the web interface of the device is protected by the password printed on the back of the device. You also have the option to disable access to the web interface by turning off the Webconfig option in the Portal settings, which will disable the device's web servec effectively closing access to port 80 or 443.

Default Username: admin

Additional Certificates*

Allows the possibility to upload custom .crt certificates to the device. Useful when the device is used in private enterprise networks where a private CA is in place to validate secure connections between devices.

SUBMIT

By clicking on the button SUBMIT all the changes made in the SETTINGS page are applied in the configuration. 

By clicking on CANCEL all the changes are not applied and the fields return to their previous inserted value. 

Status Page

Click on STATUS in the top navigation bar to view the current status of the RetailPlayer device.
The status report provides information about the hardware and application status, offering a quick overview of the device's current configuration.

The Status Page displays the following information:

image-20241007-102352.png

Application accordion

Portal URL

The current portal URL configured in the settings page

Active stream

The audio stream that is currently playing. It is a useful indication to verify if it is playing any stream among priority, main, failover or fallback tracks (failover playlist with mp3 files)

Priority stream

The priority stream URL configured on the settings page. This is the stream with the highest priority, if it is received it will overlap any other stream currently playing

Main stream

The main stream URL configured on the settings page

Failover stream

The failover stream URL configured on the settings page

Current playback volume

The playback volume of the player currently set. If the device is used in Portal mode the volume is set from the Portal, in stand-alone mode, the volume is set from the settings page

image-20241007-102737.png

Failover Playlist accordion

Name

This is the name of the playlist.m3u file saved in the device configuration. It is filled automatically when fallback tracks are identified, either from the Portal, when the device is used in Portal mode or from the USB drive, when used in stand-alone mode

Content

The actual fallback tracks (mp3 files) the device will play in absence of any stream provided. This field is useful to verify if the fallback tracks uploaded from the Portal are actually retrieved from the device

NOTE: When the tracks are retrieved from the Portal the name of the file is the unique identifier used in the Portal to match with the corresponding resource

image-20241007-102946.png

Device Information accordion

Hardware type

The actual RetailPlayer device (in parenthesis is the Part Number)

IPAM type

The Barix IPAM codec module installed in the device (in parenthesis the Part Number of this component)

MAC Address

Media Access Control address - This is the hardware address of the Ethernet interface of the device. It is required when the device is registered on the RetailPlayer Portal. It is found here but also on a sticker applied underneath the device

Firmware version

The running firmware installed on the device

Application

The name of the application currently running

Linux kernel version

The version of the Linux operating system in use

Bootloader version

The bootloader version currently in use

image-20241007-103209.png

Network accordion

Wired Connection

Status

Shows if the device is connected via the Ethernet interface to the network

IP Address

The current IP address of the Ethernet interface

Netmask

The subnet mask on which the device is operating

Wireless Connection

Status

Shows if the device is connected via the Ethernet interface to the network

MAC Address

Media Access Control address - This is the hardware address of the wireless interface of the inserted WiFi USB dongle

SSID

The Service Set Identifier - the name of the wireless network to which the device is currently connected

Signal Strength

The power expressed in percentage (0% - 100%) of the WiFi radiation

Try to position the device where this value is higher than 45% to get better results when using a WiFi connection

IP Address

The current IP address of the wireless interface

Netmask

The subnet mask on which the device is operating

Network

Default Gateway

The gateway address currently set

DNS Servers

The DNS server addresses (primary and secondary) currently in use. Provided either by the DHCP or entered manually in the settings page

image-20241007-103338.png

System accordion

System time

Shows the current time of the device, synchronized with the set time zone

Uptime

Displays the duration since the device last connected or rebooted, indicating continuous operation time

image-20241007-120655.png

Licenses accordion

License name

Indicates the device’s license name

Status

Indicates the current state: active/inactive

Issue date

Indicates the date when the license was issued

Expire date

Indicates the date when the license will expire

ID

Unique identifier for the license

Features

Eventual features will be listed here

Signature

Parameter which confirms the license validity

image-20241007-121406.png

Mass storage devices accordion

Type

Indicates the type of the mass storage device

Usage

Indicates, with a graphic the storage’s usage:
🟥 - space already used
🟩 - space still available

Size

Total memory of the mass storage device

Used

Amount of memory already used

Available

Amount of memory still available

File system

Indicates the type of file system present on the storage device

Status

Indicates the current permission status on the storage device

Logs Page

The Logs page displays the events occurring operation of the RetailPlayer device.

Logs are useful for debugging issues, they give a detailed insight into every process within the RetailPlayer OS.

On the top-right corner, it is possible to click the button “Download all messages” to download all log files.

image-20241007-124222.png

When contacting the Barix support it is useful to attach along with the communication the Log files downloaded and the status page screenshot. Do not forget to give a description as much detailed as possible about the steps made that led to the issue.

Defaults Page

Reset to Factory Defaults - Soft Reset

The Defaults page on the web interface of the RetailPlayer device allows you to perform a soft reset. This operation reverts all settings, except the network settings, back to factory defaults. It does not downgrade the firmware; it simply resets the settings for the running application.

The option to enable or disable the reset to factory defaults can be found on the Settings page under Security Settings.

When the reset button is clicked, the device initiates a 10-second countdown, after which you can reload the web interface.

image-20241007-115604.png
Reset to Factory Defaults - Hard Reset

The RetailPlayer device also supports a hard reset, which reverts all settings to factory defaults, including network settings.

To perform a hard reset, locate the reset button on the front panel of the RetailPlayer device. Using a sharp-pointed tool, press and hold the button for approximately 10 seconds. The status LED will blink green three times, indicating that the reset operation has begun. After a few seconds, the device will reboot with factory defaults. Be sure to reload the web page once the operation is complete.

Update Page 

The RetailPlayer platform offers the possibility to update the firmware of the device locally from the web interface or remotely via the Portal. More details are provided in this chapter on both functionalities. 

Run always the latest firmware available from Barix as it might include bug fixes, improvements or new useful features

The Update page has 3 purposes:

  • Visualizes the current software loaded on the RetailPlayer device

  • Enables the remote update of the device

  • Updates the device directly

in order to update to a firmware version newer than 5.0 from an older firmware it is mandatory to first update to FW version 5.0 and then update to the 5.X or 6.x FW. More on the subject here.

Visualize the current version installed

Under “Currently Loaded Version” it is visible the current firmware installed, the root file system version, the web UI release version, the kernel details, and the Bootloader information.

Remote update via RetailPlayer Portal

The RetailPlayer Portal allows you to update the firmware of RetailPlayer devices remotely. (For details on accessing device settings from the Portal, please refer to the RetailPlayer Portal chapter.)

To update the firmware remotely from the Portal, follow these steps:

  1. Log in to the Portal at manage.barix.com.

  2. Navigate to the Devices menu and select the device you wish to upgrade from the list.

  3. In the device's Overview page, locate the Firmware drop-down menu under Basic Settings.

  4. Select the desired firmware version.

Any device running firmware v5.x or an earlier version will not connect with the RetailPlayer Portal. Update your device via local web configuration intarface to enable Portal connection.

The Device needs to be powered overnight in order to perform the automatic update at 4 am.

Automatic Firmware Update via Portal

In the Portal, you can set up an automatic firmware update by selecting a ".x" release from the drop-down menu (e.g., Firmware 6.x). With this configuration, any release available within the 6.x version will be automatically installed by the devices. They will check for updates daily at 4 AM to see if there is any available on the Barix update server at https://release.barixupdate.com

Update via the Web Interface

To update the firmware locally from the update page, start by downloading the latest firmware package from the Barix website at http://www.barix.com/downloads . The firmware for the RetailPlayer is located under the Products section, specifically in the Decoder category. Alternatively, you can simply type “RetailPlayer” in the search bar on the website. Please note that the ability to download firmware packages is available only to registered users.

The firmware is provided as a TAR archive file. To update from the web interface:

  • In the Update page, click on Please click here to start the update to access the system update page.

  • Click on Choose File, then locate and select the corresponding TAR archive.

  • Click on Upload.

  • A progress bar will appear, indicating the completion of the upload process. Wait until the upload is finished (do not disconnect the power supply during this operation).

  • Once the upload is complete, the device will reboot automatically. Reload the page or click the home link to return to the home page.

Please clear the cache or restart your browser to ensure the web interface of your device is displayed correctly after the update.

Do not disconnect the power supply during the update. The software update can take up to several minutes depending on the size of the firmware.

Rescue Image Process

The RetailPlayer application runs on a removable flash memory card in microSD format. In cases where the application fails to load correctly from the flash memory, you can execute a rescue process to restore the original factory firmware on a new microSD. For example, if your device was shipped with firmware version 5.2.0 and you were using 5.3.0, this process will revert the firmware to version 5.2.0 and reset all settings to factory defaults, including network settings.

Procedure:
  1. If your RetailPlayer device is powered on, shut it off.

  2. Ensure the device is connected to the internet. For this process to work, the device will attempt to connect to the Barix update server (http://release.barixupdate.com) via HTTP (port 80) to download the rescue image.

  3. While the device is off, press and hold the reset button.

  4. Keep the button pressed while powering on the device (for S400, connect the power cable; for SP400, connect the Ethernet cable).

  5. Continue holding the button for at least 8 seconds after power is applied.

  6. Release the button to start the rescue process.

  7. The device will restart, and the LED will blink orange, indicating that a firmware update or downgrade is in progress.

  8. When the LED turns green (either blinking or steady), reboot the device.

Your device is now rescued.

Reboot Page

This page is dedicated to rebooting the RetailPlayer device.

Rebooting is the process of power cycling the device (ON → OFF → ON) and can be performed from the web interface or by using the reset button on the front panel.

Reboot from the Web Interface
  1. Click Reboot the device to restart the device.

  2. A countdown screen will appear, lasting for 10 seconds. At the end of the countdown, the device will reboot.

  3. Wait approximately 20 seconds, then reload the web page or click on the text that says Click here to return to the home page.

image-20241007-115437.png
Reboot from the reset button

The reboot of the device from the button is performed by pressing the Reset button located on the front panel of the RetailPlayer device for 3 seconds approximately.

A long press of this button (10 seconds) will reset the device to factory defaults.

The RetailPlayer Portal 

The Barix RetailPlayer Portal is a cloud-based management platform that allows users to control, monitor, and troubleshoot RetailPlayer devices remotely.

The Portal is accessible using any web browser at: https://manage.barix.com

Portal Login

When purchasing the RetailPlayer solution, contact the Barix Support team (support@barix.com) or with your local distributor to receive your RetailPlayer Portal credentials, required to login. 

In the Login area, enter the credentials and click the SUBMIT button to access the portal.

image-20241003-115205.png

First Access

The first time the Portal is accessed it will ask to change immediately the password used for login.

Insert the new password, confirm by clicking on image-20241007-125019.png in the top-right corner. Logout and log back in again with the new password. 

image-20241003-115653.png

User Interface Layout

Once logged in the Portal, clicking on the Devices link opens the list of units registered under the current organization selected:

image-20241003-120353.png

The sidebar menu on the left provides access to the following sections of the RetailPlayer Portal:

  • Devices: The device management section, where you can register, configure, control, and monitor each RetailPlayer device.

  • Channels: Access the configuration of stream URLs used as channels.

  • Channel List: Manage groups of channels by configuring channel lists.

  • Asset Organizer: Manage audio clips for scheduling on a weekly planner, interlacing them with streaming channels. You can also create Cue Sets to play audio files manually from the QR Code web app or directly from the Portal.

  • Organization: An overview of the main organization and its associated resources, such as sub-organizations, users, devices, and channel lists.

  • Users: Manage user creation, privileges, and settings in this section.

  • Knowledge Base: Redirects to the RetailPlayer user manual.

  • Troubleshooting: Redirects to the user manual, specifically to the section on connectivity issues.

It is possible to change organization by using the selector in the top navigation area:

  • Organization Selector: If the organization in use has sub-organizations, they will appear in this dropdown. Switching between organizations will change the displayed resources, including devices, channels, channel lists etc.

Devices management 

The "Devices" button gives access to the device list. All the registered devices of an organization and its sub-organizations are listed here.

image-20241003-120353.png

The device list is organized as follow, from top to bottom: 

Quick Filters with counters and search bar

ONLINE device filter
Click on this button to list only online devices. The number in the icon represents the number of online devices in the list

OFFLINE device filter
Click on this button to list only offline devices. The number in the icon represents the number of offline devices in the list

FALLBACK URL device filter
Click on this button to list only devices that are currently playing the fallback url. The number in the icon represents the number of devices that are in this condition

FAILOVER TRACKS device filter
Click on this button to list only devices that are currently playing the failover tracks. The number in the icon represents the number of devices that are in this condition

RESEARCH BAR - search in the list
Use this text input field to search for devices in the list. Parameters that can be used for the search: Name, MAC, Location, Notes.

Refresh the list button
The table is automatically refreshed every 15s but if a quicker refresh is required the user can click on this button.

Device List

Delete device from the Portal button
Once removed the RetailPlayer is muted, the audio output is silent.


activity
indication

Online: the device successfully established a connection with the Portal. It's possible to monitor its status and control the playback
Offline: the device is not connected with the Portal. If it was connected at least once in the past the reported information are the last ones reported before disconnecting, if it never connected there is no reported information or status. In this state the device cannot be monitored nor controlled.


Opening Hours indication

Open: the device is Active and receiving the stream
Closed: the device is Inactive and not receiving the stream
Device is not connected with the Portal


Playback
Status

Device is playing Main URL. By mouse overlay is possible to visualize the stream URL that is playing
Device is playing Fallback URL. By mouse overlay is possible to visualize the stream URL that is playing
Device is playing Failover Tracks. By mouse overlay is possible to visualize the track that is playing
Device is playing an Event (scheduled asset or triggered asset). By mouse overlay is possible to visualize the asset that is playing
Device is playing USB tracks. By mouse overlay is possible to visualize the track that is playing
Device is playing the Priority URL. By mouse overlay is possible to visualize the stream URL that is playing
Device is NOT playing anything OR Device is transitioning the playback from one source to another
Device is not connected with the Portal
Device Firmware doesn't support this feature. Playback reporting has been introduced in FW > 6.2, make sure to update your players to see this information.

Device volume indication in %, visible when overlaying the icon with the mouse
Device not connected with the Portal, if the device was ever connected the mouse overlay shows the last reported volume

NAME

This column shows the device's name, it is the default sorting used in the table. Clicking on the arrow it is possible to sort them from A..Z or from Z..A

CHANNEL

The current channel selected, the name visualized is the one assigned to the channel in the channel configuration

CHANNEL LIST

The current channel list selected, the name visualized is the one assigned to the channel list in the channel list configuration

ORGANIZATION

The organization the device belongs to

Device registration

From the device list window, click on the 

button in the top-right corner to add a new device in the Portal. 

This opens a wizard configuration that guides the user toward the first configuration of the device, the steps are as follow: 

  1. Select the registration mode. You can register one device at a time or register multiple devices at once, using bulk registration.

image-20241004-101519.png

BULK REGISTRATION

  1. Click on the “Upload CSV file“ to load the text file containing devices names and MACs:.

To device bulk registration, upload a CSV file with following format:

CODE
"00:08:E1:WW:XX:YY";"My device alias YY"
"00:08:E1:WW:XX:ZZ";"My device alias ZZ"
image-20241007-132638.png
image-20241007-134655.png
image-20241007-134738.png

SINGLE DEVICE REGISTRATION

  1. Enter the MAC Address of the RetailPlayer device, assign a name to the device, and, if necessary, add a note for additional information.

image-20241004-120443.png
  1. Select the Organization this device belongs to.

image-20241004-120900.png
  1. Settings configuration to be applied to the registered device(s)

image-20241004-123740.png

Options

Time zone menu

Select the appropriate time-zone based on the geographic location where the device is installed. This ensures the correct time is set for functions like HTTPS certificate validation.

Web config switch
Default value: OFF

This switch enables / disables the RetailPlayer local web configuration ineterface.

Sonic IP swirch
Default value: ON

When enabled, this feature enables the IP address announcement of the device during boot.

Play USB tracks switch
Default value: OFF

This option enables the playback of audio tracks from a connected USB drive. When enabled, only tracks from the USB pen drive will be played.

Volume slider
Default value: 75%

The volume slider allows you to adjust the output volume of the RetailPlayer device.

  1. Select the channel list and the specific channel you want the device( to play after registration, then complete the setup by clicking the image-20241007-142119.png button.

You can also choose not to select a channel or channel list, but in that case, the device will not play anything.

image-20241004-124112.png

Device Settings

After registration, the user should navigate to the Device Settings to finalize the configuration of the newly added device. This section can also be used to modify the configuration of an existing device.

image-20241004-130019.png

Settings page

Name

Assign a name of your choice to the device

MAC

Shows the MAC Address of the device

Firmware

Select the firmware version to run on the device. The latest firmware is automatically added to the menu when available, but it is not automatically installed on the device. Firmware updates occur at 4 AM the following morning. Starting with firmware version 6.5.0, you can force an update by power cycling the device after selecting the firmware. During the update, the device will reboot, and the audio will be muted for a few seconds.

If the desired firmware is not listed (e.g., a Beta version), ensure you click the "X" in this field to manually update the firmware. This will display the message “please choose...”. Failing to do this will cause the device to reconnect to the Portal and reload the firmware selected in the Portal.

Time zone

Set the local time for the device. This is essential to ensure that scheduling functions operate according to the device's local time.
You can change the device's time zone at any point, even after registration.

Web config
Default: OFF

Enable/disable the possibility to access the local web interface of the device, when disabled the device cannot be accessed locally by connecting to its web server

Use Sonic IP®
Default: ON

Enable/disable the Sonic IP® function of the device

Play from USB
Default: OFF

Enables playback from any USB stick connected to one of the device's USB ports. The files must be located in the USB root folder, and playback will be random and looped. This USB playback source have the same priority as the main stream.

Cross fade time
Default: 3 sec

This function manages the duration of the audio transition between two tracks, specifically for Store and Play tracks or Failover Tracks. It does not control the crossfade time for opening/closing streams or switching between streams. The crossfade time determines how smoothly one track fades out while the next fades in, creating a seamless listening experience.
You can adjust this time from 0 seconds (no crossfade) up to 12 seconds, allowing for a gradual and smooth overlap between tracks.

Organization

Assign the device to an organization, this field cannot be empty.

Channel list

Assigns a channel list to the device. A channel list is a group of channels. Channels of this list can then be changed in real-time while a device is connected to the Portal from the Real-Time Control section or remotely from a smartphone or tablet by scanning a QR code, see following chapters

Location

This field is called location but it can be used as a custom tag. It is useful to add the location in order to be able to filter devices quickly from the search bar in the device list. Any word in this field can be used to search devices in the device list

Notes

Another custom tag that can be used to facilitate the search of devices that contain any word stored in this field

Once the device is registered and configured further controls and possibilities are available.

Device control section

Clicking on any device in the device list grants access to the Control section for that specific device.
This section provides real-time controls that can be applied to any online device directly from the Portal.

image-20241004-130700.png

In the top of the window there is a snippet close to the name of the device that shows the status of the device, the icons are the same as the ones described in the device list area

Real time controls

Channel

These are the channels added in the channel list selected in the settings section. Click on the desired channel to start its playback on the device. The large channel name at the center of the screen shows the current playback channel

Mute/Unmute

It mutes/unmutes the audio output of the device

Volume

Sets the volume of the device audio output

Audio Cues

Click on the Cue set button to visualize the list of assets (cues) assigned to this device. Clicking on an asset will trigger its playback

<-- Show Cue sets button

These controls are applied in Real-Time to devices that are ONLINE.

Device Status

The status panel is a great remote monitoring tool that can be used to check the current status of the device.
Main section

image-20241004-151042.png

INSTALLED FIRMWARE

Indicates the installed firmware on the RetailPlayer device

DEVICE TYPE

Indicates the device model

ONLINE

Indicates the Online Status (Online YES/Online NO) and since how long the device is in the indicated status

SYSTEM TIME

Indicates the actual device system time in UTC

UPTIME

Indicates since how long the device is being powered

OPENING HOURS

Indicates the opening hours playback activity

ACTIVE RESOURCE

Indicates which resource is playing among:

  • Priority URL (a stream that can be set locally on the Player to play an RTP or HTTP stream, i.e. for paging purposes)

  • Local USB (when "Play from USB" is enabled),

  • Event (audio clips scheduled to play),

  • Main URL, Fallback URL or Failover Tracks

  • None (Indicates no resource is playing)

ACTIVE STREAM

Indicates the currently playing stream or track (for the track is shown the ID of the same, in case of Local USB playing it shows the filename)

BUFFER LEVEL

Indicates the actual streaming buffer level in seconds. This is a good indication that informs how many seconds of audio playout is guaranteed in case the stream that is playing fails. The max size is 60s.

PRIORITY STREAM

Indicates the priority stream that is configured in the device settings

MAIN STREAM

Indicates the main stream that is configured in the device settings

FALLBACK STREAM

Indicates the Fallback Stream that is configured in the device settings

FAILOVER PLAYLIST

Indicates if a failover playlist file is present on the device.
If present the name is playlist.m3u

FAILOVER TRACKS

Indicates the number of tracks that the device has downloaded from the Failover tracks configured in the Channel List

IMPORTANT: From FW 6.1 onward, while the device is downloading the tracks it is possible to see this number updating as time passes.
While the device is downloading the tracks they cannot be played

RECONNECTS (24h)

Indicates how many times the devices has reconnected the Portal during the last 24 hours

MAC ADDRESS

Indicates the MAC address of the device

LOCAL IP

Indicates the local IP address of the device's ethernet interface

WIFI STATE

Indicates the current status of the WiFi connection

PORTAL URL

Indicates the Portal URL from the device settings

STORAGE

Indicates the level of storage still available on the device

REGISTRATION DATE

Indicates the date on which the device was registered on the portal

The actual status update is only possible if the device is connected to the Portal (Status Online YES). If the device is not connected (Status Online NO) the Portal will show the last status reported. Firmware older than 5.1 doesn’t report Status updates

Store & Play section

This section allows the user to see the Store & Play channels assigned to the device with also these parameters:

  • Last Check: the last time the device checked for new content in the channel.

  • Number of tracks: the number of the current tracks downloaded and stored in the channel

  • image-20241010-120753.png - Refresh button: allows to update the stored songs list

  • Total size: the amount of memory occupied by the tracks in the channel

    image-20241010-115021.png

When clicking on a Store & Play channel, the selected channel expands, allowing the user to view the currently downloaded tracks and also:

  • URL: the URL of the file server, where the M3U playlist looks for files to download

  • Content update interval: time interval at the end of which the device checks for any new uploaded music files to download (Default time: 6 hours)

  • Files: Show a list of currently downloaded songs

image-20241010-172103.png

Automation

The automation tab is where the user can find: 

  1. The opening hours scheduler

  2. The channels scheduler

  3. The volume scheduler

  4. The assets scheduler

  5. The Cue sets

Opening Hours Scheduler

This function allows the RetailPlayer device to activate or deactivate the audio player at a specific time on a weekly basis.

image-20241010-084236.png

How to use the opening hours scheduler:

  • Select the time zone your device is in

  • The green areas display when the audio player must be active, playing music, while the gray areas display when the audio player must be inactive

  • Use the mouse to switch between green and gray, drag and drop vertically on each day to switch between green (on) or gray (off)

  • Use the buttons “all” or “none” to switch the playback ON or OFF

  • To apply the settings click on image-20241007-125019.png in the top-right corner to confirm

  • To apply the scheduler configuration to other devices part of the same organization of the device being modified, use the button “Copy to…“ and select the interested RPs

Channel Scheduler

This function allows you to schedule the playback of specific streaming channels at designated times during the week

image-20241010-122803.png
image-20241010-123004.png

How to use the Channel Scheduler:

  1. Select the channel you want to schedule from the Picked Channel drop-down menu
    (only channels from the current channel list are available; the channel list is selected in the Overview tab under Basic Settings).

  2. Click on the desired day and time when you want the playback to switch to the selected channel.

  3. You can insert triggers for different channels in 30-minute intervals, allowing you to schedule channel changes every 30 minutes.

  4. Click image-20241007-125019.png at the top right corner of the page to apply your settings.

  • Use the "Clear" button to reset the scheduler, this will delete all configured channels

  • To apply the scheduler configuration to other devices part of the same organization of the device being modified, use the button “Copy to…“ and select the interested RPs

Volume Scheduler

This function allows you to schedule the volume level of the channels at designated times during the week
Just above the scheduler are several buttons that have the following functions:

View as list - image-20241010-143718.png

Opens a sliding window where all the triggers are listed with their icon, day of the week, time and volume percentage

Select all - image-20241010-144144.png

Select all triggers configured in the voulme scheduler

Delete selected - image-20241010-144256.png

Delete all selected triggers from the scheduler

Zoom fit to selection - image-20241010-151427.png

Show all scheduler triggers compressed so you can view them all together

Zoom out - image-20241010-152343.png

Zooms out the scheduler in order to view more time cells

Zoom in - image-20241010-152822.png

Zooms in on the scheduler so you can see more time slots between hours

Zoom full out - image-20241010-152918.png

It completely zooms out the entire scheduler so you can see every hour and trigger

image-20241010-131225.png

How to use the Volume Scheduler:

  1. Select the volume level you want to assign to the device using the volume slider

  2. Assign that volume to the time and day you want

  3. Click SAVE in the top right corner to apply your settings

  4. Click "Copy to..." to apply this configuration to other devices part of the same organization of the device being modifed

  • You can also write eventual notes in the textfield just below the scheduler.

Asset scheduler

This section of the Devices page allows you to view an already configured asset scheduler, including its respective audio components, by selecting it through the drop-down menu. However, please note that the components in this section cannot be modified or removed. To manage and edit them, visit the following link: Scheduling Section.

image-20241016-143403.png

Cue sets

This section is accessible exclusively to Retail Hero subscribers

The Cue Sets in the device section allow store managers to view the sets assigned to the device. A Set consists of buttons linked to specific audio files. When a button is pressed, the player fades out the current music and plays the triggered audio file, which could be an ad, a pre-recorded message, an alarm, a product offer, or even a birthday song.
Once the audio file finishes playing, the music fades back in automatically.

image-20241010-161557.png

Playback can be triggered from the Automation tab (refer to the screenshot above), the Control section (see screenshot below), or from a smartphone that accesses the Control section via QR Code. For more details, see the corresponding chapter on QR Code access.

image-20241011-120038.png

To see how to create a Cue set and assign it to multiple devices visit this chapter

Remote Control

In this area, you can generate QR codes that, when scanned by smart devices, open a link to the Portal’s responsive web application. This feature is useful, for example, when an organization’s administrator allows employees to manage basic controls on players installed at their location.

image-20241015-135133.png

To create a new QR code, click the "+" button. Once generated, the QR code is ready for immediate use.

Each QR code can be named, scanned directly from the screen, or sent via email. To send it via email, simply click the email icon and enter the recipient’s details.

You can enable or disable access through a QR code link by using the corresponding toggle on the left side of the QR code name.

The QR code also displays the last access timestamp and the number of times it has been used.

When an employee scans the QR code, the smart device’s web browser will open a link. From there, the following controls are available:

ImportedPhoto.750693276.234448.jpeg
  • View the device status, as shown in the Portal.

  • Switch between any channels assigned to the device’s channel list.

  • Mute or unmute the device.

  • Adjust the volume using the provided slider.

  • Trigger playback of assets assigned to the device’s cue set.

Channel Management

Channels can be of 2 types: streaming channels or Store & Play channels, they are essential to configure in order to hear audio from RetailPlayer devices when they are used in Portal mode.

To manage channels, click on "Channels" from the side-bar menu to enter the channel management section. The channels displayed here belong to the selected organization and its sub-organizations. When creating a new channel, it must be assigned to a specific organizational unit.

For example, in the image below, the user "Manuel" belongs to an organization called "My Organization" The channels listed are only those associated with "My Organization" and its sub-organizations, as shown in the channel table. Since the user is operating within this organization, only relevant channels are visible.

In the upper-left corner, you can change the organization unit, which will update the displayed resources (devices, channels, and channel lists) accordingly.

image-20241015-142637.png

Create a new channel

On the top bar click on 

to add a new channel.
In order to configure the channel, you will need to fill in the following fields:

  1. Assign the new channel to the organization it belongs to.

image-20241017-090106.png
  1. Assign the name of the new channel

image-20241017-090342.png
  1. Select the channel type according to your specific needs:

    • Store & Play: This option allows the RetailPlayer to connect to an external web server directory to download music tracks and store them locally on the device’s memory. The player will then play these stored audio files. This setup is ideal for environments with poor or unstable network connections, ensuring continuous music playback even if the internet connection is lost.

    • Stream: This option connects the RetailPlayer to a streaming server, such as an Instreamer ICE, Icecast, Shoutcast Server, or other cloud-hosted web radio services.

image-20241017-090600.png
Streaming channel:
  • NAME: This is the name of the channel and will be displayed in the device control section and on the remote app used for channel selection.

  • ORG UNIT: The organizational unit to which this channel belongs. It determines which devices and users can access the channel.

  • URL: The primary URL where the audio stream is sourced from. This is the main stream the device will play.

  • FALLBACK URL: A backup stream that will play if the primary URL is unreachable or experiences downtime. This ensures continuous audio playback.

image-20241011-120613.png

The URL field are to be filled always with a valid syntax among: "http://<YourURL>/path/" or "https://<YourURL>/path/"

Store & Play channel
  • NAME: This is the name of the channel and will be displayed in the device control section and on the remote app used for channel selection.

  • ORG UNIT: The organizational unit to which this channel belongs. It determines which devices and users can access the channel.

  • URL: The URL points to an .m3u playlist, which contains the list of files that the player will download and play. RetailPlayer supports ftp or http(s) protocols to download data from the provided fileserver.

  • CONTENT UPDATE INTERVAL: Defines the interval at which the RetailPlayer device will check for any modification applied to the m3u file. When filenames are removed from the m3u file they will be removed from the player’s memory too, when new files are added those will be downloaded by the player in addition to the ones already downloaded.

  • AUTHENTICATION: If the access to the fileserver configured in the URL field is protected by authentication insert here the username and password to be used.

Store and Play doesn’t support Google Drive, Dropbox integration. The m3u link provided in the URL must be a direct download link open to public access.

RetailPlayer supports http digest and basic authentication methods.

The m3u file MUST be stored in the same directory where the files to be downloaded are and the filenames reported in it match exactly the filenames of the tracks that the player has to download.

RetailPlayer supports UTF-8 encoding text, but in some cases this is not enough to guarantee that the files will be found correctly depending on how the fileserver encodes special characters. For this reason avoid using accented characters and other special ones for the filenames of the tracks to be downloaded.

Any line in the M3U that is not a name of a file stored in the same directory will generate an error on the player.

image-20241017-140845.png

Once the settings are defined click on image-20241007-125019.png in the upper right corner.

If necessary, you can copy the current channel by clicking image-20241011-121232.png. This will duplicate the channel and all its parameters, it will be displayed as: Copy of + channel name

When configuring channels, remember that the RetailPlayer supports the following audio formats:

  • MP3 Decoding:

    • MP3 (MPEG-1 Audio Layer III or MPEG-2 Audio Layer III)

    • MP2 (MPEG-1 Audio Layer II or MPEG-2 Audio Layer II)

  • AAC+ Decoding:

    • Formats: .m4a and .aac

    • Profiles: LC (Low Complexity) and HE-AAC/HE-AACv2 (High Efficiency)

  • Opus

  • Ogg Vorbis

  • WAV:

    • Linear PCM 16-bit, 44.1kHz, Big Endian

Channel Lists

In this section, you can group channels into Channel Lists. Click on "Channel List" in the sidebar menu to view existing Channel Lists or create a new one. The page will display the ones that belong to the selected organizational unit and its sub-organizations. When creating a new Channel List, it must be assigned to an organizational unit.

image-20241011-121737.png

the image-20241010-144256.png icon allows to delete the corresponding channel list.

Add channel lists

Click on the 

button in the top-right corner to create a new channel list:

image-20241011-122040.png

When creating a new Channel List, the following information is required:

  • NAME: Assign a name to the channel list.

  • ORGANIZATION: Select the organizational unit to which the list belongs.

  • CHANNELS: Click on the drop down menu to add channels (Store & Play or Stream) to the list. The menu will appear, allowing you to select from the channels already added to the same organizational unit. Click “X” to remove a channel from the list.

  • FAILOVER TRACKS: You can upload failover tracks from your PC. These tracks will play if both the channel’s main and fallback URLs are unavailable. The tracks are downloaded locally to the RetailPlayer device and will play when no other stream is available. Once a stream is restored, the RetailPlayer will immediately switch back to streaming. Failover tracks must be in one of the following formats: .mp3, .wav, .ogg, or .aac*.

  • PLAY ONLY TRACKS: Introduced in Portal release 3.2.1. When this option is flagged and saved, all RetailPlayer devices using the Channel List will play only the failover tracks, without attempting to stream audio. This allows for the creation of music playlists (up to 200 tracks). To switch back to streaming, un-flag this option and click image-20241007-125019.png.

*: If RetailPlayer devices are running FW older than 6.0 the audio format supported is .mp3 

You can upload a maximum of 200 failover tracks, and the number of uploaded tracks is visible in the corresponding area of the Portal. While a device is downloading failover tracks, it cannot play them. The time required for downloading these tracks depends primarily on the network connection speed of the RetailPlayer device. You can monitor the download progress and the number of downloaded failover tracks through the device’s Status Report. - Each audio file (track) can have a maximum size of 16MB.

How to play only tracks

With the new function "PLAY ONLY TRACKS" added in Portal release 3.2.1 it is possible to use the faiover tracks as a music file playlist. How it works: 

  1. Create your channel list, if already created click on image-20241011-124158.png to access its configuration

    image-20241011-124121.png

  2. Upload the required number of faiover tracks, it is possible to upload multiple tracks at once

    image-20241011-124412.png

  3. See the upload status, when all tracks are uploaded click on image-20241011-124620.png, depending on the number of tracks uploaded, allow enough time for the Portal to render the tracks in the list

    image-20241011-124657.png
  4. At this stage, the fallback tracks are being downloaded by the RetailPlayer devices if they are set to play from the selected channel list. Please wait until all tracks have been downloaded onto the players. You can monitor the download progress by navigating to the Device tab → Status → Main → Failover tracks.

image-20241017-085427.png
  1. In the Channel List area click on image-20241011-132443.png - All the RetailPlayer devices configured to play this channel list will play the tracks. Streams are not available when play only tracks is set.

image-20241011-132825.png

After making all the necessary changes to your Channel list, click on image-20241011-133353.png to assign this channel list to other devices within the same organization.

Asset organizer

This section is accessible exclusively to Retail Hero subscribers.

In RetailPlayer Portal V3.x, the premium section "Asset Organizer" has been introduced. This platform allows users to upload audio assets (such as announcements, messages, information, etc.) and schedule their playback on a weekly or monthly basis. The playback is seamlessly integrated with the streaming channel being played by the RetailPlayer devices.

Access the Asset organizer section to open the Asset manager

Asset Manager section

The Asset Manager window displays all the audio files uploaded for the currently viewed organization. In the example below, the organization is "My Organization" and the files listed are associated with this specific organization.

image-20241011-134724.png

The big button on the top "upload files here" allows to upload assets from the local PC where the Portal is accessed. 

Audio Files format supported: .mp3/.wav/.ogg/.m4a/.opus

By clicking image-20241011-124158.png next to each file, you can:

  • Edit the asset name.

  • Add any necessary notes.

  • Set the playback volume level (range: 0-200).

  • Play and preview the asset.

Additionally, clicking on image-20241011-135134.png opens the audio file details, allowing for another preview. The playback will occur through the browser using the audio output of the PC accessing the Portal.

image-20241011-135241.png

To delete an audio file uploaded: 

  • Click on the checkbox for the desired file

  • The upper row turns red and a bin icon appears on the right corner, click on image-20241011-135404.png and confirm the operation to delete the file

Each individual audio file must not exceed 16 MB in size.

Bundles section

Only available on devices running FW > 6.x

A bundle is a pre-configured sequence of assets that can be scheduled and managed as a single entity. When a bundle is scheduled, the components within the bundle will play one file at a time at the specified intervals, rather than all files playing simultaneously at the scheduled time. This setup allows for flexibility in organizing and distributing content over the scheduled period.

Once you are in the section, you will see a drop-down menu that lists all your previously configured bundles. If you do not have any bundles set up yet, click on image-20241011-142026.png to configure a new one.
To create the bundle correctly, configure the following parameters:

  • NAME: The name you want to assign to the individual bundle.

  • ASSET: After clicking on the image-20241011-142920.png button as many times as necessary to add all the desired assets, the drop-down menu will allow you to choose from the assets previously uploaded.

  • NOTES: Any notes related to the bundle.

To remove an unwanted asset, click on the image-20241011-135404.png icon, and it will be removed from the bundle. Once you have configured your bundle, click on image-20241007-125019.png.

image-20241011-145249.png

Bundles actions
Once a bundle is selected, these buttons appear in the top right corner:

image-20241011-143234.png

This button allows you to delete the selected bundle in one action

image-20241011-143305.png

This button allows you to apply changes to the already configured bundle

Scheduling section

The Scheduling section enables you to create schedules that include one or more components. These components can play individual assets or asset bundles, allowing you to specify the days on which they will be played.

image-20241011-145958.png

Once you are in the section, you will see a drop-down menu that lists all your previously configured schedulers. If you do not have any schedulers set up yet, click on image-20241011-142026.png to configure a new one.
To create the scheduler correctly, configure the following parameters:

  • NAME: The name you want to assign to the individual scheduler.

  • COMPONENT: Click on the image-20241011-142920.png button as many times as necessary to add all the desired components. Once you click "+" this window will open:

image-20241011-150524.png

Below here there is an explanaton of all the parameters:

image-20241011-150859.png

When this switch is disabled, the component will be turned off, preventing it from playing any audio.

image-20241011-151307.png

These two text fields enable you to configure the component's name and add any necessary notes.

image-20241011-151440.png

This button allows you to select the color of the component from an RGB menu, which will be displayed on the scheduler.

image-20241011-151543.png

By clicking on one of the two radio buttons, you can easily select whether to configure the component to play audio assets or asset bundles.

image-20241011-152805.png

This dropdown menu allows you to select the time interval for when the component should play. The available options are:

  • Single day: Play the component on a specific day → image-20241011-153316.png

  • Weekly: Play the component on selected days of week → image-20241011-153115.png

  • Monthly: Play the component on specific days each month. → image-20241011-153403.png

image-20241011-153532.png

This clock menu allows you to select what time the component should play.

image-20241011-153707.png

The Repeat checkbox enables the option to set a time frame within which an asset can be repeated. The frequency of repetition is determined by the "Repeat Every" input field, allowing you to specify the interval between each playback of the asset. This feature is useful for scheduling recurring content at regular intervals within a set time frame.

To apply every change to the component, click on image-20241011-154256.png and, if you are done with everything, click on image-20241007-125019.png to save the whole scheduler.

The devices will play the scheduled files even without internet connection.

When a scheduled file is playing, the status report changes the "Active Resource" and "Active Stream" to "Event" and the associated unique ID of the event playing, see below: 

This is a good way to remotely verify if a schedule is running correctly.

Cues section

This section is accessible exclusively to Retail Hero subscribers.

Only available on devices running FW > 6.1.x 

This is another premium feature added to RetailPlayer, enabling the creation of Cue sets consisting of a maximum of 10 buttons. Each button can be used to manually trigger the playback of audio files associated with it.

The playback can be initiated either from the Portal or through the web application accessed by scanning a QR code.

image-20241011-154919.png
How to create a Cue set
  • Go into the Audio Files section and Audio Files Triggers

  • Click on image-20241011-142026.png or if a set is already created, select it from the drop down menu and click on EDIT

  • Assign a Name to the SET

    image-20241011-155527.png
  • Click on image-20241011-142920.png to add a new button (up to 10 buttons can be added to a set)

  • Click on "Configure me" to open the editing area of the selected button

    image-20241011-155634.png
  • For each button is possible to: assign a name (this will also be displayed on the UI of the remote control app) and an audio file (uploaded in the Asset Manager)

  • Set the volume of the audio file, preview it and modify the background and foreground colors to match your wishes. 

  • Do the same for all the buttons created

  • While in EDIT mode is possible to arrange the buttons to match the desired order. Use the arrows to move a button up or down. Use image-20241011-135404.png to delete.

    image-20241011-160050.png
  • Click on image-20241007-125019.png

  • Click on ASSIGN DEVICES to assign the trigger set to the desired devices

Once a Trigger set is assigned to a device it is possible to trigger the playback of the audio files associated with the buttons from the Portal. Devices → Select the device → Automation → Cues

image-20241011-160344.png

By clicking on each button displayed on this page, you can trigger the playback of the associated audio files.

By clicking image-20241011-163251.png you are redirect to the Cue sets section in the Asset organizer page

The real advantage of this feature emerges when accessed through the web app via smartphones (using QR code scanning). For example, when a waiter is bringing a cake to a customer in a restaurant, clicking any of the buttons will immediately play the corresponding audio file.

Audio files triggered manually take precedence over the main stream, fallback, and failover tracks but do not override the priority URL (if configured) or the USB tracks (when the Play from USB function is active).

Organization management

This chapter and the following sections focus on organization and user management, covering the administrative aspects of the Portal.

The RetailPlayer platform is structured to allow users to be assigned configurable permissions for managing organizations. An organization encompasses a set of resources, including devices, channels, and channel lists, which must be assigned to a specific organization upon creation. For each user within an organization, different permissions can be assigned to control the platform, enabling the creation of distinct roles based on their responsibilities.

Organizations can also have sub-organizations. Users in the main organization have control over all resources in the sub-organizations. However, users assigned to a sub-organization do not have access to the resources of the parent organization and are not even aware of their membership in a sub-organization.

Settings section:

In this section of the page, you will find a text field labeled "Name" where you must enter the name of the main organization. Below that, there is another text field labeled "Notes," which can be used to include any additional information or notes that may be necessary for your organization.

At the top right of the page, there are two buttons designed for managing sub-organizations. The "Add Sub Organization" button allows you to create a new sub-organization under the main organization. Clicking this button will prompt you to enter the relevant details for the new sub-organization.

Conversely, the "Remove Sub Organization" button is used to delete an existing sub-organization. Before proceeding with this action, ensure that you want to remove the selected sub-organization, as this action may result in the loss of associated resources.

To manage sub-organizations, follow these steps:

  1. To add a sub-organization, click the "Add Sub Organization" button, fill in the required details, and save your changes.

  2. To remove a sub-organization, select the organization you wish to delete and click the "Remove Sub Organization" button. Confirm the action when prompted to complete the removal process.

image-20241011-164442.png
Proof of Play section:

This section provides a detailed list of all metadata sent by the players registered within the current organization. The metadata includes essential information such as titles, albums, artists, and URLs of various track types, including stream tracks, S&P tracks, failover tracks, USB tracks, and cue sets.

Additionally, users can view the MAC address of each device, the specific resource it is currently playing from, and other relevant parameters. For convenience, all this information can be easily downloaded to a CSV file by clicking on the image-20241013-152000.png button, allowing for further analysis or record-keeping.

image-20241016-073523.png
Tree section:

In this section of the page, you are presented with a hierarchical view of your organization's structure, displayed in a tree format.

The sidebar on the left provides options to manage various aspects of the organization, including Devices, Channels, Channel Lists, Asset Organizer, Organization, Users, and more. The "Tree" tab is currently selected, allowing you to visualize and manage the relationships between the main organization and its sub-organizations.

Within the tree view, you will see a list of sub-organizations and associated resources, such as Channel Lists and Devices. Each entry has icons that indicate the type of resource it represents. For instance:

  • The temple icon represent the sub-organizations and the main one

  • The document icon indicates a channel list.

  • The device icon signifies a RetailPlayer registered.

You can expand or collapse each entry to view more details. The checkboxes next to each item allow you to select multiple resources for batch actions if needed.
This interface provides a convenient way to navigate through your organization's structure, making it easy to manage devices and channel lists across various locations.

The checkboxes located under the page sections indeed, act as filters that allow you to control the visibility of different resource types within the tree view.

  • Users: When checked, the tree will display users associated with the organization and its sub-organizations.

  • Channel Lists: Checking this option will display any channel lists created for the organization.

  • Devices: When this checkbox is selected, devices associated with the organization will be visible in the tree.

By enabling or disabling these checkboxes, you can customize the view to focus on specific elements (e.g., only devices, only users, or a combination of both) depending on your needs.

image-20241011-164742.png
Retail Hero section

Click here to learn more about Retail Hero → https://help.barix.com/retailplayer/retailhero

This section displays a comprehensive list of all devices registered under the organization. For each device, it provides the status of the Retail Hero subscription, allowing users to easily track subscription details. The status can be filtered using the two status filters located above the list, making it convenient to view devices based on their subscription status.

Additionally, the checkbox next to the status filters allows users to activate an option to display devices that are also present in any sub-organizations, ensuring a more comprehensive overview of all devices within the organizational structure.

image-20241011-184925.png

If a device does not have an active Retail Hero subscription, users can order one by selecting the device and clicking the image-20241013-151319.png button that appears in the top right corner of the page.
Please follow the instructions provided in the center at the top of the page to complete the ordering process.

image-20241013-151222.png

Users management

Users can be created and managed from the corresponding panel accessible from the sidebar menu clicking on "Users".

image-20241011-185132.png

The user list table provides a detailed overview of each user in the portal, displaying important information about their account and activity:

  • USERNAME: The unique identifier or username that the user utilizes to log in to the portal.

  • FIRST NAME: The user's first name.

  • LAST NAME: The user's last name.

  • ORGANIZATION: The organization to which the user is assigned.

  • LAST LOGIN: The most recent date and time when the user accessed the portal.

This table helps administrators quickly identify users and check relevant details, such as their organizational affiliation and recent activity.

Click image-20241011-124158.png to edit the information of the corresponding user, and image-20241011-185746.png to delete it from the portal.

Add new user

To add a new user, click on the "Add User" button located in the top-right bar of the page. After clicking, you will be prompted to fill out the necessary fields for the new user:

  • Username: A unique identifier for the new user, which will be used to log into the Portal.

  • First Name and Last Name: The user's personal details.

  • Password: Create a password for the user to log in with.

  • Optionally, you can tick the checkbox labeled "Force change password at next login", which will require the user to change their password the first time they log into the Portal for added security.

Once all required information is entered, the new user account will be created and added to the system. 

image-20241011-193306.png

User privileges window

When creating or modifying a user, you will notice the "User privileges" option in the sidebar menu. Click on this option to access the User Privileges Settings.

In this area, you can configure specific permissions for the selected user. These privileges determine what actions the user can perform within the Portal, such as managing devices, creating channels, editing organizational units, or modifying settings.

image-20241013-123231.png

For each user, specific permissions can be assigned to control access and the ability to modify certain platform functions. Additionally, users can be assigned to sub-organizations that are part of the main organization they belong to. This flexible permission system allows for customized roles based on user responsibilities within the organization.

Roles panel

Administrator

Granting Administration privilege to a user overrides all other privileges and provides full access to the entire platform.

Device status
https://barix.atlassian.net/wiki/spaces/W040/pages/edit-v2/14324272147#Device-Status

This privilege allows the user to access the Device Status panel in the device editing section.

Device settings
https://barix.atlassian.net/wiki/spaces/W040/pages/edit-v2/14324272147#Device-Settings

This privilege allows the user to access the Device Settings panel in the device editing section.

Device automation - Opening hours
https://barix.atlassian.net/wiki/spaces/W040/pages/edit-v2/14324272147#Opening-Hours-Scheduler

This privilege grants the user access to the Opening Hours section, where they can manage a scheduler divided into 30-minute time cells.

Device automation - Channel scheduler
https://barix.atlassian.net/wiki/spaces/W040/pages/edit-v2/14324272147#Channel-Scheduler

This privilege grants the user can specify which channels from a set channel list the device should play, based on the Opening Hours schedule.

Device automation - Volume scheduler
https://barix.atlassian.net/wiki/spaces/W040/pages/edit-v2/14324272147#Volume-Scheduler

This privilege grants the user access to the Volume Scheduler, enabling them to set different volume percentages for selected devices.

Device automation - Asset scheduler
https://barix.atlassian.net/wiki/spaces/W040/pages/edit-v2/14324272147#Asset-scheduler

This privilege allows the user to access Asset Components, which are pre-configured assets (such as alert messages, short advertisements, or general notices) displayed in a scheduler similar to the Volume Scheduler.

Device automation - Cue sets
https://barix.atlassian.net/wiki/spaces/W040/pages/edit-v2/14324272147#Cue-sets

This privilege grants the user access to view Cue Sets, which are displayed in a list format.

Device - QR code generation
https://barix.atlassian.net/wiki/spaces/W040/pages/edit-v2/14324272147#Remote-Control

This privilege grants the user access to the Remote Control panel within the device editing section. By enabling this privilege, the user can view and manage remote control settings, including the ability to add QR codes.

Channels
https://barix.atlassian.net/wiki/spaces/W040/pages/edit-v2/14324272147#Channel-Management

This privilege grants the user access to the Channel Menu Item, enabling them to manage channels effectively.

Channel lists
https://barix.atlassian.net/wiki/spaces/W040/pages/edit-v2/14324272147#Channel-Lists

This privilege allows the user to access the Channel List menu, enabling them to manage channel lists efficiently.

Asset organizer - Manager
https://barix.atlassian.net/wiki/spaces/W040/pages/edit-v2/14324272147#Asset-Manager-section

This privilege grants the user access to the Asset Organizer, empowering them to manage audio assets effectively.

Asset organizer - Bundles
https://barix.atlassian.net/wiki/spaces/W040/pages/edit-v2/14324272147#Bundles-section

With this privilege, the user gains access to Audio Bundles, which are collections of pre-uploaded audio assets on the portal.

Asset organizer - Scheduling
https://barix.atlassian.net/wiki/spaces/W040/pages/edit-v2/14324272147#Scheduling-section

With this privilege, the user can access the Scheduler that enables the programming of "components," which can contain either single audio assets or entire audio bundles.

Asset organizer - Cues
https://barix.atlassian.net/wiki/spaces/W040/pages/edit-v2/14324272147#Cues-section

With this privilege, the user can create Cue Sets, consisting of up to 10 buttons.

Organization - Settings
https://barix.atlassian.net/wiki/spaces/W040/pages/edit-v2/14324272147#Settings-section%3A

This privilege grants the user access to the Organization Settings section.

Organization - Tree
https://barix.atlassian.net/wiki/spaces/W040/pages/edit-v2/14324272147#Tree-section%3A

This privilege allows the user to access the Organization Tree, a hierarchical view of the organization’s structure displayed in a tree format.

Organization settings - RetailHero
https://barix.atlassian.net/wiki/spaces/W040/pages/edit-v2/14324272147#Retail-Hero-section

With this privilege, the user can access the RetailHero section on the organization page, which displays a comprehensive list of all registered devices.

Users
https://barix.atlassian.net/wiki/spaces/W040/pages/edit-v2/14324272147#Users-management

This privilege grants the user access to the Users page, empowering them to manage all users within the organization, viewing their parameters such as username, first name, last name, password, and email address.

ORG UNITS: A newly added user is always assigned to the organization unit of the administrator creating the user. One user can be part of multiple organizations, thus controlling devices, users, channel lists if allowed to do so from the roles panel.

User Settings

By clicking on the gear symbol in the top bar menu, the user settings will be displayed. In this section, you can update your current user information, including:

  • First Name: Modify your first name as needed.

  • Last Name: Update your last name if necessary.

  • Login Password: Change your password to enhance security.

Make sure to save any changes you make to ensure your updated information is retained.

image-20241013-135457.png

Logout

To log out of the portal, click on the image-20241013-135311.png button located at the top right corner of the page, next to your username. This action will securely end your session, ensuring that your account remains protected and preventing unauthorized access to your user information and settings.

RetailPlayer Security Information

Using RetailPlayer in a live environment often raises security concerns beyond just streaming music. Questions such as "Does this device create a security vulnerability?" or "What happens if the device gets hacked?" are common. To address these, we have compiled an overview of the RetailPlayer's security features, ensuring a safe and secure operation of the device in any environment.

Encrypted Communication with client certificates

The communication between the RetailPlayer and the Portal is a key feature of the RetailPlayer solution and must be highly secure. The connection is established using the WebSocket protocol, secured by SSL/TSL encryption, which is considered state-of-the-art technology for encrypted internet communication.

To initialize this secure connection, each player must have a local client certificate issued by Barix. This certificate is installed during firmware updates and ensures the device’s connection is protected against third-party attacks, preventing unauthorized access. Loading different certificates is not possible, and any connection without a valid Barix-issued certificate will be rejected. Only Barix can issue these certificates, guaranteeing the security of the system.

Unique Password for every device

Every Barix device developed after 2019 comes with a unique, randomly generated, and secure password assigned directly by the factory. This ensures that each device is shipped with built-in security, providing a strong layer of protection right from the start.

Latest Linux Based Software

RetailPlayer devices operate on the latest software provided by Barix, ensuring optimal performance and security. The devices use a Linux-based OpenSource Operating System, offering a secure platform for the RetailPlayer solution. Barix regularly provides software updates with each firmware update to maintain the security and functionality of the devices.

Barix firmware and Malware

There are no concerns about malware on a RetailPlayer device. Although it operates like a complete computer system, it cannot download or run malware. The device runs a closed firmware package that only accepts Barix software, with no option for SSH or Shell connections, making it impossible to install third-party software. The sole application running on the device is the RetailPlayer software, and this cannot be changed. Since all external access to the system is blocked, it is impossible for the device to catch viruses or Trojans.

It is highly recommended to change default passwords and use strong, unique passwords for accessing both the RetailPlayer Portal and the web interface on any RetailPlayer device. Ensure your passwords are stored securely in a safe location to prevent unauthorized access.

Compliance and further Information

This equipment has been tested and complies with the limits for a Class B digital device, as per part 15 of the FCC Rules. These limits are in place to offer reasonable protection against harmful interference in residential installations. The device generates, uses, and may emit radio frequency energy, which, if not installed and used properly, may cause interference to radio communications.

While the system is designed to prevent interference, there is no absolute guarantee it won’t occur in specific setups. If you experience interference with radio or TV reception (which you can confirm by turning the equipment off and on), try the following steps:

  • Reposition or relocate the receiving antenna.

  • Increase the distance between the equipment and the receiver.

  • Connect the equipment to a different outlet, preferably on a circuit separate from the receiver.

  • Seek help from the dealer or an experienced radio/TV technician if needed.

For further safety and precaution guidelines, you can download the relevant documentation from http://www.barix.com.

Find your distributor on this list for more hardware.

For questions that are extending the documentation, feel free to contact us on:

International: +41 434 33 22 22
USA: +1 866 815 0866
Email: support@barix.com

All information and the use of this product including all services are covered under the Barix Terms & Conditions and our Privacy Policy. Please follow the Safety and Precaution Recommendations. Barix is a ISO 9001:2015 certified company. All rights reserved. All information is subject to change without notice. All mentioned trademarks belong to their respective owners and are used for reference only.

JavaScript errors detected

Please note, these errors can depend on your browser setup.

If this problem persists, please contact our support.