TV Manager

TV Manager is where TVs are installed, set up and watched: the list of TVs, the presets they follow, the apps they show, and their status. It is used by installers β€” often from a phone next to the TV β€” and by whoever looks after the TVs day to day. You need the Devices area β€” see Areas and roles. For the steps on site, see TV Installation; for the order to set up a whole site, see Setting up a site.

Screen For
TVs The installed TVs, Add TV, Import list (many TVs from a CSV/Excel list), re-linking
TV Presets The IDCAP settings TVs follow β€” several presets, one per kind of TV
TV status β†’ Status Which TVs are online and set up right now
TV status β†’ History TV checks over time

Templates β€” the look, the features (which TV app and features a room or guest gets β€” below) and where each is deployed β€” are in Content Manager β†’ Templates.

The old TV Manager app is part of the console now; its old addresses still open the matching screen β€” including the QR codes on TVs installed earlier.

TVs

The TVs screen lists every room with the TV installed in it β€” serial number, model, state and registration date β€” or No TV, with Add TV for that room (it opens Add TV with the room filled in). Show switches between all rooms, rooms with a TV and rooms without one. A TV registered to a room number that is not in the room list is shown too, marked not in the room list. It updates live.

On a site with a demo room, Open demo TV β†— in that room's row opens the room's TV app in a new browser tab, for presenting without a TV β€” see the Demo Guide. The link works for 12 hours. The TV app does not open in a browser without such a link, so nobody can connect a phone to the demo room from the public address.

State Meaning
🟒 Online The TV is running and reporting in
🟑 Online · screen off Running; the screen was turned off
βšͺ Offline Not reported in for more than about a minute
Inactive Deactivated β€” out of service
Preset: reboot needed A TV Preset setting takes effect at the TV's next restart
Preset failed The TV could not apply a setting; the detail says which
Collecting logs until … The TV is sending its logs β€” see TV logs

To turn a screen off and on or restart a TV, use the room on Rooms.

The β‹― menu of each TV has:

The address to give installers

Add TV starts with it β€” step 1 Β· Head-end shows the ProCentric server address, port and protocol that are set in the hotel's TV head-end before the first TV, with a link to the installation guide.

Adding a TV

Press + Add TV on the TVs screen. The screen works on a phone, which is how it is usually opened: a TV that is not registered shows a QR code when it starts, and scanning it opens Add TV with the TV already filled in (sign in first if asked).

  1. Choose the TV.
    • QR on the TV β€” scanning the TV's QR code fills this in; there is nothing to type. Scan it with the phone's camera app, or open Add TV first: it starts the camera and reads the QR code itself (allow camera access when asked). The screen shows the TV's serial number, model, and network address so you can check it is the right TV. If camera access is blocked, the screen explains how to allow it β€” see TV Installation.
    • Serial number β€” registers a TV by its serial number: in advance from the label (pre-registration), or without a camera from the serial shown on the TV's setup screen. On a phone, Scan barcode reads the barcode next to S/N on the label and fills the number in. A TV that is showing its QR code picks the registration up right away; a TV that is off sets itself up when it is switched on.
  2. Choose the site and room. Only sites where you can operate Devices are listed. Pick the room from the site's rooms (a room that already has a TV shows how many), or pick + New room… at the end of the list and type the number:
    • The TV is added to the room. A warning says which TVs are already there and whether a guest is checked in.
    • A new room number creates the room. Choose from the list goes back to the list. A site with no rooms yet asks for the number straight away.
    • Administrators for all sites can also pick + New site… to create a site β€” see New sites.
  3. Press Register TV (or Pre-register TV).

After Register TV the TV picks up the registration within a few seconds, applies the preset, restarts if a setting needs it, and opens the guest app. Nothing needs to be done on the TV.

A TV's QR code stays valid while the TV shows it, and changes when the TV restarts. If the TV is not found, scan the QR code on the TV again.

Many TVs at once β€” import a list

To pre-register a whole floor or building, press Import list on the TVs screen and give it a list of serial numbers and room numbers β€” one TV per line.

  1. Choose the site. Only sites where you can operate Devices are listed.
  2. Give the list. Press Download template (CSV) for a ready-made file, fill in two columns β€” serial_number, room_number β€” and upload it with Choose file…. CSV and Excel (.xlsx) files both work; you can also copy the two columns in Excel and paste them into the box, and edit the list there. The header line is optional (a header in another column order, or in Korean, is understood), blank lines and lines starting with # are ignored β€” so the template can be uploaded unchanged without registering anything. Old .xls files must be saved as .xlsx or CSV first.
  3. Check. Before anything is registered the screen shows, for every line, what will happen: Register, Register Β· new room (the room does not exist yet and is created), Already registered β€” skipped (that TV is already in that room), or Registered elsewhere (that TV is registered to another room β€” remove it first in the TVs list, then import again). Lines with a problem are listed with the reason and left out: a missing serial number or room, a serial number with spaces, a room that is not 1–10 letters, digits or dashes, or the same serial number twice for different rooms. A serial number with lower-case letters is accepted with a note β€” it has to match exactly what the TV reports.
  4. Press Pre-register N TVs. They are registered one by one, with progress; each line then says Pre-registered or why it failed. Up to 500 TVs at a time.

