Camera not working

The camera is the most common hardware failure point in a busy booth. This article covers what to do when the Camera pill is red in the admin header bar, when photos are coming out blank, or when customers see the Camera Error Screen mid-session.

Symptom: Camera-related red status pill, blank captures, "No camera detected" message in Diagnostics.

Quick check first

  1. Open admin → Diagnostics tab.
  2. Look at the Camera status card.
  3. Read the status pill (Active / Inactive / Error) and the message underneath.

The message underneath the pill is your most useful clue.

  • No camera detected. The camera is unplugged, in use by something else, or has failed
  • Camera in use. Another process is holding the camera (rare on a locked-down kiosk)
  • Initialization failed. The camera was detected but couldn't be opened
  • Frame timeout. The camera was opened but isn't returning frames

Step 1: Power-cycle the kiosk

Most camera issues clear after a clean boot.

  1. Power-cycle the kiosk (see Booth frozen or screen blank Step 1).
  2. Wait for the welcome screen.
  3. Sign in to admin.
  4. Check the Camera pill in the header.

If green, you're done. If still red, continue.

Step 2: Run All Tests

In the Diagnostics tab, tap Run All Tests at the top right. Watch the Camera card update. If the camera test reports a specific error, note it.

Step 3: Try a test capture

In the Diagnostics tab Camera section, tap the Test Capture button. The booth attempts to grab a single frame.

  • Test capture succeeds → camera is fine. The earlier red state was transient. Try the customer flow.
  • Test capture fails with the same error → camera is genuinely offline. Continue to Step 4.

Step 4: Adjust camera settings

If the camera is detected but capturing dark / washed out / wrong-colored photos:

  1. In Diagnostics → Camera section, adjust the sliders:
    • Brightness. 0-100, raise for dark venues
    • Zoom. 0-200%, leave at 100% unless you have a specific reason to zoom
    • Contrast. 0-100, adjust to taste
  2. Tap Test Capture after each change to see the result.
  3. Once it looks right, the settings persist across reboots.

If sliders don't fix it, the lighting at the booth is the actual issue. Add fill lighting near the customer position.

Step 5: Check the customer experience side

A camera that "works in Diagnostics but fails in production" is unusual. If you see this:

  1. Run a full test session through the customer flow (in Free Play mode).
  2. If the session works, the earlier failure was transient.
  3. If the session fails again, note exactly which step it fails on (look at camera screen, capture, etc.) and contact support.

Step 6: When to call support

Camera issues that need support:

  • Camera card always shows "No camera detected" after power cycle
  • Test capture fails with the same error every time
  • Camera works for a few sessions then fails repeatedly
  • Captures come out completely black or scrambled
  • The camera physically looks loose, broken, or damaged

Have your Booth ID and a description of the symptom ready.

Common causes and fixes

Booth was powered on with the camera disconnected.

Power-cycle.

Internal USB cable came loose during shipping.

Power-cycle. If still failing, contact support.

Camera firmware glitch after a long uptime.

Power-cycle (this clears most issues).

Camera physically damaged.

Contact support. Needs a hardware swap.

Lighting too dark / too bright for the camera.

Adjust the room lighting or the camera sliders.

Privacy / antivirus / OS settings blocking the camera.

Not applicable on a locked-down kiosk. The OS settings are pre-configured. If somehow this happens, contact support.

What about replacing the camera?

The kiosk's camera is internal and not designed to be swapped by operators. If your camera has failed and you need a replacement, contact BoothIQ support. They'll arrange a replacement procedure.

Warning
Don't open the kiosk enclosure to access the camera yourself unless explicitly instructed by support. Opening the kiosk may void warranties and risk damaging other components.

Camera Error Screen during a customer session

If a customer is mid-session and the camera fails, BoothIQ shows a dedicated Camera Error Screen:

  • It explains there's a camera problem
  • It offers a Retry button
  • It does not automatically force the customer back to the welcome screen. The customer's paid session is preserved

If the customer taps Retry and the camera still fails, they're stuck. You should:

  1. Comp them by adding credits in the Credits tab (see Adding credits manually).
  2. Take the booth out of service if the camera is consistently failing.
  3. Power-cycle to recover.

Verify it worked

The camera is recovered when:

  • The Camera pill is green in the header
  • The Diagnostics Camera card shows Active
  • A test capture produces a clear, well-exposed photo
  • A full customer session completes successfully

Next steps