# Run your screens

See each screen's status, screenshots and health, send it commands, set its hours and what it shows when stopped, and control its display panel.

Everything on this page is in the player web app. Every member can see it. Where only an owner can act, the page says so.

## The Screens page

**Screens** lists every screen and group, with its status, size, what is playing now and what is next. It reads again every 30 seconds while the tab is open.

- **Search screens**, or filter by **Site**, **Group** and **Status** (**Online**, **Offline** or **Stopped**). **Needs a look** shows only screens with a problem. **Group by** switches between **Site** and **Status**.
- A pill shows each screen's state: **Online**, **Offline** with how long, **Stopped**, **Never connected** (the PC hasn't called in yet), **Showing black**, **Needs a look**, **Needs a visit**, or **Online, fixed itself**. Other pills warn about **Out of step**, **Not spanned**, **Unassigned** and **Can't play N files**.
- A number at the top, like **3 to set up**, links to the screens that joined with an install key and wait for an owner. See [Install and connect a screen](https://withmestra.com/docs/player/install/#install-on-many-pcs).
- With nothing booked, a screen's row shows a small picture of its last screenshot.
- Above the list, **uptime over 30 days** for the whole fleet, with today so far.

An owner's **Add a screen** button and the **⋯** menu (**Install keys**, **Sites and hours**, **Panel profiles**, **Settings**) sit at the top. For editors and owners the **⋯** menu also has **Put screens in a site…**. An owner also makes a screen group here with **New group**. See [Screen groups and video walls](https://withmestra.com/docs/player/video-walls/). Each screen has its own **⋯** menu:

| Item                | Who             | What it does                                                                                |
| ------------------- | --------------- | ------------------------------------------------------------------------------------------- |
| **Rename**          | Editors, owners | Changes the name.                                                                           |
| **Book**            | Editors, owners | Opens **Book content** with this screen picked.                                             |
| **Site…**           | Editors, owners | Puts the screen in a site, or in a **New site…**.                                           |
| **Stop**            | Editors, owners | The screen shows its stopped picture. Only an owner can start it again.                     |
| **Start**           | Owners          | Starts a stopped screen.                                                                    |
| **Panel and hours** | Owners          | Opens the screen's [panel control](#panel-control).                                         |
| **When stopped…**   | Owners          | Chooses what this screen shows while stopped.                                               |
| **Remove**          | Owners          | The screen stops playing and its key is forgotten. Its bookings end; its play records stay. |

A screen that is offline when you stop it shows "Offline — will stop when it reconnects". If your organisation is read-only, screens stop and start again when it is active.

## A screen's page

Select a screen to open its page. The line under its name says whether it is online, its site and, in a group, its position.

- **Last screenshot.** A picture of everything on the PC's display, not just the player, so a Windows prompt or a blank screen shows. An owner selects **Take a screenshot**. **Compare with what was booked** puts it beside the booked artwork. **Show all** lists earlier ones. Screenshots show everything on the screen at that moment, including anything open on top, such as a notification, a Windows prompt or a technician's window. No sound or camera. Periodic screenshots are kept for 7 days, on-demand screenshots and logs for 30 days, and none of them use your storage allowance.
- **The loop.** **Playing now** and **Up next**. When nothing is playing and nothing is next in the loop, **Up next** shows a booking that hasn't started yet, with when it starts and the screen's time zone, such as "Starts 5:00 pm" or "Starts 18 Nov, 6:00 am".
- **Health.** **Disk**, **Memory**, **Temperature**, **Clock**, **Last seen**, **Up since**, **App version** and **WebView2**. It flags a nearly full disk, a PC running hot and a wrong clock.
- **What it did.** The repairs the screen made by itself. See [Updates and reliability](https://withmestra.com/docs/player/updates-and-reliability/#self-healing).
- **Last 24 hours** and **Uptime.** An hour a tick: online, plays and problems. Uptime over 30 days is shown with and without site power cuts. **Open in Grafana** goes to the [hosted dashboards](https://withmestra.com/docs/player/monitoring/#open-in-grafana).
- **Activity.** Commands, restarts and events, newest first. A finished **Get logs** has a **Download logs** link.
- **Window and frames.** Editors and owners see this fold on a single screen's page. It shows where the screen's window comes from (**Full screen** until its panel profile has one) and lets you add frames. See [Windows and frames](https://withmestra.com/docs/player/windows-and-frames/).
- **Playback.** What the screen can play and the files it can't. See [Show content on your screens](https://withmestra.com/docs/player/showing-content/#what-a-screen-can-play).
- **Updates.** Owners see the update state and **Early updates**. See [Updates and reliability](https://withmestra.com/docs/player/updates-and-reliability/#updates).

### Commands

An owner opens the screen's **⋯** menu and chooses:

- **Restart window** restarts the player's window.
- **Refetch content** downloads the screen's files again.
- **Get logs** asks the PC for its recent log. It has keys and tokens removed, and is only sent when you ask. How it is stored is in the [Privacy Policy](https://withmestra.com/privacy/).
- **Reboot** restarts the PC after you confirm "Reboot (the screen's name)?" It is dark for about a minute.
- **Let a technician in…** opens the Windows sign-in screen for 15, 30 or 60 minutes. **End technician access** brings the kiosk back sooner. See [Get into a screen's PC](https://withmestra.com/docs/player/get-into-a-screens-pc/).

A command waits until the screen picks it up. It shows **Waiting**, then **Done**, or why it didn't work. If the screen doesn't pick it up in time it says "The screen didn't pick this up in time." There is a limit on how often you can ask. Past it, Mestra says "Too many tries. Try again in N min."

The page's **Console** section has checks and actions for the PC, such as its time, network and disk. See [The screen console](https://withmestra.com/docs/player/screen-console/).

### Screenshots every

Under **Settings** > **Screenshots**, an owner chooses **Screenshots every**: **Off**, **15 min**, **30 min** or **1 hour**. Periodic screenshots are off unless an owner turns them on.

## Sites

**Sites** groups your screens by site and shows each site's uptime over 30 days. An editor or owner selects **New site** on **Sites**, names it, gives it a short code and picks its screens. An owner can also set its time zone, and every screen in the site keeps time in it. The time zone lists are searchable: start typing a place. An owner can set a whole site at once under **Site settings**, which sums itself up as "Location, hours, brightness and power". A screen can have its own settings, which win over its site's.

## Network bookings

If your organisation runs a Mestra Network, its bookings can use your Mestra Player screens.

- **Free slots show when the loop is set.** A screen shows free slots only when the screen, its site or your organisation has a **Loop length** and a **Default slot length** set (see [Who plays when](https://withmestra.com/docs/player/loop/)). Without them, a booking on that screen is a request: nothing says how full the screen is, and Mestra never picks a loop for you. House content doesn't take a slot.
- **A held slot plays nothing.** A request holds its slots until staff answer. A held slot is reserved on the screen but doesn't play, and it is let go if the request is declined or runs out of time.
- **An approval publishes.** When staff approve the booking, its artwork is booked on the screen. A screen that can't play the file, for example one too small for it, is left out.

## When a screen is stopped

A stopped screen shows black, your logo, an image or a video. Under **Settings** > **When stopped, show**, an owner picks for all screens:

- **Black**.
- **Logo**, from a PNG or JPEG logo on a brand.
- **Image**, a PNG or JPEG you upload.
- **Video**, an MP4 you upload. It plays on a loop, without sound.

A site can have its own choice on **Sites**, and a screen can have its own from its **⋯** menu, **When stopped…**. The most specific choice wins. A screen that can't play the stop video shows black, and its page says why.

A screen is stopped when an owner or editor stops it, when a takedown reaches it, or when your organisation is read-only.

### Between ads

Under **Settings** > **Between ads**, an owner chooses **Cut** or **Fade** for all screens. A screen's **Playback** section can use its own choice, or **Same as all screens**.

## Panel control

Mestra Player can switch a display panel on and off on your hours, and set its input, brightness and sound. It works over a serial cable (RS-232) or over your local network.

### Hours, brightness and power

An owner sets these on **Sites** > **Site settings** for a site, or per screen under **Panel and hours**. A screen chooses **Same as site** or its own.

- **Time zone.** Hours are read in the screen's time zone. A site with none of its own uses its screens' zone.
- **Hours.** Set an on and off time for each day, then **Save hours**. **Copy to all days** repeats a day. With no hours, "Mestra won't turn the panel on or off."
- **Brightness steps.** Times of day and a brightness percent for each, then **Save brightness**. With no steps, the panel's brightness is left alone.
- **Sound.** **On** or **Off**. Off means ads play muted. On means each booking plays at the volume you set for it, and a booking with no volume is muted. You can also set a **Panel volume**.
- **If someone changes the panel at the screen.** **Put it back**, or **Leave it until the next switch**.
- **Power.** Turn a site or screen on or off now, for a time you choose. **Back to hours** returns to the schedule.

The player works out the commands itself, so a reboot, an offline day or a daylight saving change needs nothing special. No plays are recorded while the panel is off, and the uptime record leaves out the time the panel is off by its hours.

### Link a panel

1. Open the screen's **⋯** menu and choose **Panel and hours**.
2. Under **Panel link**, choose a **Panel profile**.
3. Choose the **Connection**: **Cable** (then the **COM port** and **Speed**) or **Network** (then the **IP address**). Enter the panel's **ID** if the profile asks for one.
4. Optionally choose an **Input** to switch to. **Leave as it is** changes nothing.
5. Select **Save panel link**, then **Test panel**. It sends each command in the profile once and shows what the panel answered. Tick **Include power** to test switching the panel off and on too. The screen goes dark for a moment, so Mestra asks you to confirm with **Test with power**.

### Panel profiles

A profile describes how to talk to a make of panel: how to connect, how a command is framed, and what each reply means. Mestra includes these. They were written from each maker's public protocol documents, and none has been checked on a real panel of each family yet. The panel link says "Not yet tested on this hardware." Use **Test panel** on every panel before you rely on it.

| Profile                              | Connection                   | What Mestra can set                    |
| ------------------------------------ | ---------------------------- | -------------------------------------- |
| Samsung MDC                          | Cable or network (port 1515) | Power, input, brightness, volume, mute |
| LG                                   | Cable or network (port 9761) | Power, input, brightness, volume, mute |
| NEC / Sharp NEC                      | Cable or network (port 7142) | Power, input, brightness, volume       |
| Philips SICP                         | Cable or network (port 5000) | Power, input                           |
| Sony BRAVIA Professional (Simple IP) | Network (port 20060)         | Power, input, mute                     |
| Panasonic (serial)                   | Cable                        | Power, input, mute                     |
| Panasonic (LAN, Protocol 2)          | Network (port 1024)          | Power, input, mute                     |
| PJLink class 1                       | Network (port 4352)          | Power, mute                            |

Under **Panel profiles**, an owner can copy a built-in profile and change it, or make their own. A profile can also carry a window, for a screen that plays in one part of the PC's output. See [Windows and frames](https://withmestra.com/docs/player/windows-and-frames/). A profile of yours is checked before it can be saved, and a screen using one shows **Unverified**. Delete a profile by first moving its screens to another.

### While the PC restarts

If the PC has to restart, the panel can show the stop show from its own storage. Under **Panel and hours** > **While the PC restarts**, an owner chooses **Play the stop show from the panel** and the input. Then:

1. Select **Download the stop show file**.
2. Copy it to the panel's USB stick or internal storage, and set the panel to play it on that input.
3. Tick the box to say the panel holds it.

Mestra does this only after you say the panel holds the current file. If the stop show changes, the confirmation no longer counts until you confirm the new file. Time spent holding counts as down in the uptime record and is reported separately.
