CSV format

History Sync writes one file per computer per day, appended to on each run, in the same layout in the shared folder and on the history service:

<computer>/
  <YYYY-MM>/
    <YYYY-MM-DD>.csv          Safari
    <YYYY-MM-DD>.chrome.csv   Chrome
  events.csv                  history deletions History Sync noticed
  heartbeat.json              the last check (see History Sync)
  report.txt                  the Safari report, when asked for

Visits

Column
visit_time	ISO 8601 local time, with the UTC offset in force on that date: 2026-09-01T16:17:00-04:00
url	The page’s address
title	The page’s title
domain	The host
visit_count	The browser’s visit count for the URL
origin	local (visited on this Mac), icloud (Safari history synced from another device on the same Apple ID) or synced (the same for Chrome)
load_successful	Whether the page loaded
redirect_source_url, redirect_destination_url	The redirect chain, where there is one
visit_id, item_id	The browser’s ids
device	The computer, for local visits
user	The macOS account
browser	.chrome.csv only: Chrome, or Chrome (<profile name>) for other profiles

Files use CRLF line endings and Python’s csv quoting.

Events

events.csv: time, device, browser, kind, detail, where kind is one of:

Kind	Meaning
history_deleted	Recent visits already seen are gone (detail has the count)
history_cleared	All history was cleared
history_file_replaced	The History file was deleted and recreated
history_missing	A profile’s History file has gone

Family Filter for Mac shows these as History changes.

Source: README.md