Skip to main content
Print Knowledgebase

Connection Troubleshooting

This guide covers the most common connection problems: not being able to reach the Vū Studio website, Vū Studio being unable to connect to your Media Server, and a player that reads as offline when you expect it to be up.

Problem 1: Can't Load Vū Studio​

Symptom: one.vu.studio won't load in the browser, or the Media Server display shows "No internet connection."

Step-by-step diagnosis​

  1. Test general internet access — open a browser on the affected device and try google.com. If Google doesn't load, you have a general internet connectivity issue, not a Vū-specific one.

  2. Try a different network — if possible, connect the device to a mobile hotspot or different Wi-Fi network. If it works there, the issue is with your local network.

  3. Try a different device — connect a second device to the same network and try loading Vū Studio. If the second device works but the first doesn't, the issue is with the original device, not the network.

  4. Restart networking hardware — restart your router/modem, especially if multiple devices are affected.

  5. Check firewall/proxy — if you're on a corporate or campus network, your IT team may be blocking required domains or ports. See the Network & Firewall Requirements →.

Problem 2: Vū Studio Can't Connect to the Media Server​

Symptom: The connection indicator in Vū Studio is red or flashing yellow, and you can't send commands to the display.

Understanding what the indicator means​

  • 🟢 Green — Connected. Your account name appears at the bottom right of the display.
  • 🔵 Blue — Connected, and the display is in Sleep Mode. The player is reachable and still accepting content — only its screen is dark. See A Sleeping Player Is Not an Offline Player below.
  • 🟡 Yellow flashing — Attempting to connect. Usually resolves in a few seconds.
  • 🔴 Red — Connection failed. Action required.

Step-by-step resolution​

1. Verify the system ID Click the gear icon (Settings) in Vū Studio's top right corner and confirm the system ID matches the ID shown on the display. An incorrect ID is the most common cause of connection failure.

2. Refresh the browser Press F5 or Cmd+R to reload the page. Sometimes a stale WebSocket connection just needs a fresh start. After refreshing, check if the indicator turns green.

3. Restart the Media Server software In Vū Studio Settings, click Restart Media Server and confirm when prompted. The Vū Media Server software on the Windows machine will shut down and restart. Once it restarts, refresh your browser tab to reconnect.

4. Manually restart on the Windows machine If the remote restart doesn't work:

  • On the Windows machine, press the Start button
  • Right-click the Vū Studio icon in the taskbar
  • Select Close Window
  • Wait 10 seconds, then click the Vū Studio icon to restart it
  • Refresh your browser tab to reconnect

5. Check internet access on the Windows machine The Vū Media Server software needs internet access to connect to the MQTT broker and Supabase. Open a browser on the Windows machine and try loading one.vu.studio. If it doesn't load, the machine has no internet — fix that first.

Problem 3: A Player Shows as Offline​

Symptom: A player reads as offline in Vū Studio, or its display node in the Display Dashboard is dimmed and labeled Player Offline, even though you believe the display is up.

Reading the Status Indicator on a Display Node​

The Display Dashboard (one.vu.studio/dashboard — click the Vū Studio icon to go Home, then click Display Dashboard) shows one display node per display, and every node carries a status indicator in its header strip next to the player name. In Live Mode that indicator reflects the player's real, current state:

  • 🟢 Green (Player online) — the player is connected and can receive content.
  • 🔵 Blue (Player asleep) — the player is connected, but its display is in Sleep Mode.
  • 🔴 Red (Player offline) — the player is not reachable. The node is dimmed and labeled Player Offline, and dragging content over it reads Can't receive content.

The indicator is driven by the player's own status reporting, so it turns red as soon as a player drops — including an abrupt drop, where the player never gets the chance to sign off — and it returns to green by itself the moment that player comes back. You do not need to reload the page, reopen the group, or reconnect by hand to get an accurate reading. If a player has only just reconnected, give the node a few seconds and watch it change on its own before you start troubleshooting.

Two views are worth having open together when you are chasing a flapping player: the dashboard, which tells you the state of every display in a group at a glance, and the monitoring dashboard, which tells you how each player has behaved over time. See System Monitoring → and The Display Dashboard →.

A Sleeping Player Is Not an Offline Player​

A display that has been put to sleep is still online. The player stays connected, still reports its state, and still accepts content — only its screen is dark. That matters most for a Vū Studio Player desktop player, which blanks its whole window to black in Sleep Mode and so looks, at a glance, exactly like a machine that has gone away.

Check the indicator before you check the network:

  • A blue indicator, whose tooltip reads Player asleep, means the player is sleeping. Nothing is wrong with the connection — wake it.
  • A red indicator means the player is genuinely unreachable, and the steps below apply.

To wake a sleeping display, use Wake Up All in the Display Dashboard's control bar, or the Wake Up command on the connection indicator for the player you are connected to. See Sleep All and Wake All →.

When a Connection Expires​

Your browser's connection to a player does not last forever — it expires if a tab is left open long enough, and it ends whenever the player itself restarts. When that happens, Vū Studio re-establishes the connection for you: the connection indicator turns yellow while it reconnects, then settles back to green (or blue, if that display is asleep). Give it a few seconds rather than reloading straight away; the reconnect completes on its own and the display node's status follows it.

If the connection does not come back:

  1. Check whether you disconnected that player yourself. Vū Studio remembers a manual disconnect and deliberately does not reconnect to that player on its own afterwards. Connect to it again from the connection indicator — once you do, automatic reconnection resumes for it from then on.
  2. Reload the browser tab (F5 or Cmd+R) to clear a stale connection, then check the indicator again.
  3. Confirm the player machine still has internet access — see step 5 under Problem 2 above.
  4. If the indicator stays red, work through the Problem 2 steps in order, starting with the system ID.

What to Check When a Player Reads Offline​

  1. Rule out Sleep Mode first — blue with a Player asleep tooltip is a sleeping display, not a broken connection.
  2. Wait a few seconds. The status updates itself when the player reconnects; a player that is mid-restart will clear on its own.
  3. Check the machine. Confirm it is powered on, awake, and running the Vū Media Server software (or, for a desktop player, that the Vū Studio Player app is still open).
  4. Check the machine's network. Open a browser on it and load one.vu.studio. No internet there means no connection here — fix that first, then see Network & Firewall Requirements →.
  5. Confirm from a second view. System Monitoring → shows whether the player has been dropping repeatedly or went down once, which points at a network problem rather than a one-off.
  6. Do not cast to it while it is offline. An offline player cannot receive content, so resolve the connection before casting, scheduling, or taking a composition live for that display.

Still Not Working?​

If you've gone through all the steps above and the system is still not connecting:

  1. Press F12 on a keyboard connected to the Windows machine to open the Operator Menu
  2. Use the diagnostic tools there to check system status
  3. Use the Send Logs option to automatically send diagnostic logs to the Vū support team

Or contact support directly: