Skip to Content
Getting StartedFirst-time setup wizard

First-time setup wizard

The first-time wizard runs on the mirror display after installation. It configures essentials so the dashboard is usable before you fine-tune modules in settings.

What the wizard covers

  1. Region & language — time zone, 12/24h clock, units (°C/°F, km/mi).
  2. Network check — confirms the Pi can reach the internet (NTP, weather, optional cloud APIs).
  3. Display — brightness hints, screensaver defaults, optional Kids Mode shortcut.
  4. Accounts (optional) — Google Calendar, smart-home bridges — skip anything you will configure later.
  5. Voice (Piper) — microphone test, wake phrase sensitivity, on-device vs server STT (per your build).
  6. Privacy — analytics off by default; camera features clearly gated if a module is present.
  7. Layout preset — choose a starter arrangement (information-dense vs minimal).

💡 Tip: Complete the wizard before mounting the mirror in the frame — it is easier to plug a USB keyboard or use SSH while the Pi is on the bench.

Step-by-step (what to expect)

1. Welcome screen

Press Next. If the UI is upside-down, open display settings from the gear icon (or rotate in config.json / OS) before continuing.

2. Time and location

  1. Pick your time zone from the list or search box.
  2. Confirm NTP sync shows “time correct” (green indicator).

3. Optional cloud connections

  1. Google Calendar — follow the OAuth browser flow on a phone or laptop if the wizard shows a pairing code.
  2. Skip any service you do not use yet; you can add them under Settings → Integrations.

⚠️ Warning: Only sign in to accounts you trust on this device. Use a family calendar instead of a primary work account if the mirror is in a shared space.

4. Voice setup (Hey Piper)

  1. Plug in your USB microphone before this step.
  2. Speak the test phrase when prompted; adjust gain in OS sound settings if bars do not move.
  3. Choose wake word sensitivity — start medium, reduce false triggers later.

5. Finish

  1. Confirm the layout preset; you can drag modules later.
  2. Tap Done. The dashboard loads with your choices.

Troubleshooting

Wizard loops on “checking network”
Verify DNS (ping 1.1.1.1), router captive portal, and correct Wi‑Fi credentials in Pi OS.

OAuth window does not open
Ensure the Pi’s clock is correct and Chromium is not blocking pop-ups; retry from Settings → Integrations.

Microphone not listed
lsusb on SSH, re-seat the USB plug, try a powered hub, and see USB microphone guide.

Last updated on
Full installationTroubleshooting

Was this helpful?