Qmatic Show Manual

Document: 233.01I — Qmatic

Copyright Notice

The information in this document is subject to change without prior notice and does not represent a commitment on the part of Q-MATIC AB. All efforts have been made to ensure the accuracy of this manual, but Q-MATIC AB cannot assume any responsibility for any errors and their consequences. This manual is copyrighted and all rights are reserved. Reproduction is not allowed without written permission from Q-MATIC AB.

1. Introduction

1.1 Overview

Qmatic Show is a media player for Orchestra 7 and Solo. It enables a media display to show images, video, live TV, context marketing messages, and customer journey information on Samsung professional TV displays.

1.2 Main Features

Easy to configure
Support for portrait or landscape orientation
Caching of files (Orchestra only)
Live TV (Orchestra only)
Error log repository
HTTP/HTTPS support (Orchestra only)
Automatic upgrade

2. Prerequisites and Preparations

2.1 Preparations Checklist

Preparation Step	Check	N/A
Orchestra 7 or Solo system installed.
Orchestra or Solo prepared and configured for Qmatic Show. See sections 2.7 and 2.8.
Samsung TV installed, configured, and connected. See sections 2.2 and 2.5.
Qmatic Show zip file available. See section 2.3.
FAT32 or NTFS formatted USB available.
Correct licenses in place. See section 2.6.

2.2 System Requirements

Qmatic Show is only supported by Qmatic Orchestra 7 and Solo. Earlier Orchestra releases are not supported.

2.3 Required Software

Download the Qmatic Show zip file from Qmatic World. It contains:

QmaticShow.wgt — For new installation (SSSP folder)
QmaticShow.utt — Unit type file (utt folder)
qmaticshowTV.wgt — TV widget (widget folder)
qmaticshowDing.wgt — Ding widget (widget folder)
QmaticShow.war — For upgrade
config_xx.xml — Configuration template (SSSP folder)
sssp_config.xml — Install configuration (SSSP folder)
readme.txt and release notes

2.4 Required Hardware

2.4.1 Samsung TV Display

Qmatic Show requires a Samsung TV display from the SMART Signage family. Tested models include:

Samsung PM32F, DB43J, DB49J, PM55H, QM55H, QB43R, QM55B

Any SSSP4, SSSP5, SSSP6, SSSP7, or SSSP10 display can be used, though not all have been tested. If using a newly released model and you see a security warning or the app does not work correctly, contact Qmatic support for an updated version.

2.4.2 Remote Control

Menu navigation and application configuration are handled with the Samsung TV remote control.

2.5 Samsung TV Setup

Configure the Samsung TV according to these recommended settings:

Orientation — Select landscape or portrait. For portrait mode, turn the display 90 degrees clockwise. Mounting upside down is not supported.
Set Auto power off to off.
Connect to a network and set date and time.
Select URL Launcher as the play mode (not MagicInfo).
Optionally, assign a device name.
Select and note a PIN number for the TV.
In the Home menu, use the On/Off timer to turn the TV off during non-office hours and on before opening. For the On timer, select URL Launcher as the source so Qmatic Show starts automatically. Also set the startup volume.

2.6 Licensing

At least one of the following licenses is required:

Orchestra: Media Display or Digital Signage (both scaled per unit — one license per display)
Solo: Solo License with media option

Feature	Media Display (Orchestra)	Digital Signage (Orchestra)	Media License (Solo)
Static images	✓	✓	✓
Static text	✓	✓	✓
Scrolling text	✓	✓	✓
Caching of playlists		✓
Live TV		✓
Customer journey information	✓	✓	✓

2.7 Orchestra Preparations

Qmatic Show is only supported by Orchestra 7.

2.7.1 Surface Editor

Set up a media display in Surface Editor in Orchestra. 1080 Full HD is recommended. For 4K displays, create a generic media surface type with a resolution matching the display — Qmatic Show does not auto-adjust its surface to the TV resolution.

