prism docs · Getting started · Pair your phone and scan

Pair your phone and scan

Your phone is prism's measuring tape. The projector shows a series of stripes while the phone watches from beside it, and from what it sees prism works out exactly where every projector pixel lands in your room. Over a cable it takes about half a minute.

WhereSetup ▸ Pair phone and Scan
TakesAbout 30 s (HDMI)
About 2 min (wireless projector)
PhoneiPhone with Safari, or Android with Chrome; nothing to install
ModeSimple everything a scan needs
Advanced the detection choice
1 · Pair the phone 2 · Where to put the phone 3 · Light 4 · The checks 5 · Start the scan 6 · What the stripes do 7 · How long it takes 8 · After the scan 9 · If it fails Hints and tips When something looks wrong

1Pair the phone

Open the projector window first (Projectors and outputs), then click Next: pair phone.

  1. Point the phone's camera app at the QR code on the laptop and tap the link that appears. It opens prism's camera page.
  2. No QR reader? On the phone, open the address shown under the code (it ends in /join) and type the 6-character room code; it joins by itself when the code is complete.
  3. On the phone, tap Start camera and allow the camera when the phone asks.
  4. The laptop's Status says Phone connected, with the camera's size. Click Next: scan.
Pair your phone: the QR code, the room code, and Status: Server open, Phone connected
Pair phone. “Locks: exposure —, focus —…” is normal for iPhones, which don't let a web page lock the camera; prism copes without.
The phone's camera page: Scan your scene with this phone, three tips and Start camera
The phone's page: three things to do first, then Start camera.
The phone's Enter the room code page with the code typed in
No QR code? Type the room code instead: the phone joins as soon as all six characters are in.
What leaves the phone. The camera picture stays on the phone. Only the finished scan, with one photo of the scene, goes to your laptop.
The link must be secure. Phones only allow the camera on https:// pages. The QR code uses your studio's secure address. If the laptop opened prism at localhost, the Pair step warns that the phone can't reach it: open prism through the computer's network address or its tunnel address instead.

2Where to put the phone

The phone framing the projection: Ready to scan, with the checks Whole projection in view, Phone steady and Screen stays on
The phone framing: the lime outline is the projection it found. Its three checks must be ticked.
Keep the phone awake. If its screen turns off, the camera pauses and the scan stops. The phone's check Screen stays on tells you; if it says Screen may turn off, tap Keep screen on, or turn Auto-Lock off while you scan (iPhone: Settings ▸ Display & Brightness ▸ Auto-Lock ▸ Never). Don't switch to another app.

3Light

4The checks

When you reach the Scan step, the projector starts to blink. The phone uses the blink to find the projection, and the laptop shows what the phone sees: the lime live outline is the projection's edge.

The Scan step with the live outline and the four checks ticked
“Let the light do the measuring”: the live outline and Ready to scan? with its four checks. “Picture delay ≈ 90 ms” is the projector's delay, measured from the blink.
CheckIf it isn't ticked
Phone connectedPair your phone first.
Projection foundPoint the phone at the projection and dim the room.
Whole projection in viewStep back or turn the phone until the outline doesn't touch the edge.
Phone steadyProp the phone next to the projector lens.

The phone has its own checks: Whole projection in view, Phone steady and Screen stays on.

Starting anyway. If a check won't come, you can still press Start scan (or Start anyway before the projection is found). The scan checks itself as it goes and repeats any frame the phone moved on.

5Start the scan

  1. Click Start scan on the laptop. (The phone has a Start scan too, but touching the phone can move it.)
  2. Hands off. The projector shows black, white, and then stripes, each followed by its opposite. The laptop counts Main pass frames; the phone says Hold still.
  3. If some areas came out unclear, the phone looks at just those again: Touch-up pass (“Some areas need another look — re-scanning them now.”).
  4. The phone sends the scan (“Scan sent — you can put the phone down”) and the laptop finds the surfaces.
The laptop during the scan: Main pass with a progress bar and Hold the phone still
The laptop during the scan. Stop scan stops it.
The phone during the scan: Hold still, Scanning, frames done
The phone during the scan: frames checked out of all of them.
The phone: Scan stopped, Lost the connection to the laptop during the scan, Try again
When a scan stops, the phone says why, with Try again.

6What the stripes do

Each stripe pattern splits the projector's picture into light and dark bands: the first into two halves, the next into quarters, then eighths, and so on down to stripes a few pixels wide. First upright stripes, then lying ones.

Now look at one point on your box through the phone. In each pattern that point is either lit or dark. Written down in order, those lit/dark answers spell out a number: the column of the projector pixel that lights that point (from the upright stripes) and its row (from the lying ones). After about forty patterns prism knows, for every point the phone sees, which projector pixel falls on it.

What the projector sends: straight black and white stripes
What the projector sends: straight stripes.
What the phone sees: the same stripes bending over three boxes
What the phone sees: the same stripes, bent and shifted by every box. That bending is the shape of your room.

From this map prism finds the flat faces, curved surfaces and edges, and draws each surface as a clean shape, exactly as the projector sees it. Three more tricks keep it reliable:

Why beside the lens? The phone reads which projector pixel lights each point. From right next to the lens it sees nearly everything the projector lights. From far to one side, parts in the projector's light would be hidden from the phone behind the objects.

7How long it takes

StageTimeWhat you see
FramingA few secondsThe projector blinks; the checks tick.
The scanAbout 30 s over HDMI · about 2 min over Wi-FiAbout forty frames of stripes; “Main pass 12 / 41”.
SendingA few seconds“Receiving the scan from the phone…”
Finding surfacesA few seconds“Finding surfaces…”
Finding objectsAbout 15–30 s“Finding objects… 40%”. The very first time, the object finder downloads once (about 450 MB).

8After the scan

The camera view becomes a heatmap of how well each part was read: Full precision (green), Partial (yellow), Weak (red) and Unlit (grey). Scan quality ▸ Details gives the numbers, and any warnings appear under it in amber.

The Scan step after a scan: the heatmap, Review surfaces, Scan again and Scan quality with details
After the scan. Nearly all green means a clean scan; click Review surfaces.
DetailMeaning
Projection decodedHow much of the projection was read reliably. Close to 100% is a clean scan.
Too brightHow much of it the camera saw burnt out white. Lower is better.
Room lightHow much light there was without the projector. Above about 20% prism warns that the room is too bright.
TookHow long the scan took.
Picture delayHow late the projector showed each picture (amber for a wireless link).

Review surfaces takes you to What do you want to map?. Scan again starts over.

Advanced Surface detection

Under the Scan step's More…, Surface detection chooses how surfaces are found. AI + geometry (the default) also uses the scan photo, which is best for separate objects that touch; its model downloads once and runs on your computer. Geometry only is fast and fully offline, best for flat walls and simple boxes. While Geometry only is chosen, Simple shows an Advanced · Geometry only chip there.

9If it fails

A scan that can't finish stops with a message on the phone and on the laptop, and a Try again button. The message says what went wrong; this table says what to do.

You seeWhyFix
“Phone moved — prop it and hold still”The phone was touched, slid or wobbled.Prop it firmly (a tripod is best), start from the laptop, and scan again.
“The phone was turned during the scan”The screen rotated, which changes the camera picture.Keep the phone in one orientation; lock its rotation if it flips when propped.
“The scan stopped because the phone's screen turned off…”The phone locked itself, or you switched apps.Tap Keep screen on, or turn Auto-Lock off; keep the camera page in front.
“Room too bright — dim the lights for a better scan”Too much light besides the projector.Lights off, curtains closed, scan again.
“Room lighting changed during the scan”A light was switched, or daylight changed.Keep the lights steady until the scan is sent.
“The phone can't see the projector changing”The phone isn't looking at the projection, or the projector window isn't on the projector.Check Projection found and the projector window (Identify), then try again.
“No projector light found”The phone found no projection to scan.Get the whole projection in view and dim the room.
“The picture won't settle”The phone keeps moving slightly.A steadier prop; keep people away from the table.
“Lost contact with the phone” · “Lost the connection to the laptop during the scan.”The phone's or laptop's network dropped, or the page closed.Check both are online; keep the camera page open; try again.
“The laptop didn't start the scan…”You pressed Start on the phone while the laptop wasn't ready.Put the laptop on the Scan step with the projector window open, then try again.
“The projector's picture kept arriving late or in pieces over Wi-Fi…”A wireless projector link is too unsteady.Try again, or scan over HDMI: it is faster and more accurate.
“The projector stopped updating over Wi-Fi…”The wireless link dropped.Reconnect the projector, or use HDMI.
“Camera access is blocked”You refused the camera.iPhone: tap aA in Safari's address bar ▸ Website Settings ▸ Camera ▸ Allow, then reload. Android: the icon left of the address ▸ Permissions ▸ Camera ▸ Allow.
“The camera needs a secure page”The page was opened with http://.Scan the laptop's QR code again: its link starts with https://.
“The camera is busy”Another app or tab uses the camera.Close it, then tap Try again.
“This room has closed”An old link or code.Scan the QR code the laptop shows now.
“Nothing was detected. Try dimming the room and scanning again.”The scan read too little.Dim the room, check the whole projection is in view, scan again.
The phone: Camera access is blocked, with instructions and Try again
A blocked camera: the phone says how to allow it.

Hints and tips

When something looks wrong

You seeWhyFix
“This page is open on localhost, which your phone can't reach”The laptop opened prism at its own local address.Open prism on the laptop through its network or tunnel address, then pair again.
“Waiting for the phone…” never changesThe phone hasn't opened the camera page, or can't reach the server.Open the QR link on the phone; check the phone is online.
Start scan is greyed outNo phone, no projector window, or the projection isn't found yet.Follow the checks; use Start anyway if you're sure.
“Looking for the projection…”The phone can't see the blink.Point it at the projection; dim the room; open the projector window.
Lots of red or grey in the heatmapToo bright, too far, or dark and shiny surfaces.Dim the room, move the phone closer to the lens, scan again.
Amber warning “Couldn't check that the phone stayed still”The phone's steadiness couldn't be confirmed.If surfaces look off, prop the phone better and rescan.
The scan takes minutesA wireless projector: each picture is waited for.Normal over Wi-Fi; HDMI is faster.
prism documentation · Getting started · screenshots taken in prism's simulator; the phone's camera shows the simulated room · 28 Sept 2026