Reading the lighting balance score
The Lighting Check measures the average luminance in the left and right
halves of your frame every 250 ms using the ITU-R BT.601 luma formula
(0.299R + 0.587G + 0.114B) on a downscaled 160×90 copy of your video
frame.12 The balance percentage is the absolute difference
between the two sides divided by the brighter side, expressed as a
percentage so you can compare results across different lighting setups.
A score below 15% is rated GOOD: both sides of your face receive approximately equal illumination, which
appears natural and professional on video calls. Scores between 15% and 35% earn
a WARN rating; at this level, shadowing
on one side will be visually noticeable. Above 35% is BAD, and you can expect heavy one-sided shadow that makes video calls look
unprofessional.
The balance score is intentionally a relative comparison rather than an absolute luminance reading, because what matters for video-call appearance is the symmetry of the lighting, not how bright the room is overall. A dimly lit room with even left-right balance reads as GOOD, while a brightly lit room with a window off to one side can read as BAD even though there is plenty of light on the subject.
TIP The most common cause of poor lighting balance is a window directly to one side. Either close the blind or position a secondary lamp on the dark side to act as fill light, and a white sheet of paper placed just out of frame works as a cheap reflector that softens one-sided shadow without introducing harsh secondary highlights.3
Understanding face framing and the distance verdicts
The Framing Guide uses MediaPipe's Face Landmarker model (478 3D facial landmarks) to locate your face in each video frame, and the bounding box, eye midpoint, and face centre are computed from the landmark coordinates and rendered on a canvas overlay that sits on top of the live video so you can see exactly how the model interprets your position.4
The distance verdict is based on the width of your face relative to the
frame width. A face narrower than 15% of frame width is flagged Too Far; wider than 55% is Too Close. The centre verdict triggers when
your face centre deviates more than 25% of the frame width from the
horizontal midpoint, and you can nudge yourself back into frame by watching
the overlay rather than guessing. In practice, aim for a face width
somewhere between 25% and 40% of the frame width so your face is prominent
without being overwhelming, which produces a balanced, professional look
that works well for video calls, streaming, and recorded presentations.
Field of view explains some distance verdicts that posture cannot. Face width here is measured as a percentage of the frame, and the same physical seating distance produces a smaller percentage on a wide-angle webcam than on a narrow one, because the wide lens fits more of the room into the same pixels. Sometimes a Too Far verdict means something other than distance: either you genuinely sit far back, or your webcam simply has a wide field of view and your call platform may be cropping the picture anyway. Before dragging your desk closer, change one thing at a time and watch how the verdict responds; the geometry that feels cramped on your monitor may look perfectly normal on the other side of the call.
Headroom and the rule of thirds
Viewers judge framing within the first second of a call, before you have said anything worth judging on its merits. A head position that is too low, too high, or too far off-center reads as carelessness at a distance, and it keeps reading that way all call long. What headroom mistakes cost, exactly, is polish: they are visible to everyone on the other end, they are free to fix, and most people never think to check them until a recording looks wrong. The section below pins down the target range, shows how the tool's overlay marks it on your live video, and ties it to the rule of thirds that portrait and broadcast framing lean on.
Adjusting headroom and centering
Headroom is the gap between the top of your head and the top edge of the frame, and the headroom guide overlay draws a dashed line at 15% from the top to mark the target upper boundary for your forehead region. With your eyes roughly on the upper third line, you follow the portrait rule-of-thirds guideline often used in video shots and professional photography.5
Too much headroom (face positioned low in frame) gives the impression the camera is looking down at you and wastes the most expressive part of the frame. Too little headroom (head cropped at the top) looks unintentionally claustrophobic. The rule-of-thirds grid helps you align your eyes to the upper horizontal third, which is where viewer attention naturally lands first.
NOTE All face detection runs locally in your browser using a WASM binary and model weights loaded from Google's CDN on first use. Nothing is ever sent to CapyToolkit servers, and the model weights are cached by your browser so subsequent visits will load instantly without an additional network request.
Resolution and FPS readout
The resolution and frame rate your camera delivers to the browser are not always the same as the numbers printed on the box. Low light, USB bandwidth limits, and operating system load can all cause a camera to drop below its rated maximum, so reading the live stream settings tells you what you are actually getting rather than what the spec sheet promises.
How the FPS figure is calculated
The Resolution & FPS panel reads live values from your camera's active
stream via the MediaStream Track Settings API.6 The FPS figure is computed from a rolling 10-frame timestamp average rather
than the nominal reported framerate, so it reflects what the camera is
actually delivering to the browser; this may differ from its rated maximum
under low-light conditions or when the OS is under load.
Most webcams deliver 30 fps at their native resolution and may drop to a
lower frame rate in low light when automatic exposure compensation is
active.7 The aspect ratio is derived
directly from the pixel dimensions, so a 1920×1080 stream is 16:9 and a
1280×800 stream is 8:5. If you see an unusual ratio, the camera may be
delivering a cropped or letterboxed stream rather than its full native
sensor area.
The point of reading the live stream is that delivery beats the spec
sheet. A 1080p webcam in a dim room that quietly drops to 720p to
hold its frame rate is the camera your callers actually see, and the
panel reports that honestly even when the box in the drawer promises
more. Treat the numbers as the verdict on your current setup: lighting,
USB bandwidth, and OS load all pull real resolution down, so a reading
below the rated maximum is a diagnosis to act on, not a defect in the
tool. Model-specific pages exist for the same check on particular
hardware, starting with the Logitech C920 webcam test.
Practical steps to improve your lighting balance score
An unbalanced score responds to physics in real time, which is what makes fixing it genuinely fast. Every lamp you switch on, blind you tilt, or white surface you slide toward the dark side of your face moves the percentage within a second or two, so the Lighting Check doubles as feedback while you rearrange the room. Treat the rest of this section as a set of levers to pull in order of cheapness: start with what you already own, watch the score after each change, and stop as soon as the verdict reads GOOD. The specific fixes follow below.
Correcting an unbalanced score with fill light
A poor balance score almost always comes from a strong light source directly to one side of your face. A window to the left or right is the most common culprit. Closing that blind partially and positioning a desk lamp or ring light on the shadowed side brings light to the darker half and reduces the imbalance. You do not need studio equipment: a white foam board placed on the darker side reflects the window light back onto your face as fill3 and softens the shadowed half.
Three-point lighting produces the most consistently professional result for video calls and recordings. Position a key light in front of you and slightly to one side, a fill light on the opposite side, and a back light behind you to separate your head from the background. Two desk lamps at 45-degree angles in front of you approximate this arrangement without a dedicated lighting kit.8 Watch the balance percentage update in real time as you adjust each light, and aim for a score below 15 percent before your next call or recording session.
Webcam Lighting & Framing Analyzer Reference
- Lighting — GOOD Under 15% imbalance
- Lighting — WARN 15–35% imbalance
- Lighting — BAD Over 35% imbalance
- Face width — Too Far Under 15% of frame width
- Face width — Too Close Over 55% of frame width
- Face centering Flags past 25% off horizontal midpoint
Run Lighting Check and Framing Guide above and compare your own live readings against this scale.
When the camera will not start
When the camera refuses to start, walk the ladder from browser to operating system to lens, because each layer can veto the next. First, the browser prompt: if you dismissed it or picked the wrong option, this page has no camera to open, and retriggering it usually means clearing the camera permission in the browser's site settings before reloading. Second, the OS privacy layer: Windows and macOS both maintain a per-app camera list under their privacy settings, and a browser that is toggled off there will never see the camera even after you click Enable.910 Third, an exclusive lock: close every video-calling and camera app you have running, because some drivers hand the device to one program at a time.
A black image while the camera light is on is a different fault family. The camera is delivering frames, but they arrive fully dark: the shutter is physically closed or the exposure has collapsed to near nothing. Check the hardware privacy shutter or sliding cover first, since many webcams and laptops ship with one and it is the cheapest possible answer. Then open the Resolution & FPS panel on this page: if frames are arriving, the readout shows live values, and the fault is optical rather than electronic; if nothing reads at all, the feed itself never started, and you are back to the ladder above.
When nothing above helps, suspect the hardware path. The place to look is the operating system's device list, not the browser: if the OS reports no camera at all, cables and ports come first for an external webcam, and laptop kill switches or function-key camera toggles come first on a portable. Swap the port, try the camera on another machine, and you have your answer without guessing. One honest limit closes the diagnosis: this page analyzes a working feed, and it cannot repair one, so once the panel proves frames are arriving, the lighting and framing guides take over from there.
- 1.
Imatest, "Luminance," imatest.com, accessed June 2026. https://www.imatest.com/docs/luminance/
- 2.
Mozilla Developer Network, "CanvasRenderingContext2D: drawImage() method," developer.mozilla.org, accessed June 2026. https://developer.mozilla.org/en-US/docs/Web/API/CanvasRenderingContext2D/drawImage
- 3.
Adobe, "How to use photography reflectors," adobe.com, accessed June 2026. https://www.adobe.com/creativecloud/photography/hub/guides/how-to-use-photo-reflectors.html
- 4.
Google, "Face landmark detection guide," developers.google.com, May 2026. https://developers.google.com/edge/mediapipe/solutions/vision/face_landmarker
- 5.
Jim Harmer, "Rule of Thirds," improvephotography.com, accessed June 2026. https://improvephotography.com/34696/rule-of-thirds/
- 6.
Mozilla Developer Network, "MediaTrackSettings," developer.mozilla.org, accessed June 2026. https://developer.mozilla.org/en-US/docs/Web/API/MediaTrackSettings
- 7.
Microsoft, "KSPROPERTY_CAMERACONTROL_AUTO_EXPOSURE_PRIORITY," learn.microsoft.com, February 2023. https://learn.microsoft.com/en-us/windows-hardware/drivers/stream/ksproperty-cameracontrol-auto-exposure-priority
- 8.
Cory Rice, "Three-Point Portraiture Lighting and Beyond," bhphotovideo.com, accessed June 2026. https://www.bhphotovideo.com/explora/photography/tips-and-solutions/three-point-portraiture-lighting-and-beyond
- 9.
Microsoft, "Manage app permissions for a camera in Windows," support.microsoft.com, accessed September 2026. https://support.microsoft.com/en-us/windows/privacy/manage-app-permissions-for-a-camera-in-windows
- 10.
Apple, "Control access to the camera on Mac," support.apple.com, accessed September 2026. https://support.apple.com/guide/mac-help/control-access-to-your-camera-mchlf6d108da/mac