# How Browser History+ works

> A plain-language look at what the extension records, where it keeps it, and what happens when you clear Chrome history.

## In one sentence

Every time a tab finishes navigating to a new page, Browser History+ saves a small record of that visit into a database inside your browser — separate from Chrome's own history — and gives you a fast way to search it.

## What is recorded

For each visit the extension saves:

- the page address (URL) and its domain, for example `github.com`;
- the page title;
- the date and time of the visit;
- the address of the site's icon, so the list looks familiar;
- whether the visit happened in an Incognito window.

It does **not** record page content, form inputs, passwords, cookies, or anything you type on websites.

Some visits are skipped on purpose: browser-internal pages (`chrome://…`, `about:…`), extension pages, local files, and repeated records of the same page when you only change the `#anchor` or reload it.

## Where it is stored

Records live in IndexedDB, a database built into the browser, inside your Chrome profile folder. Settings (language, Incognito on/off, auto-lock time, password hash and hint) live in the extension's own storage area.

Because the copy belongs to the extension, **"Clear browsing data" in Chrome doesn't remove it**. Only the extension can delete its records — when you delete entries yourself, or when you uninstall it.

Nothing is sent to a server. There is no account and no cloud sync. If you want to move your history to another computer, export a JSON backup and restore it there.

## Getting started

1. **Install** the extension from the Chrome Web Store and pin it to the toolbar so it's one click away.
2. **Onboarding** walks you through the options: interface language, Incognito, and an optional password.
3. **Import** (optional): bring in the history Chrome currently has — usually the last 90 days. Chrome asks for the "history" permission for this; the extension uses it once and gives it back.
4. **Browse as usual.** Visits are saved automatically in the background.

## Finding pages

- **Search** matches page titles and addresses as you type. Typing a date such as `16.11.2026` or `16.11` jumps to that day.
- **Quick ranges**: All time, Today, 7 days, 30 days, or a custom date range.
- **Grouping**: by day (default), month or year. Groups can be collapsed.
- **Incognito filter** shows only visits made in Incognito windows.
- Click a domain to see every visit to that site.

The list is virtualized: only the rows on screen are drawn, so scrolling stays smooth with 100,000+ visits.

## Analytics

The Analytics tab summarizes a period (7, 30, 90 days, a year or all time): total visits, number of domains, unique pages, a daily average, a donut chart of domain share, the most visited domains, activity over time and activity by hour of the day. Everything is calculated locally from your own records.

## Password lock

You can set a password with an optional hint. When it's set, the whole app is covered by a lock screen until you enter it, and it locks again according to the setting you choose: every time the app is opened, or after 5, 15 or 60 minutes.

The password itself is never stored — only a salted PBKDF2-SHA256 hash. That also means **a forgotten password cannot be recovered**, so pick a hint only you understand.

## Incognito

Chrome doesn't let any extension see Incognito tabs unless you switch on **Allow in Incognito** for it at `chrome://extensions`. If you do, Incognito visits are recorded too and marked with an Incognito icon. You can turn Incognito recording off at any time in the extension settings — then Incognito tabs are ignored even if the extension is allowed there.

## Deleting data

- Hover a row and click × to delete one visit (with Undo).
- Search for something and use **Delete results** to remove all matches.
- **Settings → Delete all history** wipes everything (asks for the password if one is set).
- Uninstalling the extension deletes all of its data.

## Permissions, explained

- **tabs** — to read the address and title of the page a tab navigates to. Chrome shows this as "Read your browsing history", because that is exactly what the extension does.
- **storage** and **unlimitedStorage** — to keep settings and a history that grows over the years without being evicted.
- **favicon** — to show site icons from Chrome's own icon cache.
- **history** (optional) — only during the one-time import, then removed.

No host permissions: the extension cannot read or change the content of the websites you visit.
