Skip to content

App usageUser activity

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/
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

What 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

PathContent
/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:

StreamContent
App.InFocusApp foreground and background transitions
_DKEvent.App.InFocusknowledgeC-style app focus events
Device.Display.Backlight (Backlight in public on some builds)Screen on and off
_DKEvent.Device.IsPluggedIn, _DKEvent.Device.BatteryPercentageCharging and battery
_DKEvent.Keybag.IsLockedLock state
_DKEvent.Wifi.Connection, Device.Wireless.BluetoothWi-Fi and Bluetooth connections
Media.NowPlayingMedia playback
Safari.Navigations, App.WebUsageWeb navigation and usage
Notification.UsageNotifications received and interacted with
App.Install / _DKEvent.App.InstallApp installations
Location.Visit, Device.TimeZone, Device.BootSessionVisits, time zone changes, boot sessions
Text.InputSession, UniversalRecents.UserActivity.MetadataText 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:

PartMeaning
Record stateWritten 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
PayloadProtobuf, 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 Biome tree and /private/var/db/biome with original paths, including remote and tombstone folders.
  • Collect knowledgeC.db too: 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.InFocus with 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.Connection gives 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.

See also