Skip to content

Add Safari (macOS) support - #111

Merged
abrignoni merged 1 commit into
mainfrom
feat/safari-macos
Sep 2, 2026
Merged

abrignoni merged 1 commit into
mainfrom
feat/safari-macos

Conversation

@abrignoni

Copy link
Copy Markdown
Owner

Adds Safari support for macOS. Six artifacts from a user's Library/Safari folder:

  • History (History.db): visits joined to URL, domain and lifetime visit count.
  • Bookmarks: leaf bookmarks with folder path, title and URL.
  • Top Sites: entries flagged built-in default versus earned from browsing.
  • Recently Closed Tabs and Last Session: window/tab UUIDs, close and last-visit times, private-window flag.
  • iCloud Tabs (CloudTabs.db): tabs synced from other devices, joined to the originating device name.

Every matching file is parsed, so a Mac with more than one user account reports each account, tagged by Source File. visit_time and LastVisitTime are Mac Absolute Time in seconds. The per-tab SessionState navigation blob is not decoded; only its size is reported.

Validated on the public Josh Hickman macOS Big Sur image: 27 visits, 7 bookmarks, 12 top sites, 2 recently closed tabs, 2 iCloud tabs, 2 last-session tabs.

…ud tabs

Six artifacts from a user's Safari folder: History.db visits joined to their
URL/domain/visit-count, leaf bookmarks with folder path, TopSites with the
built-in-versus-earned flag, RecentlyClosedTabs, iCloud tabs joined to the
originating device, and LastSession open tabs.

Every matching file is parsed, so a Mac with more than one user account reports
each account, tagged by Source File. visit_time and LastVisitTime are Mac
Absolute Time in seconds. The per-tab SessionState blob is not decoded; its
size is reported.

Validated against the public Josh Hickman macOS Big Sur test image: 27 visits,
7 bookmarks, 12 top sites, 2 recently closed tabs, 2 iCloud tabs, 2 last-session
tabs.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
@abrignoni
abrignoni merged commit e7c5777 into main Sep 2, 2026
10 checks passed
@abrignoni
abrignoni deleted the feat/safari-macos branch September 2, 2026 02:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant