Right after unboxing XREAL One Pro+, inspect the package and serial, charge and power on the headset, install XREAL GlassesControl and Nebula, update firmware, confirm a USB‑C DisplayPort Alt Mode link to your phone or PC, and run a short motion‑to‑photon and hand‑tracking latency test. Only then install apps.
Time needed about 20–45 minutes, longer if firmware updates are large or your host needs drivers
- Do a short hardware, firmware and latency smoke test before installing apps to avoid wasted troubleshooting time.
- Keep the box and verify the serial and region immediately; visible shipping damage or wrong region are valid return reasons.
- Display or streaming failures most often come from the host connection or cable, not the headset software.
- Use XREAL GlassesControl to confirm firmware and Nebula to confirm streaming; the apps report the single source of truth.
- A repeatable motion‑to‑photon test gives a clear pass/fail cue for whether to continue troubleshooting or request a replacement.
- Unboxed XREAL One Pro+ with the supplied USB‑C cable and carry case at hand
- A host device: a USB‑C phone that supports DisplayPort Alt Mode or a Windows PC with a free USB‑C/DisplayPort‑compatible port
- A charged phone or PC with permission to install apps from the official store or XREAL site
- A stable Wi‑Fi connection for downloading apps and firmware
- A place with moderate lighting and a plain background for hand‑tracking tests
The steps
- Inspect the box and accessoriesOpen the package, lay out contents and read the serial and region sticker; photograph any visible shipping damage and keep the packaging.You should see: You see the headset, the supplied USB‑C cable, carry case (if included) and a readable serial number matching paperwork.
- Charge and power on the headsetConnect the supplied USB‑C cable to a known good USB‑C power source and charge until the headset shows a boot or LED indicator, then press the power button to start it.You should see: The headset shows a visible boot indicator or LED change and does not immediately reboot repeatedly.
- Install GlassesControl and Nebula on the hostInstall XREAL GlassesControl on your phone from the official store and Nebula or the PC client on your computer, then open GlassesControl and allow the requested permissions when prompted.You should see: GlassesControl opens and lists the headset or prompts to pair; Nebula on PC offers a device connection or streaming option.
- Check and update firmwareIn GlassesControl check the headset device info for firmware version and follow prompts to update if offered; restart the headset after the update completes.You should see: GlassesControl reports the firmware version and confirms either 'up to date' or that the update completed successfully.
- Confirm host and cable video linkConnect the headset to your phone or PC with the supplied cable, accept any USB permission prompts, and use Nebula or the PC client to start a basic streaming session or mirrored view.You should see: The headset displays the Nebula or mirrored image and GlassesControl or Nebula shows the headset as connected.
- Run the visual and fit checksShow a white image and a black image, inspect for dead pixels or uneven brightness, wear the headset to test IPD and strap fit, and play a short audio clip to confirm sound comes from the headset.You should see: White and black fields look even with no large stuck‑pixel clusters, the headset seats comfortably at your IPD, and audio plays from the headset speakers.
- Perform the motion‑to‑photon and hand‑tracking testOpen a pointer or hand‑tracking demo in Nebula or GlassesControl, move your head briskly and slowly, then wave your hand in front of the cameras and watch for lag or tracking loss.You should see: Head motion updates the display with only imperceptible lag and the hand pointer follows your finger without multi‑second dropouts.
- Install apps one at a timeIf all tests pass, install one app, validate it (Nebula streaming, then a video player, then a hand‑tracking app), and only install the next app once the previous one works.You should see: Each app runs and behaves correctly in isolation; if one app fails, you can attribute the issue to that app rather than hardware.
First checks to run in order
Do these checks top to bottom: inspect the packaging and serial, charge and power the headset, install XREAL GlassesControl and Nebula, update firmware, confirm the host and cable support video, then run a display, fit and latency smoke test. Each step rules out a different class of failure.
- Run the list in order; skipping steps wastes time later.
- If the motion/latency test fails, stop and fix connection or firmware before installing more apps.
Unbox and verify packaging and serial
Open the box and check contents against the packing list. Confirm the serial number on the headset or box matches any paperwork and note any region or import sticker so you can return or exchange if needed. Photograph damage for support or returns.
- What to see: intact box, readable serial, supplied USB‑C cable and carry case present.
- If damaged: stop setup and open a support ticket or arrange a return; keep the packaging.
Charge, power on and install device apps
Charge the headset and power it on before streaming. Install XREAL GlassesControl on your phone and Nebula or the PC client on your computer so you can view device info and accept firmware updates. The apps are how you check firmware, battery and pairing status.
- What to see: headset powers on and GlassesControl shows the headset with a firmware entry and battery percent.
- If the headset won't boot, try another USB‑C port or cable before assuming a battery fault.
Confirm firmware and permissions
Open GlassesControl and check the headset device info for firmware version, battery level and pairing status. If a firmware update is available, apply it, wait for the app to report completion, then restart the headset. Grant requested permissions so passthrough and hand tracking can work.
- What to see: GlassesControl reports a firmware version and no pending updates after restart.
- Do not interrupt firmware installs; interrupted updates can leave the headset unstable.
Host device and cable compatibility
XREAL One Pro+ requires a host that supports USB‑C DisplayPort Alt Mode for phone streaming, or a compatible Windows PC with the Nebula client. Test with the supplied cable first and the host's native USB‑C port; many third‑party cables and hubs do not pass video.
- Common failure: using a charge‑only cable. Always test first with the supplied cable.
- Tip: inexpensive USB‑C hubs often lack DP Alt Mode passthrough — test direct to phone or PC.
Install apps and grant permissions
Install GlassesControl on your phone and Nebula on your PC before running display checks. Grant camera and microphone permissions for passthrough and hand tracking, and permit USB access when the phone prompts. Without these permissions tracking or passthrough may be disabled.
- Links: find the controller and client at /apps/xreal-glassescontrol and /apps/xreal-nebula and browse compatible apps at /apps.
- What to see: apps installed, headset listed as paired in GlassesControl, and Nebula detecting an external XR display or headset.
Visual, fit and audio smoke checks
Show a neutral white and a black image to check for stuck pixels, uneven brightness or stray light. Wear the headset briefly to confirm strap fit and IPD, and play a short audio clip to confirm sound comes from the headset speakers or a selected audio sink. These checks separate returns from tweaks.
- Pass cues: uniform white/black fields with no large stuck‑pixel clusters, comfortable fit at your IPD, and headset audio.
- Fail cues: clusters of stuck pixels, visible cracks, or audio only from the phone after selecting headset audio.
Repeatable latency and tracking tests
Run a motion‑to‑photon check and a basic hand‑tracking demo in Nebula or GlassesControl. Move your head briskly and slowly and wave your hand in view of the cameras. These tests show whether lag or tracking loss stems from the host, the connection, or the headset itself.
- Pass cues: head motion updates the display with imperceptible lag; the hand pointer follows movement smoothly.
- Fail cues: persistent delay, choppy frames, or hands that jump or disappear for more than a second.
Common failure sequences and the right next step
Failures usually follow predictable patterns: no image from a wrong cable or USB mode, then people install apps and blame software. Or firmware is out of date and causes instability under load. Always confirm the display and latency first before reinstalling apps.
- No image: verify cable and host before installing streaming apps.
- Bad tracking with image: check permissions and firmware next.
Basic troubleshooting and when to open support
Reseat the supplied cable, try another USB‑C port, toggle USB prompts, restart headset and host, and confirm firmware in GlassesControl. If the defect remains across a second cable and a different host, open support with photos, the serial and a short video of the failing test.
- Immediate fixes: reseat cable, switch USB mode, restart devices.
- When to return: visible shipping damage, large dead‑pixel clusters, or boot loops that persist across hosts.
What to install after the smoke tests
If hardware, firmware and latency checks pass, install one app at a time and test each: Nebula streaming first, a video player next, then a hand‑tracking or productivity app. Testing apps in sequence makes it obvious which app causes a problem.
- Where to look next: /apps, /apps/xreal-glassescontrol and /apps/xreal-nebula.
- If an app misbehaves after these checks, report it to the app developer with your test steps.
Where this usually goes wrong
- No image on the headset despite being poweredCable or host lacks DisplayPort Alt Mode or the USB connection mode is wrong.Swap to the supplied cable, try another USB‑C port or a different host, and confirm any USB permission prompts on the phone. If still blank, test with a known DP Alt Mode device.
- Hand tracking missing or intermittentMissing camera, microphone or Bluetooth permissions, poor lighting, or outdated firmware.Open GlassesControl, confirm camera and microphone permissions, ensure Bluetooth pairing is complete, test in better lighting, and update firmware.
- Choppy video or large latency during movementHost CPU/GPU overloaded, an upstream USB hub, or a noisy cable/adapter causing packet loss.Connect directly to the host with the supplied cable, close heavy apps on the host, try a different port, and use a known‑good cable or PC with the Nebula client.
- Persistent boot loop or failed firmware installInterrupted firmware update or corrupted firmware.Document the state with photos and a short video and contact XREAL support with the serial and firmware details for guided recovery or RMA.
- Audio stays on phone speakers even when headset is connectedHost audio routing not set to the headset or the audio profile negotiation failed.Check host audio output selection, ensure Nebula or the streaming client is set to output to the headset, and restart host and headset if needed.
The checklist
- Inspect the box and accessories
- Charge and power on the headset
- Install GlassesControl and Nebula on the host
- Check and update firmware
- Confirm host and cable video link
- Run the visual and fit checks
- Perform the motion‑to‑photon and hand‑tracking test
- Install apps one at a time
Frequently asked questions
How do I tell if my phone supports DisplayPort Alt Mode for the XREAL One Pro+?
Check your phone maker's spec page for 'DisplayPort Alt Mode' or 'USB‑C video output'. If the spec is unclear, test with the supplied cable: if the phone prompts for USB permissions and the headset shows an image in Nebula or GlassesControl, the phone supports video output. If not, try a known DP Alt Mode device or a PC.
My headset shows an image but hand tracking is inconsistent — what should I check first?
First check GlassesControl and Nebula permissions: camera and microphone access are common causes of disabled tracking. Next confirm firmware is current and test in good lighting against a plain background. If issues persist, try a different host or reinstall the controller app before contacting support.
Which cables and adapters cause the most problems with XREAL One Pro+?
Charge‑only USB‑C cables and many inexpensive hubs often do not carry DisplayPort Alt Mode. The supplied cable is the baseline test. If you must use adapters, prefer a direct USB‑C to DisplayPort active adapter known to pass video. If the image fails, switch back to the supplied cable and test another host.
Can I interrupt a firmware update if it seems stuck?
Do not interrupt firmware updates; allow them to finish. If an update truly stalls, follow vendor troubleshooting guidance and record the device state with a short video for support. Interrupting an update risks a failed boot and will require vendor recovery steps.
When should I return the headset instead of troubleshooting further?
Return immediately for visible shipping damage, missing included accessories, or major hardware faults like large dead‑pixel clusters or lens cracks. Also return if you can reproduce a boot loop or persistent display failure across multiple hosts and after using the supplied cable and latest firmware.
Find apps that work on your glasses
Every app in the directory lists the glasses it runs on, how it works on each, and the official source that proves it.