Supported content: If using the Digital Signage license with a channel player, ensure playlist content is in formats supported by the Samsung display. Refer to Samsung documentation for supported formats; convert files if needed before proceeding.

Qmatic Show Ding Widget (plays a sound when a customer is called):

Go to System Administration > Widgets.
Click Qmatic Show Ding widget and select a surface type. Upload it if not listed.
In Surface Editor, drag the widget to the desired surface.

Use the latest version of the Ding widget with a sample rate of 44.1 kHz. It is recommended to place the Ding widget on a call page and avoid a transparent background.

Ding Widget Limitations:

SSSP4: Video in the channel player pauses while the Ding widget plays.
SSSP5 and later: Sound mutes but video continues playing while the Ding widget plays.

TV Widget (for live TV):

Go to System Administration > Widgets.
Click Qmatic Show Live TV and select a surface type. If not listed, upload qmaticshowTV.wgt from the widget folder.
In Surface Editor, select either HDMI or TV as the source. Note that not all displays support TV content.

TV Widget Limitations:

Video in the channel player cannot be shown simultaneously with the TV widget (two videos cannot play at once).
No widget can be placed above the TV widget. Place call widgets on a separate call page instead.
If using a widget with sound (e.g. the Ding widget), use videos without sound.

2.7.2 Qmatic Show Unit Type

In System Administration, add QmaticShow.utt to your unit types (found in the utt folder). Configure at this level:
- Bandwidth limit — Maximum bandwidth (kbit/sec) for downloading media content.
- Media update time — Interval (minutes) for checking Orchestra for new content.
In Business Configuration, add the Qmatic Show unit type to the equipment profile for the branch. Add one unit type entry per display (five displays = five entries, each with a unique Unit ID). Configure at this level:
- Unit id — Must be unique per display.
- Media application — Select the Media Display surface created for Qmatic Show.
- Queues — Queues the display should show visits from (in combination with service points set at branch level).
- Min display time — Minimum time (seconds) a visit number is displayed before the next visit can be called.
On the Branches tab, configure:
- Service Points
- ServicePoints to the left
- ServicePoints to the right

2.8 Solo Preparations

For Solo system setup, see the Media Display chapter in the Solo Reference Manual.

3. Installation

Before installing the app on the TV, configure the settings in the configuration file. Installation modes: Orchestra, Solo, or Browser mode.

3.1 Installation Settings for Orchestra

