Mestra Player
Troubleshooting Mestra Player
Find the state or message you see, then follow the fix. Messages are shown as the app words them. For anything not here, contact support.
Install
| You see | Cause | Fix |
|---|---|---|
| “Windows Home can’t run Mestra Player as a kiosk.” | The PC runs Windows Home. | Use Windows 11 Pro, Enterprise, Education or IoT Enterprise. See Requirements. |
| “Windows … build … isn’t on Mestra’s approved list yet.” | The edition or build isn’t approved. | Use an approved edition and build, or contact support. |
| “Windows 11 Pro 24H2 is no longer supported by Microsoft…” | Microsoft ended support for that release. | Run Windows Update to move to 25H2, then install again. |
| “This PC is a domain controller…” | The player signs in automatically, which it won’t do on a domain controller. | Use a separate PC. |
| Install stops before changing anything | The WebView2 Runtime isn’t installed. | Install the Evergreen WebView2 Runtime for all users, then run install again. |
| Install says Windows must restart | A Windows feature needed a restart. | Restart the PC and run install again. A bundle’s install.cmd restarts and carries on by itself. |
| The screen shows no pairing code | The 30 minutes after install are over. | Run mestra-player install again on the PC to get another 30 minutes. |
| The size, time zone or PC maker shown after Check code isn’t your screen’s | The code belongs to a different PC. | Select Back and check the code. Nothing is added until you select Add this screen. |
Screens
| You see | Cause | Fix |
|---|---|---|
| Never connected | The PC hasn’t called Mestra yet. | Check it is on and online, and that it can reach player.withmestra.com on port 443. |
| Offline and how long | The PC hasn’t called in for over 3 minutes. | Check the PC has power and a network. The screen keeps playing its saved schedule while it’s offline. |
| “The PC has no network cable or Wi-Fi” | No network link. | Check the cable or Wi-Fi at the screen. |
| “The network does not reach the router” | The router isn’t answering. | Check the router at the site is on. |
| “The PC can’t look up Mestra’s address” | The network is blocking address lookups. | Ask the site to check its DNS settings. |
| “The PC can’t make a safe connection” | The network may be changing secure traffic. | Ask the site to allow connections to Mestra. |
| “Mestra can’t be reached” | The PC is online but Mestra isn’t answering. | Nothing to do. The screen keeps its saved schedule. Check status.withmestra.com. |
| Showing black | The screen is on but showing nothing. | See “The screen went black” below. Check the cable and input. |
| “The screen is not connected” | The display’s cable is out or the display is off. | Check the display is on and its cable is plugged in. Mestra keeps trying. |
| Needs a look or Needs a visit | The screen couldn’t fix a fault. The page says what and how to fix it. | Follow the fix on the screen’s page. Often it’s your installer’s. |
| “The player window keeps closing” | The window keeps crashing. | Ask your installer to visit. |
| “The PC keeps restarting” | Power cuts or a fault. | Ask your installer to check the power and the PC. |
| “The power keeps cutting out” | The PC lost power several times. | Check the supply, or fit a UPS. |
| “The disk is almost full” / “The disk is filling up” | Something else is using the PC’s disk. | Ask your installer to free space. Mestra already cleared what it could. |
| “The PC’s clock is wrong” | The schedule may run early or late. | Fix the clock. |
| “The clock can’t be checked” | The site’s network blocks time sync. | Allow UDP port 123. |
| “The PC is running hot” | Poor airflow or fans. | Ask your installer to check. |
| “Windows updates are stuck” | Windows has been updating, or waiting to restart, for too long. Mestra holds back restarts. | Ask your installer to finish the update. |
| “The player and its backup stopped” | The screen shows the stop screen or is dark. | Check the PC has power and is on. If it is, restart it. |
| “The PC is stuck in safe mode” | Mestra couldn’t leave safe mode. | Ask your installer to visit. |
| Can’t play N files | The screen can’t decode a file you booked. | Open the screen’s Playback section to see why, then upload a version it can play. See Show content on your screens. |
| Not spanned | The PC has several displays and Windows isn’t joining them. | Span them in the graphics driver. See Video walls. |
| Out of step | A group member isn’t in time with the others. | Check the member is online and its PC can decode the video. |
| Unassigned | The PC joined with an install key and nobody has set it up. | On Add screens, select Set up…. |
| Possible copy | The disk looks copied from another PC. | If you re-imaged on purpose, select Replace. |
| No TPM | The PC has no usable TPM 2.0. | The screen works. Its key is kept in software. |
| Device key lost | The screen’s key can’t be found on the PC. | Contact support. |
| Disk not encrypted | BitLocker is off. | Turn BitLocker on yourself if you want it. Mestra never does. |
| Windows may restart during on-hours | The screen has no hours, or none that leave a quiet time, so Windows may restart it during play. | Set the screen’s or site’s hours. See Run your screens. |
The screen went black
A screen that is showing black repairs itself first: it restarts the player’s window. If it happens again, check the display’s cable and input. If a panel was powered off, check its hours.
Commands and screenshots
| You see | Cause | Fix |
|---|---|---|
| “The screen’s window wasn’t ready.” | The player’s window wasn’t ready for a screenshot. | Try again. |
| “The screen took too long.” / “The screenshot didn’t work.” | The screenshot failed. | Try again. |
| “The screen was asked too soon after the last time. Try again shortly.” | Too many asks in a row. | Wait a moment. |
| “The screen is installing an update. Try again in a few minutes.” | An update is being applied. | Wait. |
| “The screen restarted before it finished.” | The PC restarted. | Ask again. |
| “The screen didn’t pick this up in time.” | The screen was offline or busy. | Ask again when it’s online. |
| “Too many tries. Try again in N min.” | You’ve asked too often. | Wait as long as it says. |
Updates
| You see | Cause | Fix |
|---|---|---|
| Update ready | The update has arrived and waits for the screen’s update time: when it is off, the time you chose, or 3 am its time. | Nothing to do, or select Apply now. |
| Security update waiting with “Updates are paused” | Pause updates is on. | Switch off Pause updates under Settings > Updates. |
| Rolled back | The update didn’t prove healthy, so the screen went back to its last working version. | Nothing to do. The rollout pauses. Contact support if it keeps happening. |
| Update failed | The update didn’t apply. | Hover over the pill for the reason. |
| Runtime not pinned | The screen is using the web runtime installed on the PC, not the one in the release. | It still plays. Contact support if it stays. |
Panel control
| You see | Cause | Fix |
|---|---|---|
| “Not yet tested on this hardware.” | Every built-in profile is untested on real hardware. | Save the link, then use Test panel. |
| “Panel refused this input” | The panel doesn’t accept that input. | Choose another input. |
| “Waiting N min after the last switch to protect the panel” | Mestra waits between switches. | Wait. |
| “Use a port like COM3.” | The COM port is in the wrong form. | Enter it like COM3. |
| “Choose a panel profile.” / “Choose how it is connected.” / “Choose a speed.” | A field is missing. | Fill it in. |
| “No hours set — Mestra won’t turn the panel on or off.” | No hours. | Set hours on Sites. |
| “This screen is offline. The test waits for it for a few minutes.” | Test panel needs the screen online. | Bring it online and try again. |
Install keys and monitoring
| You see | Cause | Fix |
|---|---|---|
| Reported exposed | A screen found a readable copy of the key. | Revoke the key and use a new one. |
| Joining too fast | Screens joined faster than allowed. | If no rollout is running, revoke the key. |
| “N screens joined; you expected M.” | More joined than Expected screens. | Check that you expected them. |
| “Failing since…” on a destination | Mestra can’t deliver to the address. | Check the address and key. Select Send test. Mestra keeps trying. |
| “A test was sent a moment ago. Try again in a few seconds.” | Tests are limited. | Wait a few seconds. |
| “That address is private or isn’t allowed.” | The address is on a private network. | Use a public HTTPS address. |