Caravaggio, The Calling of Saint Matthew: a shaft of light crosses a dark room toward men at a table
WITNESS
User guide

WITNESS

tamquam illo spectante “As if he were watching.” Seneca, Letters XI

Witness records your iPhone screen on the phone itself, flags what matters, and keeps the apps you choose closed unless you’re being recorded.

Caravaggio, The Calling of Saint Matthew, 1599–1600. San Luigi dei Francesi, Rome.

How it works

Four parts, working together.

Painted tabletop: an eye at the centre, ringed by scenes of the seven deadly sins
Bosch or follower, The Seven Deadly Sins and the Four Last Things, c. 1500. Prado, Madrid. At the centre of the eye: Cave, cave, Deus videt.
Record

Your whole screen, every app

While Witness is running, it saves a small screenshot every few seconds. Native apps, browsers, sign-in flows, everything on screen. Nothing is sent anywhere.

Review

Rated on your phone, overnight

While your phone charges, Witness’s on-device model rates each screenshot clean, borderline or explicit. Clean screenshots are deleted. Flagged ones stay for review.

Gate

No recording, no app

Apps you choose, such as Instagram or YouTube, are blocked by iOS whenever Witness isn’t recording. To open them, start Witness first.

Report

A clear daily and weekly picture

How much of your phone time was recorded, any moment recording was stopped while you were using the phone, and every flagged minute with a one-line reason.

Why the gate matters. Filters can’t see inside native apps, and Screen Time on its own can only block an app outright. Witness makes the apps you choose usable only while you’re being recorded. The block itself is Apple’s own Screen Time shield.

Who does what

Men at a counting table look up; one points to himself
Caravaggio, The Calling of Saint Matthew (detail), 1599–1600. “Who, me?”
The one rule

Witness works when the codes belong to someone else.

You
  • Keep Witness running, and restart it after you unlock
  • Never turn anything off
  • Review the report with your partner each week
Your partner, your witness
  • Sets the Screen Time passcode and the Witness gate PIN, without you watching
  • Keeps both private
  • Reviews the weekly report with you

If you know either code, the setup is only as strong as your willpower. Plan about 20 minutes with your partner in the room.

Setup

Four layers, in this order.

Engraving of Saint Jerome writing in an ordered, sunlit study, a lion asleep on the floor
Albrecht Dürer, Saint Jerome in His Study, 1514.
  1. Lock down Screen Time

    Keeps Witness from being deleted and other apps from being installed.

    • Open Settings → Screen Time and turn Screen Time on.
    • Turn on Content & Privacy Restrictions.
    • In the App Store purchases section, set Installing Apps and Deleting Apps to Don’t Allow.
    • Under Allow Changes, set Background App Activities to Don’t Allow, so Witness can keep checking in.
    • Choose Lock Screen Time Settings and hand the phone to your partner to set the passcode. When iOS asks for an Apple ID for passcode recovery, your partner enters theirs or cancels. If it’s yours, you could reset the passcode yourself.

    Installing or updating an app now means asking your partner. That’s on purpose.

  2. Install Witness and allow access

    Witness needs Screen Time access to run the gate and to measure phone use while it isn’t recording.

    • When Witness first opens, allow Notifications and Screen Time access.
    • Turn on the Safari extension at Settings → Apps → Safari → Extensions → Witness. Choose Allow on all websites and Allow in Private Browsing.
    • Add the Witness widget to your Home Screen or Lock Screen. It shows at a glance whether Witness is running, and tapping it restarts recording.
  3. Choose what to gate

    In Witness, open the Capture tab, then Gate.

    • Turn on Gate apps while capture is off.
    • Set Block to Chosen apps and pick the apps. Add their websites too (for example, instagram.com and youtube.com), or the web version is a side door. Gate any other browsers on the phone as well.
    • Keep the list focused. iOS limits one gate to roughly 50 apps and sites.
    • Tap Set a PIN, then let your partner choose it. From then on, every gate setting, including lifting the blocks, needs the PIN.
  4. Start recording

    Tap Start. iOS shows its screen-sharing picker.

    • Choose Entire Screen. Any other option records only part of what you see.
    • A Live Activity on your Lock Screen and the widget show that Witness is running.

Everyday use

What to expect once you’re set up.

Illuminated calendar page: a feast below a blue and gold arch of the heavens
Limbourg brothers, Très Riches Heures, January, c. 1412–16. Musée Condé, Chantilly.

Locking your phone ends recording

That’s an iOS rule, not a Witness choice. After you unlock, restart Witness from the Live Activity, the widget or the reminder notification. It takes two taps: Start, then Entire Screen.

Opening a gated app while Witness is off

You’ll see a shield that says “Witness is off.” Tap Restart capture, tap the notification that appears, and choose Entire Screen. The app opens normally from then on.

Using your phone without recording

Apps you haven’t gated still work. Witness measures that time with Screen Time and reminds you every minute for the first half hour. It all shows in the report as Not captured.

Stopping recording while using the phone

Stopping Witness from Control Center or the status bar while the phone is unlocked is recorded as capture stopped while in use, and it’s the first thing the report shows.

