browser-history-refindery 0.1.0

Import macOS browser history into a Refindery backend

browser-history-refindery

Import macOS browser history into a Refindery backend.

refindery-import discovers Safari, Firefox, Chrome, and compatible Chromium profiles; reads safe snapshot copies of their history databases; applies local privacy exclusions; and submits eligible URLs through an incremental, resumable pipeline.

Read the complete documentation for setup, privacy behavior, configuration, command reference, troubleshooting, and maintainer architecture.

Quick start

Requires macOS, Python 3.13+, uv, and a running Refindery backend.

uv tool install browser-history-refindery
mkdir -p ~/.config/refindery-import
cd ~/.config/refindery-import

refindery-import list-profiles
refindery-import import --dry-run

export REFINDERY_AUTH_TOKEN="replace-with-your-token"
refindery-import

The first import command creates a commented config.toml. Local progress and deduplication state are stored in refindery_state.sqlite3.

Safari history requires Full Disk Access for the terminal application under System Settings → Privacy & Security → Full Disk Access. Restart the terminal after granting access.

Related projects

• Refindery fetches, extracts, and indexes submitted pages.
• The Refindery Chrome extension sends individual pages from Chrome and other Chromium browsers.

Development

See the maintainer guide for environment setup, architecture, documentation builds, and the required quality checks.