Skip to content

GitHub 同期 ​

GitHub リポジトリを介して、複数のデバイス間でブックマークを同期できます。各デバイスごとに個別の JSON ファイルが保存され、デバイス間の差分はコンフリクト解決 UI で安全にマージできます。

セットアップ ​

1. GitHub Personal Access Token の発行 ​

  1. GitHub にログイン → Settings → Developer settings → Personal access tokens → Tokens (classic)
  2. Generate new token (classic) をクリック
  3. スコープで repo にチェック(フルコントロール)
  4. 任意のメモ(例: "Bookmark Manager PE")を入力
  5. 生成されたトークンをコピー(ghp_xxxxx)

![トークン発行画面(GitHub)]

2. 同期リポジトリの準備 ​

同期用の GitHub リポジトリを新規作成してください(公開・非公開どちらでも可)。リポジトリの中身は自動的に管理されます。

3. アプリで設定 ​

  1. サイドバー下部の 同期 ボタンをクリック
  2. 表示されたダイアログに以下の項目を入力:
    • Personal Access Token: 先ほど発行したトークン
    • リポジトリ所有者: ユーザー名または Organization 名
    • リポジトリ名: 作成したリポジトリ名
    • デバイス名: このデバイスの識別名(例: "MacBook Air")

同期設定ダイアログ

  1. 接続テスト&保存 をクリック
  2. 接続成功すると、サイドバーにグリーンのクラウドアイコンが表示されます

同期の実行 ​

サイドバーの 同期 ボタンをクリックすると、以下の流れで同期が実行されます。

  1. GitHub から他デバイスのブックマークファイルを取得
  2. ローカルのブックマークとマージ
  3. 自分のデバイスのブックマークを GitHub にプッシュ
  4. 結果を通知(何件取り込んだか、何件送信したか)

コンフリクト解決 ​

同じブックマークが複数のデバイスで別々に更新されていた場合、コンフリクト解決モーダルが表示されます。

コンフリクト解決モーダル

各コンフリクトごとに以下の選択肢があります。

選択肢動作
ローカルを保持このデバイスの内容を残す
リモートを採用GitHub 上の内容で上書き
自動マージタイトル・タグ・メモを統合
スキップ今回は判断せず、後で再度同期

すべてのコンフリクトを解決したら 完了 をクリックします。

データの保存形式 ​

リポジトリ内のファイル構造:

リポジトリ/
├── bookmarks/
│   ├── device-{id1}.json    # デバイス A のブックマーク
│   └── device-{id2}.json    # デバイス B のブックマーク
├── metadata/
│   ├── devices.json         # 登録デバイス一覧
│   └── sync-state.json      # 同期状態

各デバイスのデータは独立したファイルとして保存されるため、あるデバイスで障害が起きても他のデバイスに影響しません。

MIT License