Mestra Player
Install and connect a screen
Install Mestra Player on the PC behind each screen, then add the screen in Mestra. Only an owner can add screens.
Get the player
Download Mestra Player from the player web app. Only editors and owners can. A reviewer sees “Only editors and owners can download Mestra Player”.
- In the player web app, open Add screens.
- Find the Get Mestra Player row. It shows the version, and that it is for Windows 10 and 11. Select See releases and download.
- On the Mestra Player releases page, find Latest release. Select Download for Windows for a PC with an x64 processor, or Arm for an Arm PC.
- Unpack the download on the PC. This is the release folder.
The page also shows each download’s size and its SHA-256 hash, so you can check the file you have. If it says “The download isn’t ready yet”, try again later.
- Older releases lists earlier versions with their notes. You can’t download them.
- A version marked Beta is a beta release.
- If your organisation has screens on Early updates, the page also shows a Release candidate. It is for screens on Early updates and is not the release yet. See Early updates.
- If a message says “That build has changed. Reload the page to see the current one.”, reload the page and download again.
An installation partner downloads from Add screens inside the customer they are setting up. See Installation partners.
Install on one PC
- On the PC, open an elevated prompt in the release folder.
- Run
mestra-player install. It checks the Windows edition and build, sets up the player and locks the PC down for the screen. If Windows must restart first, install says so. Restart and run it again. - Restart the PC. It signs itself in and the screen shows a pairing code, like
ABCD-EFGH. The code is shown for 30 minutes after install. Runmestra-player installagain to get a new 30 minutes. - In the player web app, open Add screens and select Add a screen.
- Type the Code on the screen and a Name, then select Check code.
- Check that the size, time zone, last seen time and PC maker shown are the screen in front of you. Select Add this screen.
The screen then appears on the Screens page and starts playing what is booked for it. A code on a public screen can be read by anyone, so outside the 30 minutes the screen shows no code.
Install on many PCs
Use an install key. The PC joins your organisation by itself, with no code at the screen.
- In the player web app, open Add screens and select Install keys.
- In Key for, say who or what the key is for, so you know which to revoke. Optionally set Expected screens.
- Choose when the key ends: No expiry, 24 hours, 7 days, 30 days, 90 days or Pick a date and time. A picked date and time are in your organisation’s time zone, which the dialog names, and the time is 11:59 pm unless you change it. An owner sets the zone in the Mestra app, under Settings > General: see Time zones. Tick Email owners if this key is tried after it ends if you want to be told.
- Select Make key. Copy the key or select Download key file. It isn’t shown again.
- Install each PC with the key file:
mestra-player install --install-key-file <file>. Add--delete-key-fileto delete the file once the key is saved. The file must be readable only by SYSTEM, Administrators and you.
For an image you roll out, mestra-player bundle --install-key-file <file> --out <folder> writes a folder for Windows images. It holds the player, the backup player, the key, a setup script and a README. Keep that folder private.
Each PC joins the Unassigned list on Add screens with its maker, model and serial number. It stays dark and can’t be booked until an owner sets it up:
- Tick the screens, then select Set up….
- Choose a Name (or Names start with, and each screen gets a number after it) and a Brand. The screen joins that brand’s site, with the site’s hours.
- Select Check, read What would change, then select Set up.
You can also set up many at once with Import CSV…, and take the list out with Export CSV. The file sets a screen’s name and brand from its serial number.
When a key ends, screens that already joined with it keep working. Only new screens can no longer join with it.
Use one key per rollout and revoke it when the rollout is done. A key shows Reported exposed if a screen found a readable copy of it, and Joining too fast if screens joined faster than allowed. Revoke it in either case. See Troubleshooting.
Replace a PC
If a PC is re-imaged or swapped, install it again, then on Add screens select Replace next to it and choose Which screen does it replace? The old screen’s bookings and history move to the new install. A screen that looks like a copy of another disk shows Possible copy. Select Replace to confirm it.
What the install changes on the PC
Install makes the PC a locked-down, single-purpose screen for signage. Uninstall puts it back. An administrator can still service it. Contact support for the steps.
The screen’s page shows one line under its name with what the PC says about its lockdown: Locked down, Allow-list: learning, Disk not encrypted, No TPM, Device key lost and Lockdown repaired.
Mestra doesn’t encrypt the disk and never sees a recovery key. If the screen’s page shows Disk not encrypted, turn on BitLocker yourself if you want it. Mestra sets Windows Update’s active hours to follow the screen’s hours, so Windows installs outside play.
Remove a screen
- From Mestra. An owner selects the screen’s menu, then Remove. The screen stops playing and its key is forgotten. Its bookings end; its play records stay. The PC is told at its next call: it wipes its key, its cached files and its play log, stops showing content, and puts Windows Update’s settings back as install found them. To use it again, run
mestra-player installon it again and add it with a new code. - From the PC. Run
mestra-player uninstallfrom an elevated prompt. It removes the service and the lockdown, and the PC goes back to normal Windows. Add--purgeto also delete the state folder (the device key, cache, logs and records) and the install folder.