---
id: heads-up
type: screen
title: Heads-up mode
summary: Heads-up mode is a large, glanceable screen for a phone in a mount. It has seven pages you swipe between (Drive, Cluster, Sensors, Cabin, Parking, Sky, Photos), turns sideways with the phone, and takes over the middle of the screen for charges, cameras and problems. The Cabin page reads your eyes and head with the front camera, as numbers only.
section: using
url: "https://irrhuh.app/kerbside/guide/heads-up.html"
related: [drive-tab, permissions, data-on-your-iphone, troubleshooting]
platform: [iphone]
applies_to: 1.0
updated: 2026-11-18
opens_from: [drive-tab]
---

# Heads-up mode

Heads-up mode turns the iPhone into a large in-car display for a phone in a dashboard mount. It runs alongside your navigation app's voice guidance; it doesn't navigate.

![Heads-up mode in landscape, Midnight theme, with a charge and the OBU's travel times (iPhone Simulator, demo data)](https://irrhuh.app/kerbside/img/hud-landscape.jpg)

## Open and close it

- **Open:** Drive tab › **Heads-up** (Calm mode; [Advanced mode](https://irrhuh.app/kerbside/guide/modes.html) has no Drive tab).
- **Close:** tap anywhere to show the control bar for 4 seconds, then tap **✕** at the top left.

While it's open, the screen stays on, the status bar is hidden, and the phone's location, compass, barometer and motion sensors are in use. Kerbside keeps trying to connect to your OBU, and if the OBU hasn't connected, GPS can start a [recorded drive](https://irrhuh.app/kerbside/guide/recorded-drives.html). It opens on the page you used last, and turns with the phone: in landscape the main picture is on the left and a column of cards on the right.

## The control bar

Tap the screen to show it.

| Control | What it does |
|---|---|
| **✕** | Closes heads-up mode |
| Page title and dots | Which of the seven pages you're on |
| **Relearn level** | Sensors page only: forgets how the phone sits in this mount and learns it again |
| Mirror (two triangles) | Flips the picture left to right, for reading a reflection in the windscreen. Turns the Cabin camera off |
| Theme: **Auto · Midnight · Daylight** | Midnight is dark, Daylight is light. Auto picks Midnight after sunset, and Daylight when the sun is up and the screen is bright |
| Brightness slider | Dims the picture by up to 80% on top of the iPhone's own brightness |

## On every page

- **Top bar:** on the left, the OBU's status ("Looking for the OBU" while Kerbside keeps trying) or your speed with the speed-limit sign; on the right, **TRIP** (this trip's total) and **CARD** (your card balance, amber when low). A red **EYES** dot shows while eye numbers are being recorded (see [Cabin](#cabin)).
- **Bottom line:** the latest OBU announcement that the page isn't already showing, with its time. Bare speed-limit messages are skipped, because the sign shows them.

**Speed comes from the OBU** while it's sending one. Otherwise the heads-up shows your iPhone's GPS speed, marked **KM/H · GPS**. With neither (or a GPS fix more than 3 seconds old) you'll see "–".

## Alerts that take over

When something important happens, it replaces the middle of the page (the whole width in landscape), with an amber bar counting down. Most important first:

| Alert | Shown for | When |
|---|---|---|
| **CHECK THIS** | Up to 10 min | A charge wasn't deducted, a card problem, or a parking notice |
| **CHARGE AHEAD** | Up to 2 min | The OBU announces the next charge. Shows the amount and place; "Charged as you pass the gantry". Ends when the deduction arrives |
| **CAMERA ZONE**, **RED-LIGHT CAMERA**, **BUS LANE** | 20 s | An LTA message about a camera or bus lane, with the speed limit if given and "You're at N km/h" |
| **TRAFFIC AHEAD** | Up to 2 min | A high-priority traffic message |

Alerts don't take over the Parking page. Kerbside's road-ahead alerts (signs, faulty lights, flood alerts, your carpark's lots) arrive as notifications and on the Drive tab, not on the heads-up.

## The seven pages

Swipe left or right to move between them.

### Drive

Your speed in large type, the speed-limit sign, and school, silver or camera zone chips from LTA's messages. Beside or below it:

- the last deduction (15 minutes);
- a parking session;
- the border band, e.g. "Woodlands → JB ~30 min", when you're within 1.5 km of a checkpoint. It comes from the [Kerbside server](https://irrhuh.app/kerbside/guide/kerbside-server.html), is fetched while the OBU is sending its speed, and is the band for the checkpoint and direction you're at: towards JB on the Singapore side, towards Singapore on the Malaysian side, whatever Settings › Route says. It's hidden once it's more than 30 minutes old;
- the OBU's travel times (up to 4 rows, 10 minutes);
- **Busy streets**: the busiest few streets right now, by the share under 20 km/h in LTA's latest hourly reading, with a red and amber bar. Up to 3 streets, fewer when the OBU's cards need the room. It needs the Kerbside server, hides itself when LTA's reading is over 2.5 hours old, and can be turned off in Settings › Busy streets.

![Heads-up Drive page in portrait, Daylight theme (iPhone Simulator, demo data)](https://irrhuh.app/kerbside/img/hud-portrait.jpg)

### Cluster

A speedometer from 0 to 140 km/h with a red notch at the limit, and two tiles:
- **G-FORCE:** how hard the car is braking, accelerating or turning, in g, with words like "Braking" or "Turning left". The dot turns amber above 0.3 g.
- **ROAD & DRIVE:** a one-minute graph of road roughness, with humps in blue and sharp hits in amber; a word ("Smooth", "A bit rough", "Rough"); your driving style (**COMFORT**, **SPORT** or **TRACK**); and the last bump.

### Sensors

A compass with your heading, two car drawings showing how the car is tilted (left/right and front/back, amber at 8° or more) and your altitude. These need Kerbside to learn how the phone sits in the mount: "Self-levelling N%" fills as you drive straight and steadily, typically in about 3 minutes. Kerbside remembers up to 4 mounts and recognises one when you put the phone back.

### Cabin

The Cabin page uses the iPhone's front (TrueDepth) camera and Apple's face tracking to show how open your eyes are, where you're looking and how your head is turned. It draws an outline from the face tracking, never a picture, and keeps numbers only, on your iPhone.

| Part | What it shows |
|---|---|
| **Front camera · outline** | Dots and an outline of your face as the camera sees it, drawn as in a mirror. Your eyes (amber when nearly closed), a solid line for where your head points and a dashed line for where your eyes look. Below: "Face seen N% · light N" |
| **Eyes · how open** | A bar and percentage for each eye (amber under 25%). "Looking N° down · N° right", with "eyes lowered N%" when your eyes are turned down. "Last closed 0.2 s at HH:mm · longest 0.3 s · N blinks in the last minute"; blinks show only when your face was seen for most of that minute |
| **Head · from the phone** | How far your face is from the phone in cm, "Turned N° left · chin N° down · tilted N° right", and "Mouth open (yawn?)" |
| Record button (top right) | **Tap to record drives**, **Records on drives** or **REC since HH:mm**. See below |

**Recording eye numbers.** Off at first. Tap the record button to turn **Records on drives** on. Kerbside then records the eye and head numbers during every [recorded drive](https://irrhuh.app/kerbside/guide/recorded-drives.html) while heads-up mode is open, on any page, starting and stopping with the drive. A red **EYES** dot in the top bar shows while it records. It never records pictures or video, and nothing is sent anywhere. What's kept is listed in [Data on your iPhone](https://irrhuh.app/kerbside/kb/data-on-your-iphone.html).

**When the camera runs:** while the Cabin page is on screen, and during a recorded drive with **Records on drives** on. It stops when heads-up mode closes, in mirror mode ("Off in mirror mode"), and while the iPhone is hot ("Paused: the iPhone is hot"). iOS stops the camera whenever Kerbside isn't on screen.

**It needs** Camera access (iOS asks the first time the camera starts) and an iPhone that supports face tracking ("This iPhone can't track faces" otherwise). In a dark car it may say "Can't see your face · it's dark".

**It doesn't** warn you when your eyes close, judge whether you're tired, or identify you. It isn't a safety device. A glance down at a map lowers your eyelids as the camera sees them, so a short "closed" reading may be a glance; the "Looking … down" line helps tell them apart.

### Parking

- **When you're parked** in a roadside OBU car park: the car park's name, the fee so far from the OBU, how long you've been parked and the 2-hour forecast.
- **When you're not parked:** the car parks the OBU has announced, with free lots, and up to 3 HDB carparks within 500 m with live lots (amber at 5 or fewer). They're car lots, or motorcycle lots if you chose **Motorcycle** in Explore › **Plan parking**.

The HDB list follows you: it's worked out from your GPS position every second, using island-wide lots that Kerbside downloads from data.gov.sg when the page opens near an HDB carpark (at most every 2 minutes, every 10 minutes while you stay put). It doesn't need the Kerbside server. The heading shows the time of those lots. Until the first download comes back the list says "Checking HDB lots…"; "None within 500 m" means there really are none.

The heads-up switches to this page by itself when a parking session starts, or when a car park message arrives below 25 km/h. It goes back to your previous page once you've driven above 30 km/h for 10 seconds.

### Sky

An illustrated Singapore street with the real sky: the sun and moon where they are compared with your heading, the weather and the time of day. Cards show glare when the sun is low ahead, rain ahead of you or where you are, the 2-hour forecast, and sunrise or sunset with the moon's phase. The weather comes from data.gov.sg, not the Kerbside server. Without location it uses central Singapore.

![Heads-up Sky page at dusk, in landscape (iPhone Simulator, demo data)](https://irrhuh.app/kerbside/img/hud-sky-landscape.jpg)

### Photos

A slideshow of up to 30 of your own photos, a new one every 12 seconds, with the top bar and alerts on top. Tap **Choose photos** to pick them; **Change** replaces the whole set. Kerbside copies the photos you pick into the app; it can't see the rest of your library.

## What heads-up mode keeps

During a recorded drive with heads-up mode open, Kerbside saves the motion sensor readings on your iPhone; they start and stop with the drive (about 13 MB an hour, up to 500 MB in total). Bumps it feels are added to the recorded drive. With **Records on drives** on, the Cabin page's eye and head numbers are saved the same way (about 9 MB an hour, up to 300 MB). See [Data on your iPhone](https://irrhuh.app/kerbside/kb/data-on-your-iphone.html).