Discreet on the Lock Screen. Anyone can see your Lock Screen, so the Live Activity and widget only ever show the name “Witness” and its mark. They never say “recording,” “off” or “flagged.”

Reading the report

Week shows Sunday through Saturday. Today shows the day, minute by minute.

Three heads, old, mature and young, above a wolf, a lion and a dog
Titian and workshop, An Allegory of Prudence, c. 1550–65. National Gallery, London. “From the past, the present acts prudently, lest it spoil the future.”
Part of an hour on the timeline. Each cell is a minute.
CleanRecorded and rated clean.
BorderlineSuggestive or borderline content.
ExplicitNudity or sexually explicit content.
Not capturedPhone in use while Witness wasn’t recording.
Not rated yetRecorded. It’ll be rated overnight while charging.
Sign-in, not keptYou were typing in a password or code field, so no screenshot was kept. At most 60 seconds per page.
Stopped while in useRecording was turned off with the phone unlocked. The stop-sign shape is used only for this.

Coverage

94–97%An example coverage range

Coverage is the share of your phone time that was recorded, shown as a range. The range exists because iOS measures phone use only in whole minutes, so the first minute of each gap can’t be measured. The low end assumes every one of those minutes was used.

Flagged moments

Each borderline or explicit minute is listed with its time and a one-line reason from the model. The report never shows screenshots.

Sites

The Safari extension lists the sites you visited, with page titles. If you’re typing in a sign-in field when a visit is recorded, only the site address and page path are kept.

For partners

A weekly review takes about ten minutes. Open Witness on their phone, on the Week tab.

Engraving of an armoured knight riding steadily past Death and the Devil, a dog at his side
Albrecht Dürer, Knight, Death and the Devil, 1513.
  1. Look for stop signs first

    “Capture stopped while in use” is the strongest signal Witness records. Ask about each one.

  2. Check coverage

    A steady week sits high in the 90s. A drop usually means recording wasn’t restarted after unlocking. Ask what was happening during long Not captured stretches.

  3. Walk through flagged moments

    Tap a day to see each borderline or explicit minute with its reason. The model can be wrong in either direction, so treat a flag as a reason to ask and not as a verdict.

  4. Keep the codes private

    Never share the Screen Time passcode or the gate PIN, and change them if you think they’ve been seen.

Privacy

Your screen never leaves your phone.

A woman reads a book of hours at a window that opens onto a church interior
Master of Mary of Burgundy, Hours of Mary of Burgundy, c. 1477. Austrian National Library, Vienna.

Stays on the phone

Screenshots, ratings and the site list are stored only on the iPhone and are excluded from iCloud and computer backups. Rating uses Apple’s on-device model, never a cloud service.

Kept only as long as needed

Clean screenshots are deleted as soon as they’re rated. Only borderline and explicit ones remain, for review on the phone.

Passwords and codes

In Safari, while you’re typing in a password or one-time-code field, Witness keeps no screenshot, for at most 60 seconds per page. Those minutes show in the report as Sign-in, not kept, never as clean.

Nothing to your partner’s phone

Your partner reviews the report on your phone, with you. Witness doesn’t send reports anywhere.

What Witness can’t see

Witness aims for clarity, not perfection. Here is where its view ends.

Christ prays on a rock while three disciples sleep below and soldiers approach
Andrea Mantegna, The Agony in the Garden, 1455–56. National Gallery, London. The watchers, asleep.
  1. The first minute after unlocking

    When your phone locks and recording stops, the gate drops while the phone is locked. It returns after about a minute of use if Witness hasn’t been restarted, and then stays up until it is. That minute shows in the low end of the coverage range.

  2. Turning off Witness’s Screen Time access

    iOS lets the phone’s owner remove Witness’s Screen Time access in Settings with Face ID. The Screen Time passcode doesn’t cover it. That removes every block. An upcoming update will detect this and flag it in the report.

  3. Content inside other apps while Witness is off

    Screen Time blocks apps, not content, so a YouTube video embedded in another app isn’t gated. While Witness is recording, it’s captured like everything else.

  4. The model isn’t perfect

    Ratings come from a small on-device model. It can miss things and it can over-flag. That’s why a person reviews the report.

Questions

Why do I have to restart Witness every time I unlock?

iOS ends every screen recording when the phone locks and doesn’t let apps restart one on their own. The widget and Live Activity make restarting a two-tap job.

Witness says “Choose Entire Screen to start.”

In the iOS picker, choose Entire Screen. Other options record only part of what’s on screen, so Witness won’t start with them.

I get “Witness isn’t capturing” notifications.

Your phone is in use and Witness isn’t recording. Tap the notification to restart. The reminders stop as soon as recording is back on.

Does Witness use a lot of battery?

Recording saves a small, compressed screenshot every few seconds. Rating, the heavy work, waits until the phone is charging.

Why can’t I change Date & Time?

Witness keeps Set Automatically on, so the times in your report can’t be shifted by changing the clock. Time zones still update automatically when you travel.

We forgot the gate PIN.

There’s no PIN recovery, by design. Your partner can use the Screen Time passcode to allow deleting apps, then delete and reinstall Witness. That resets the gate, and it also erases Witness’s history.

Can my partner see my screenshots?

No. The report shows times, ratings and one-line reasons, never images.