スマホのObsidianをGitで同期(2024.11)
概要
K.I（ishikawa096） による、iPhoneのObsidianをGitで同期するための実践記録。Obsidianコミュニティプラグイン「Git」を使って無料でデバイス間データ同期を行う手順をまとめている。
重要な主張: 2024年11月時点では、以前よく紹介されていた「Working Copy」を使う方法は不要になった。Obsidian GitプラグインをiPhone上で直接セットアップし、GitHub Personal Access Token（Fine-grained）で認証することで同期できる。
前提条件（事前完了済みのこと）
- PC側のObsidianインストール
- PC側のObsidianコミュニティプラグイン「Git」のインストール
- Obsidian同期用のGitリポジトリの作成
手順
Step 1 — GitHub Fine-grained Personal Access Tokenの発行
モバイル端末からリポジトリにアクセスするための認証トークンを発行する。
- GitHubにログインし、
Settings → Developer Settings → Personal access tokens → Fine-grained tokensを開く - 「Generate new token」をクリック
- token nameを適当に入力（例:
obsidian-git-for-iPhone） - Repository accessで「Only select repositories」にチェックし、Obsidian同期用リポジトリを選択
- Permissionsの「Repository permissions → Contents」を「Access: Read and write」に変更
- 「Generate token」をクリックし、tokenをローカルに保管（再表示不可）
Step 2 — スマホ側にObsidian＋Gitプラグインをインストール
- App StoreからObsidianをインストール
- 「Create new vault」で新規Vault作成（「Store in iCloud」はOFF）
Settings → Community plugins → Turn on community plugins- 「Browse」から「Git」プラグインを検索・インストール・有効化
- プラグインOptionsの
Authentication/commit authorセクションにGitHub usernameとPersonal Access Tokenを入力
Step 3 — スマホへGit Clone
- コマンドパレットから
Git: Clone an existing remote repoを実行 - リポジトリのHTTPS git URLを入力（GitHubの「Code → HTTPS」から取得）
- clone先のディレクトリはVault rootを指定
.obsidianディレクトリをpush済みであれば「YES」を選択- 「DELETE ALL YOUR LOCAL CONFIG AND PLUGINS」をタップして上書き
- Cloneのdepthはデフォルト（empty）のままdone
左サイドメニューにリポジトリのファイルが表示されれば成功。
Step 4 — git author情報の設定とPush確認
git author情報が未設定だとgit pushがエラーになる。
- Obsidianを一度閉じて再度開く
Settings → Community plugins → Gitを開くAuthentication/commit authorセクションの「Author name for commit」と「Author email for commit」を入力- Source controlメニュー（右から左にスワイプ）で、➕（stage all） → ✔️（commit） → ↑（push）の順に操作
GitHubリポジトリにpushが反映されれば同期完了。
著者の観察
- Working Copyを使う記事が検索で多くヒットするが、2024年11月時点では不要
- Obsidian GitプラグインをiPhoneに直接インストールするだけで動作する
- Author emailがGitHubアカウントと異なると、commitがGitHubアカウントに紐付かなくなる点に注意