Each TV is pre-registered exactly as with Add TV β†’ Serial number: it sets itself up the first time it is switched on. Until then it shows as Not installed yet.

Moving or re-installing a TV

To move a TV to another room, restart it after its stored data was cleared, or Remove its registration and restart it. It shows its QR code again; register it with Add TV and the new room. Registering a TV that is already registered moves it β€” the Add TV screen says where it is now.

A deactivated TV that restarts also shows its QR code. Registering it again reactivates it.

TV logs

When a TV misbehaves β€” a key does nothing, an app does not open, the screen stays blank β€” its logs show what the TV app saw. TVs send no logs normally; you switch it on for one TV, for a limited time.

  1. On TVs, open the TV's β‹― menu β†’ Logs.
  2. Choose how long β€” 30 minutes, 2, 8 or 24 hours β€” and Start collecting. The TV starts within 30 seconds if it is on and the TV app is running; a TV that is off starts when it is back on.
  3. Do on the TV what you want to look at. New lines appear every few seconds.
  4. Stop, or let it stop by itself at the time shown.

The log has the TV app's console messages, app errors, the remote keys the TV app receives (their key codes) and IDCAP calls that failed (TV settings, apps, power). Filter by level β€” Info (the default), Warnings, Errors, or Debug too, which adds the TV's own record of every IDCAP call β€” and by source, find words, and Download the lines as a text file to send with a support request. Times are the TV's clock.

Remote diagnosis

When something on a TV looks wrong in the field β€” no picture, the network drops, the TV is slow β€” the TV's own LG diagnostics and LG's log files help find the cause. Use it only when needed: nothing runs until you open a diagnosis, and it closes by itself.

  1. On TVs, open the TV's β‹― menu β†’ Diagnose.
  2. Choose how long it stays open β€” 15 or 30 minutes, 1 or 2 hours β€” and whether to Also collect LG log files, then Open diagnosis. A TV that is on starts within a few seconds; a TV that is off starts when it is back on.
  3. The Diagnostics card shows what the TV reports about itself: Device (model, firmware), System (memory, CPU, power state), Network, Channel and Pro:Centric. Read again reads it once more; Download JSON saves it.
  4. With log files, the TV turns on LG's debug logging. Reproduce the problem on the TV now, then Collect logs and finish. It takes up to a minute.
  5. Without log files, Finish when you are done β€” or let it close at the time shown.

Log files lists what the TV sent: si.log is the TV's console log as plain text (View opens it), pmlog and dblog are encrypted by the TV for LG β€” send them to LG support with the TV's model and the time of the problem.

Rescue from another TV

Sometimes the TV app or the TV's browser stops: the TV shows a frozen or blank screen and no longer takes commands from the console (Power, Reload, Diagnose do nothing). Another TV on the same network β€” the helper TV β€” can then call the stopped TV's LG remote management (RMS) directly.

Set up once: on TVs, open any TV's β‹― menu β†’ Rescue from another TV, and under Helper TV choose one TV, best one in a staff area (back office, engineering) on the same network as the guest-room TVs β†’ Save. Within a minute, every other TV whose app is running sets its LG trusted IP (rms_trusted_ip) to the helper's address. The page shows it for each TV under Trusts the helper TV.

Rescue a TV: on the stopped TV's β‹― menu β†’ Rescue from another TV, then:

History shows each request and its result. The helper does a request within seconds if it is on; a request it does not pick up within 10 minutes is dropped. The TV does not answer means the TV is off, unplugged or on another network; does not trust the helper TV means the trust was not set up before the app stopped. Rescuing needs Devices β€” Operator.

Re-link lets a TV that lost its stored data (a factory reset, a re-installed TV app) reconnect to its room by itself, for the next 15 minutes. A TV that is showing its setup QR code picks it up within a few seconds; a TV that is off or showing something else does when its TV app restarts. Check-out opens the same window automatically.

Most reset TVs do not need Re-link any more: an installed TV recognises itself and reconnects from its own setup screen. Re-link is for a TV the server cannot recognise yet β€” one installed before this, which has not been online since. (A TV that was only pre-registered has no key yet and sets itself up without help.)

A reset TV reconnects by itself

Every online TV reports its LG unique device ID (LGUDID β€” read by the TV app, not printed on the TV) and the server keeps it with the registration. When an installed TV loses its stored data (a factory reset, a re-installed TV app), it asks the server again, and the server answers only if both the serial number and the device ID match. Its setup screen then shows Reconnect this TV with the site and room, and three buttons:

