krz/crumb

┌──────────────────────────────────────────────────────────────┐
│  C R U M B                                 [ KRZ ]   krz.sh  │
└──────────────────────────────────────────────────────────────┘

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:

         python3 -m venv venv
         source ./venv/bin/activate
         pip install -r requirements.txt
         python server.py

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

         python search.py <term>

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.

┌──────────────────────────────────────────────────────────────┐
│  krz.sh                                                      │
└──────────────────────────────────────────────────────────────┘