Biome Streams on iOS: App.InFocus and Beyond
iOS Biome streams in depth: SEGB files, App.InFocus, backlight, plug-in, Wi-Fi, Bluetooth, Safari and notification streams, local versus remote records.
- Location
- /private/var/mobile/Library/Biome/streams/{public,restricted}/<Stream>/{local,remote}/ and /private/var/db/biome/streams/
- Evidence area
- Proves
- Per-event device and user activity: app foreground changes, screen backlight, charging, battery, Wi-Fi and Bluetooth connections, now playing media, Safari navigations, notifications and more, per stream
- Timestamps
- Cocoa time (seconds, as double) in SEGB record headers; payload times vary by stream. UTC
- Acquisition
- Full file system extraction from an AFU device; not in iTunes / Finder backups
- Retention
- Per stream, from days to several weeks; files rotate and are deleted by age and size. Measure per stream
- Collection
- Full file system extraction
Tools
Compare all toolsWhat it is
Biome is Apple's event-stream framework. Each stream (app focus, backlight, Wi-Fi connection, now playing, Safari navigation...) is a folder of append-only files in the SEGB format, one record per event, each record carrying a header with timestamps and a protobuf payload. Streams existed alongside knowledgeC.db from iOS 14 and 15, and from around iOS 16 they carry most of the pattern-of-life data analysts used to read from knowledgeC.
This page goes deeper than the knowledgeC and Biome overview: which streams matter, how the folders are laid out, and what traps to avoid. The ios range starts at 16 because that is where Biome becomes the primary source; earlier releases already have some streams.
Where it lives
| Path | Content |
|---|---|
/private/var/mobile/Library/Biome/streams/restricted/<Stream>/local/ | Most user-activity streams recorded on this device |
/private/var/mobile/Library/Biome/streams/public/<Stream>/local/ | Streams readable by more clients (e.g. older Backlight, NowPlaying) |
.../<Stream>/remote/<device id>/ | Records synced from the owner's other devices |
.../<Stream>/local/tombstone/ | Tombstoned (deleted) records |
/private/var/db/biome/streams/ | System-level streams |
/private/var/mobile/Library/Biome/sync/ | Sync state, including peer devices |
Stream folder names documented by iLEAPP include:
| Stream | Content |
|---|---|
App.InFocus | App foreground and background transitions |
_DKEvent.App.InFocus | knowledgeC-style app focus events |
Device.Display.Backlight (Backlight in public on some builds) | Screen on and off |
_DKEvent.Device.IsPluggedIn, _DKEvent.Device.BatteryPercentage | Charging and battery |
_DKEvent.Keybag.IsLocked | Lock state |
_DKEvent.Wifi.Connection, Device.Wireless.Bluetooth | Wi-Fi and Bluetooth connections |
Media.NowPlaying | Media playback |
Safari.Navigations, App.WebUsage | Web navigation and usage |
Notification.Usage | Notifications received and interacted with |
App.Install / _DKEvent.App.Install | App installations |
Location.Visit, Device.TimeZone, Device.BootSession | Visits, time zone changes, boot sessions |
Text.InputSession, UniversalRecents.UserActivity.Metadata | Text input sessions, user activities |
Names move between public and restricted and change across releases: list the directories on your extraction first.
What it proves
- Event-level sequences: app A came to the foreground at 21:14:03, the screen went dark at 21:20:41, the phone was plugged in at 23:02:10.
- Connections to Wi-Fi networks and Bluetooth devices (car, headphones) with times.
- Safari navigations and web usage per domain, sometimes after History.db was cleared.
- Notification delivery and user interaction per app.
Records in remote/ folders are events of another device on the same account. They are not activity of the examined iPhone.
Key fields
A SEGB record has a header (state, timestamps, length and, depending on the version, a checksum) and a payload:
| Part | Meaning |
|---|---|
| Record state | Written or deleted; deleted records can still contain data |
| Timestamp(s) | Cocoa time; SEGB v1 records carry two timestamps, v2 records one in the parsers published so far |
| Payload | Protobuf, stream-specific; for App.InFocus, bundle ID, a starting/ending flag and times |
There is no public schema for payloads. Parsers map fields per stream and per version, and field meanings are inferred from testing.
Timestamps
Header timestamps are Cocoa time in seconds (floating point), UTC. Payload times can differ from header times, for example when an event is written after it happened. Validate every stream you rely on with a test event on a device of the same release: open an app, lock the phone, plug in a charger, and check how each appears.
python ccl_segb_cli.py '/case/fs/private/var/mobile/Library/Biome/streams/restricted/App.InFocus/local/<file>'
Retention
Each stream is pruned on its own schedule, by age and size. Some keep days, others several weeks. Tombstone folders and deleted-state records can extend what is visible. Report the oldest and newest record per stream you used.
Collection
- Acquire a full file system from an AFU device and copy the entire
Biometree and/private/var/db/biomewith original paths, includingremoteandtombstonefolders. - Collect
knowledgeC.dbtoo: some streams still land there, and older events may survive only there.
Parsing
- iLEAPP has dozens of Biome modules (app focus, backlight, battery, Bluetooth, Wi-Fi, now playing, Safari, notifications, app install, text input, user activity...). Its App.InFocus module reports whether each record came from a local or a remote folder.
- ccl-segb reads SEGB v1 and v2 files, so you can inspect streams that no tool decodes yet.
- Commercial suites decode the most common streams.
Investigator tips
- Separate local and remote records before building any timeline. A MacBook's app use synced into the iPhone's Biome is a classic misattribution.
- Pair
App.InFocuswith backlight and lock streams: an app "in focus" while the screen was off is weak evidence of use. - Cross-check hourly totals with Screen Time and energy use with PowerLog.
_DKEvent.Wifi.Connectiongives connection history that known networks cannot, since that plist keeps only the last join.- The pattern of life guide shows how to combine these streams into a defensible narrative.