クイックスタート¶
このガイドでは、5分以内にブラウザ履歴の完全自動バックアップを設定できます。
ステップ 1 — 初回起動¶
HistorySync を起動します。初回起動時には セットアップウィザード が表示され、基本的な設定をガイドします。
ソースからインストールした場合：
ステップ 2 — ブラウザを同期する¶
ダッシュボード で 今すぐ同期 をクリックします。HistorySync は以下を実行します：
- システム上にインストールされているすべてのブラウザを自動検出します。
- WAL スナップショットを使用してブラウザの SQLite 履歴データベースを安全に読み込みます — ブラウザを開いたままでも問題ありません。
- ローカルの HistorySync データベースにレコードをインポートします。
初回同期は時間がかかる場合があります
複数のブラウザに数年分の履歴がある場合、初回同期には 1〜2 分かかることがあります。以降の同期は増分同期となり、新しいレコードのみがインポートされます。
選択的な同期¶
特定のブラウザのみ同期するには、CLI を使用します：
ステップ 3 — 履歴を検索する¶
GUI 検索¶
履歴 タブ上部の検索バーを使用します。入力するたびに即座に結果が表示されます。
グローバルオーバーレイ（スポットライト）¶
任意のアプリケーション から Ctrl+Shift+H を押すと、クイックアクセスオーバーレイが表示されます。Windows、macOS、Linux（X11）で動作します。Wayland 環境では、代わりに python -m src.main --quick をシステムショートカットに割り当ててください。
自然な言葉で入力するか、高度なクエリ DSL を使用します：
| クエリ例 | 検索内容 |
|---|---|
python async |
タイトルまたは URL にこれらの単語を含むページ |
domain:github.com |
GitHub のページのみ |
after:2024-06-01 domain:arxiv.org |
2024年6月以降に読んだ論文 |
is:bookmarked tag:work |
「work」タグ付きのブックマーク済みページ |
react -tutorial |
React 関連のページ（チュートリアルを除く） |
ステップ 4 — 自動同期を有効にする¶
設定 → 自動同期 に移動して：
- 自動同期 を有効にします。
- 任意の同期間隔を設定します（デフォルト: 2時間）。
- システム起動時に起動 を有効にすると、HistorySync がバックグラウンドでサイレント起動します。
これ以降、ブラウザの履歴は自動的に 1 つの検索可能なデータベースに継続的にマージされます。
ステップ 5 — クラウドバックアップを設定する（オプション）¶
WebDAV バックアップを利用すると、新しいマシンで履歴を復元したり、複数のデバイス間で共有したりできます。
- 設定 → WebDAV クラウドバックアップ に移動します。
- WebDAV サーバーの URL、ユーザー名、パスワードを入力します。
- 自動バックアップ を有効にして間隔を設定します。
- 接続テスト をクリックして確認します。
対応プロバイダーの手順については WebDAV 設定ガイド をご覧ください。
ステップ 6 — トレイモード（バックグラウンド動作）¶
設定が完了したら、メインウィンドウを閉じます。HistorySync は システムトレイ に最小化され、サイレントで同期とバックアップを続けます。
トレイアイコンを右クリックすると：
- HistorySync を開く — メインウィンドウを前面に表示します。
- 今すぐ同期 — 即座に同期を実行します。
- 今すぐバックアップ — 即座に WebDAV バックアップを実行します。
- 終了 — アプリケーションを完全に終了します。
次のステップ¶
| やりたいこと | 参照先 |
|---|---|
| ターミナルから同期を自動化する | CLI リファレンス |
| 特定の WebDAV プロバイダーを設定する | WebDAV 設定 |
| キーボードショートカットをカスタマイズする | キーボードショートカット |
| 履歴を CSV / JSON / HTML にエクスポートする | CLI リファレンス — 履歴をエクスポート |
| セキュリティモデルを理解する | セキュリティアーキテクチャ |