Nothing needs approving in the console. A TV that has just connected β€” this way, with Add TV, Re-link or for the first time β€” shows New next to its serial number in TV Manager β†’ TVs for 24 hours.

A device that only knows the serial number (it is printed on the back of the TV) cannot reconnect this way β€” it gets the QR code like any new TV. So does a TV the server has no device ID for yet: one installed before this, until it has been online once with the new TV app, or a TV whose software cannot read the ID.

TV Preset

The TV Preset screen holds the TV settings the TVs follow. You can keep several presets β€” for example one per TV model, or a special one for suites β€” and each room follows one of them. A room that has not been given a preset follows its room type's preset, and otherwise the hotel's default preset β€” the Rooms list shows where each room's preset comes from.

A TV applies its room's preset when it is set up and again every time it starts, so changes reach installed TVs too. To apply a change right away, press Apply to online TVs; the screen reports how many TVs are up to date, need a reboot, or did not answer.

Working with presets

A good order for a new type of TV or room:

  1. New preset β€” give it a name. Start from a copy of an existing preset is the quickest way to make a variant.
  2. Install one test TV in a room and give that room the new preset (Rooms at the bottom of the screen). The TV applies it straight away.
  3. Try it, and adjust the settings until the TV behaves the way you want.
  4. When it is right, tick the other rooms and press Give to … ticked. Their online TVs apply it immediately; TVs that are off apply it when they start.
  5. A different kind of TV needs its own preset: start again from step 1.

Other things you can do: Make default (the preset rooms follow when they have none), Rename, Delete (rooms that used it go back to the default), and Import from another site β€” copy a preset from another hotel you manage. You get your own copy; changing it later does not change the original.

TVs are never restarted automatically for a preset change β€” a guest may be watching. A setting marked Reboot: Required takes effect at the TV's next restart (check-in, check-out, or Reboot on Rooms). Until then the TVs screen shows Preset: reboot needed for that TV.

Column Meaning
Key The name of the TV setting
Value The value the TV is set to
Label The text shown on the TV's setup screen
Reboot Whether the TV must restart for the setting to take effect
Status Only Active settings are applied

Press Add setting, or Edit on an existing one.

The default preset

Key Value Purpose
display_resolution 1920x1080 Full HD output
tv_channel_attribute_floating_ui 0 Hides the floating channel banner. Set first, as soon as a new TV shows its setup QR code β€” before the site and room are chosen β€” so the banner does not cover the setup screen; tried again every 5 seconds for a minute if the TV is not ready yet. The other settings follow after the room is chosen
browser_debug_mode 0 Keeps the TV's remote debugger closed β€” read a TV's logs in TV logs instead. Set 1 only in a preset for a development TV
instant_power 2 Lets the console turn the screen off and on
tv_channel_ui 0 Hides the TV's own channel banner at the top (shown when the TV turns on or a smart app closes) β€” the hotel app shows its own

Settings to be careful with

If the preset cannot be loaded during installation, TVs fall back to the default preset above, so installation is never blocked.

Features & rooms

In the console: Content Manager β†’ Templates β†’ Features & rooms. Two things, simply:

Rooms with their own template (folded, at the bottom) sets a single room apart from its type β€” the same as Deploy β†’ Single rooms. What a room gets is decided in this order: a guest's template chosen at check-in β†’ the room's own β†’ its room type's β†’ the site default.

App activation

Some apps β€” Netflix, Amazon Prime Video and Google Cast β€” only start on a TV after the registration token the app company issued under the hotel's contract has been registered on it (IDCAP application/register). Whether each of those apps is activated on the TVs is shown in Content Manager β†’ Watch β†’ Apps β€” under each app that needs a token, Activated on N of M TVs β€” with Register on N online TVs next to Upload tokens…. TVs with an app that is not activated show up on the Dashboard.

TVs register the tokens every time the TV app starts β€” when it loads and after every reboot β€” whether or not the hotel has uploaded a token, and even when the TV cannot reach the server (it then uses the token built into the TV app). The tokens are the ones built into the TV app with the hotel's own on top: if the hotel uploaded a token for an app (Content β†’ Smart Apps) the TV uses that one, otherwise the built-in one. If the TV refuses them all at once, it registers them one by one so a single bad token does not block the others, and it tries again a few seconds later (right after boot the TV may still be waking up). Then it asks the TV whether each app is activated (application/register/status) and reports the result here. The token itself is never shown.

Google Cast is listed under its guide app, but its token is registered for the Cast service itself (com.webos.chromecast) β€” that is the part that must be activated for casting to work. Once it is, the TV also checks that the three Cast apps β€” the service, the guide app and Google Cast Settings β€” are installed, and installs any that are missing (application/install; the TV downloads them in the background and Cast becomes ready a few seconds later).

Status and History

Status (under TV status) shows which TVs are working. The menu item carries a number when a TV needs attention.

History lists those TV checks, newest first. Tick Problems only to see just the failures.