Unzip the Qmatic Show zip file.
In the SSSP folder, open config_orchestra.xml.
Enter values matching your environment:
- <SYSTEM>: ORCHESTRA
- <HOST>: Hostname or IP address (e.g. demo.qmatic.com — do not include http://)
- <IS_SSL>: true if SSL is enabled, false if not
- <WS_PORT>: WebSocket port:
```
WS distributed:  18888
WS central:       8888
WSS distributed: 18989
WSS central:      8989
```
- <BRANCH_PREFIX>: Branch prefix (found in Business Configuration > Branches)
- <UNIT_ID>: Unit ID from the equipment profile — must be unique per display
- <PIN>: PIN number for opening the Qmatic Show menu
Rename the file to config.xml, save, and delete the other .xml files.

Any settings not configured in config.xml must be entered manually using the remote control after installation.

3.2 Installation Settings for Solo

Unzip the Qmatic Show zip file.
In the SSSP folder, open config_solo.xml.
Enter values matching your environment:
- <SYSTEM>: Solo
- <HOST>: Hostname or IP address (no http://)
- <PORT>: Port number
- <DISPLAY_NO>: Display number — must be unique per display
- <START_PAGE>: Start page URL
- <PIN>: PIN number for the Qmatic Show menu
Rename the file to config.xml, save, and delete the other .xml files.

3.3 Installation Settings for Browser Mode

Unzip the Qmatic Show zip file.
In the SSSP folder, open config_Browsermode.xml.
Enter values matching your environment:
- <SYSTEM>: BROWSER_MODE
- <HOST>: Hostname or IP address (no http://)
- <IS_SSL>: true or false
- <PORT>: Orchestra port number
- <BRANCH_PREFIX>: Branch prefix
- <UNIT_ID>: Unit ID — must be unique per screen per branch
- <PIN>: PIN number for the Qmatic Show menu
Rename the file to config.xml, save, and delete the other .xml files.

3.4 Install Qmatic Show Using the USB

Copy the SSSP folder to the root of a FAT32 or NTFS formatted USB drive.
Insert the USB into the TV.
Press HOME on the remote control.
In the Home menu, select URL Launcher Settings. If not visible, go to Menu > System > Play via and select URL Launcher.
Select Install from USB device.
Enter the PIN for the TV.
The app starts automatically.
If configuration needs to be completed, press Info on the remote control to open the Settings menu.

If Orchestra is installed using localhost, Qmatic Show will not be able to connect and will display a notification. You will also be notified if the license is invalid.

3.5 Install Qmatic Show as Web App

Deploy QmaticShow.war to Orchestra:
- Orchestra Central: Go to the application server (Wildfly) and deploy QmaticShow.war.
- Distributed Queue Agents: Create a new agent profile, add QmaticShow.war, run a remote upgrade, and publish the affected branches. See the System Administration chapter in the Reference manual.
Press HOME on the remote control.
In the Home menu, select URL Launcher Settings. If not visible, go to Menu > System > Play via and select URL Launcher.
Select Install Web App.
Enter the URL: <orchestra URL:port>/QmaticShow (e.g. http://10.20.0.40:8080/QmaticShow).
The application starts automatically.
Press Info on the remote control to complete the configuration.

4. Upgrade

4.1 Upgrade Qmatic Show with Orchestra

Open the Qmatic Show menu and set Automatic upgrade to Enabled. Set an upgrade time when the screen is turned on (default: 02:00).
Deploy QmaticShow.war to Orchestra:
- Orchestra Central: Deploy via Wildfly.
- Distributed Queue Agents: Create a new agent profile, add QmaticShow.war, run a remote upgrade, and publish affected branches.
At the set upgrade time (or next manual restart), Qmatic Show automatically detects and applies the new version.
After upgrade, remove the war file from Orchestra Central and set Automatic Upgrade to disabled.

Qmatic Show cannot distinguish older from newer versions. If the version deployed on Orchestra is older than the version running on the TV and Automatic Upgrade is enabled, the app will downgrade.

4.2 Upgrade Qmatic Show with Solo

Open the Qmatic Show menu and set Automatic upgrade to Enabled. Set an upgrade time when the screen is on (default: 02:00).
Start the FTP client in the Solo system.
Connect using an FTP client (e.g. WinSCP).
Navigate to /qwin/media.
Create a folder named QmaticShow.
Copy QmaticShow.wgt and sssp_config.xml to this folder.
At the set upgrade time (or next manual restart), Qmatic Show detects and applies the new version.
After upgrade, set Automatic Upgrade to disabled.

Qmatic Show cannot distinguish older from newer versions. If the version in the Solo media folder is older than the version running on the TV and Automatic Upgrade is enabled, the app will downgrade.

5. Uninstallation

Clear the cache and log before uninstalling. Uninstalling the app alone does not remove cache and log files.

Clear the log and cache in Qmatic Show (see sections 6.3.4 and 6.3.5).
Press HOME on the remote control and go to URL Launcher Settings.
Select Uninstall — QmaticShow and confirm.

6. Using Qmatic Show

6.1 Start Qmatic Show

Press the HOME button on the remote control and select the Qmatic Show icon. If the icon is not visible, verify the app is installed and the system is set to play via URL Launcher.

6.2 Open the Menu

Press the Info button on the remote control. The Enter PIN window appears first. The default PIN is 0000 — it is strongly recommended to change this (see section 6.3.3).

There are two separate PINs: one for the TV and one for the Qmatic Show app.

The menu contains the following tabs: Settings, Automatic upgrade, Change PIN, View Log, Cache, About. The menu closes automatically after 60 seconds of inactivity.

6.3 Menu Choices

6.3.1 Settings

When the menu opens, the Settings tab is displayed by default. Settings configured in config.xml are shown here and can be overridden. Select the Connection mode first: Orchestra, Browser Mode, or Solo.

Orchestra Settings:

Server IP — Hostname or IP address (e.g. demo.qmatic.com, no http://)

Websocket Port:

WS distributed:  18888
WS central:       8888
WSS distributed: 18989
WSS central:      8989

Branch Prefix — From Business Configuration > Branches
Unit ID — From the equipment profile; must be unique per display
SSL — Whether SSL is enabled

Select Save and restart when done.

Solo Settings:

Server IP — Hostname or IP address (no http://)
Port Number — Port Qmatic Show should connect to
Display Number — Display number in Solo
Start Page — Start page URL

Select Save and restart when done.

Browser Mode Settings:

Server IP — Hostname or IP address (no http://)
SSL — Whether SSL is enabled
Port Number — Port to connect to
Branch Prefix — Branch prefix
Unit ID — Must be unique per screen per branch

Select Save and restart when done.

6.3.2 Automatic Upgrade

Select Enabled to turn on automatic upgrade.
Select an upgrade time (hour).

If an On/Off timer is configured for the screen, ensure it is not turned off during the upgrade time.

6.3.3 Change PIN

Enter the current PIN number.
Enter the new PIN twice to confirm.

6.3.4 View Log

Configure log settings:

Select log type to register:
- Info — Registers info, warnings, and errors
- Warnings — Registers warnings and errors
- Errors — Registers errors only
Select which log type to view.
Press Clear to clear the log.

Export log to USB:

Insert a USB stick.
Go to Copy log to USB and select Copy.
Confirm the success message, then verify the file QmaticShowLog-<date>.txt on the USB.

If the copy fails, check that the USB is not full, not write-protected, and has a valid file system.

6.3.5 Cache

Available for Orchestra with the Digital Signage license. The bar shows cached content volume (maximum 2 GB). Press Clear to clear the cache.

Qmatic Show downloads content using the bandwidth limit defined in the unit type, and connects to Orchestra at the configured interval to check for new content.

6.3.6 About

The About tab displays: app version number, copyright information, and the IP address of the Samsung TV.

6.4 Nightly Reset and Publish

Qmatic Show is restarted at nightly reset. For Solo, install the patch that supports this (found on Qmatic World).
Qmatic Show is restarted when a branch is published in Orchestra.

6.5 Troubleshooting — Orchestra

Error Message	Comment
Communication channel break, restart communication channel… Please wait	Communication channel is trying to reinitialise.
Failed to connect to QAgent, Reason: User timeout caused connection failure	Connection cannot be established with the QAgent host.
Central server host address mismatch	The user-given host address and the one returned from the WebSocket do not match.
Central server is incorrectly configured with localhost	The Orchestra server was installed using localhost instead of the real address.
RESET — Application try to restarting…	A reset event was received from the WebSocket. A branch may have been published.
Unit id should be unique for device. Please contact your system administrator	The configured Unit ID is not unique.
Error in connection establishment, please check configuration and restart	The WebSocket connection was closed due to a configuration error (e.g. invalid branch ID).
Invalid Orchestra license. Please contact your System Administrator	License is invalid.
Unsupported	Content is unsupported. The channel player skips unsupported content. If the last content item in a playlist is unsupported, the channel player stops looping and displays black.
Corrupted	Content is corrupted, or there may be a network connection issue.

6.6 Troubleshooting — Solo

Error Message	Comment
Licensing error: No ‘Media’ option present.	License is invalid.
Connection to the server lost. Retrying…	Connection to the Solo server has been lost.

Q-MATIC AB, Box 198, SE-431 23 Mölndal, Sweden. Phone: +46 31 756 46 00. Email: info@qmatic.com. Web: www.qmatic.com

233_01I_Qmatic_Show_manual.pdf
1000 KB Download