Thanks to visit codestin.com
Credit goes to github.com

Skip to content

mugishiro/browselog

Repository files navigation

BrowserLog

ローカルのみで動くプライバシー重視のブラウザ履歴ロガー(Chrome 拡張)。訪問回数・滞在時間を記録し、検索・集計・CSV エクスポートができます。

特徴

  • ローカル保存のみ: IndexedDB に保存し、外部送信なし。必要権限は tabs のみ
  • 計測: ページ/ドメイン/時間帯ごとの訪問回数と滞在時間を計測(30秒ハートビート)
  • リアルタイム表示: ポップアップで現在タブのステータスと滞在時間をライブ更新
  • 分析 UI: オプションページで履歴一覧(検索・期間絞り込み・並び替え・削除)と日別/ドメイン別/時間帯別チャート
  • エクスポート: 履歴を CSV でダウンロード、全削除も可能

計測ルール(概要)

  • URL は正規化(https 統一、www./m.除去、パス小文字化・末尾スラッシュ除去、ハッシュ無視、クエリは区別)してキーにします。詳細は docs/url-key-policy.md
  • 滞在時間は「可視かつフォーカスされたタブ/ウィンドウ」のみ加算します。別ウィンドウを前面にするとカウント停止し、復帰で再開。
  • 30秒ごとに nav:update で経過秒を積算、タブ非表示・フォーカス喪失で nav:pause、再表示で nav:resume、離脱で nav:end
  • 同一タブで再表示/リロード/復帰すると訪問回数を加算して継続計測します。挙動の詳細は docs/visit-counting.md

使い方

  1. npm run builddist/ を生成
  2. Chrome の chrome://extensions を開き「デベロッパーモード」をオン
  3. 「パッケージ化されていない拡張機能を読み込む」で本フォルダを選択
  4. ツールバーのアイコンからポップアップで現在タブの滞在時間と Today/All time を確認
  5. 「Open Options」からオプションページを開き、履歴検索・期間絞り込み・並び替え・CSV エクスポート・削除やチャート表示を利用

開発

  • 依存インストール: npm ci
  • Lint/format: npm run lint, npm run format:check
  • ビルド: npm run build(Chart.js 依存により 349.js が ~500KB でサイズ警告が出ますが動作に影響なし)
  • テスト: npm test(現在は手動確認用メッセージのみ)

ライセンス

MIT License

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published