Metadata-Version: 2.4
Name: browser-history-refindery
Version: 0.1.0
Summary: Import macOS browser history into a Refindery backend
Keywords: browser-history,chrome,firefox,refindery,safari
Author: Harold Martin
Author-email: Harold Martin <harold.martin@gmail.com>
License-Expression: MIT
License-File: LICENSE.txt
Classifier: Development Status :: 3 - Alpha
Classifier: Environment :: Console
Classifier: Intended Audience :: End Users/Desktop
Classifier: Operating System :: MacOS
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.13
Classifier: Programming Language :: Python :: 3.14
Classifier: Topic :: Internet :: WWW/HTTP :: Indexing/Search
Classifier: Topic :: Utilities
Requires-Dist: aiosqlite>=0.22.1
Requires-Dist: httpx2>=2.2.0
Requires-Dist: loguru>=0.7.2
Requires-Dist: pydantic>=2.13.4
Requires-Dist: questionary>=2.1.1
Requires-Dist: rich>=15.0.0
Requires-Dist: typer>=0.26.8
Requires-Python: >=3.13
Project-URL: Homepage, https://github.com/hbmartin/browser-history-refindery
Project-URL: Documentation, https://hbmartin.github.io/browser-history-refindery/
Project-URL: Repository, https://github.com/hbmartin/browser-history-refindery
Project-URL: Changelog, https://github.com/hbmartin/browser-history-refindery/releases
Project-URL: Issues, https://github.com/hbmartin/browser-history-refindery/issues
Description-Content-Type: text/markdown

# browser-history-refindery

Import macOS browser history into a
[Refindery](https://github.com/hbmartin/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](https://hbmartin.github.io/browser-history-refindery/)**
for setup, privacy behavior, configuration, command reference, troubleshooting,
and maintainer architecture.

## Quick start

Requires macOS, Python 3.13+, [`uv`](https://docs.astral.sh/uv/), and a running
Refindery backend.

```bash
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](https://github.com/hbmartin/refindery) fetches, extracts, and
  indexes submitted pages.
- The [Refindery Chrome extension](https://github.com/hbmartin/refindery-chrome-extension)
  sends individual pages from Chrome and other Chromium browsers.

## Development

See the [maintainer guide](https://hbmartin.github.io/browser-history-refindery/maintainers/development/)
for environment setup, architecture, documentation builds, and the required
quality checks.
