#+title: crumb

* what
local-only browser history tracker. a webextension plugin and a
local http server. logs each page you visit to a plaintext org-mode
file at ~/.crumb/history.org.

* parts
- browser extension (webextension api, javascript)
- local http listener (python + flask)
- plaintext log (~/.crumb/history.org)

on each page load the extension posts page metadata to the local
server, which appends it to the log. captured: title, url, utc
timestamp, hostname, path, and optionally query string, tab id,
window id, favicon url.

* requires
python 3.x, flask, a chromium or firefox browser with extension
developer mode.

* run
1. start the listener:

#+begin_src sh
python3 -m venv venv
source ./venv/bin/activate
pip install -r requirements.txt
python server.py
#+end_src

2. load the extension: enable developer mode, load crumb_extension/.
3. browse. entries land in ~/.crumb/history.org.
4. search:

#+begin_src sh
python search.py <term>
#+end_src

* limits
- extensions can't write files directly; the local server does it.
- the log is plaintext, not encrypted. bolt on your own if needed.
- data stays local. nothing is sent anywhere.

* license
0bsd. see LICENSE.